/*******************************************************************************
* Copyright (c) 2001, 2007 Oracle Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Oracle Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.jst.pagedesigner.itemcreation;
import org.eclipse.jst.pagedesigner.dom.IDOMPosition;
import org.eclipse.wst.xml.core.internal.provisional.document.IDOMModel;
import org.w3c.dom.Element;
/**
* An advisor object that allows customization of tag creation in an ITagCreator
*
* Clients should *not* implement this interface. Extend AbstractTagCreationAdvisor
* or DefaultTagCreationAdvisor instead.
*
* <p><b>Provisional API - subject to change</b></p>
*
* @author cbateman
*
*/
public interface ITagCreationAdvisor
{
/**
* @param model
* @param domPosition
* @return a new IDOMPosition adjust for required containers or domPosition
* if no adjust is required. ???May return null???
*/
IDOMPosition checkAndApplyNecessaryContainers(IDOMModel model,
IDOMPosition domPosition);
/**
* Apply customization to tagElement. May use to modify
* attributes and child elements of the tag.
*
* @param model
* @param tagElement
* @param tagToolItem
*/
void applyCustomization(IDOMModel model, Element tagElement);
}