01: /*
02: * Copyright 2002-2008 Andy Clark
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License");
05: * you may not use this file except in compliance with the License.
06: * You may obtain a copy of the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
10: * Unless required by applicable law or agreed to in writing, software
11: * distributed under the License is distributed on an "AS IS" BASIS,
12: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13: * See the License for the specific language governing permissions and
14: * limitations under the License.
15: */
16: package org.cyberneko.html;
17:
18: import org.apache.xerces.xni.Augmentations;
19: import org.apache.xerces.xni.QName;
20: import org.apache.xerces.xni.XMLAttributes;
21:
22: /**
23: * <font color="red">EXPERIMENTAL: may change in next release</font><br/>
24: * {@link XMLDocumentHandler} implementing this interface will get notified of elements discarded
25: * by the tag balancer when they:
26: * <ul>
27: * <li>are configured using {@link HTMLConfiguration}</li>
28: * <li>activate the tag balancing feature</li>
29: * </ul>
30: * @author Marc Guillemot
31: * @version $Id: HTMLTagBalancingListener.java 145 2008-03-17 18:18:33Z mguillem $
32: */
33: public interface HTMLTagBalancingListener {
34: /**
35: * Notifies that the start element has been ignored.
36: */
37: void ignoredStartElement(QName elem, XMLAttributes attrs,
38: Augmentations augs);
39:
40: /**
41: * Notifies that the end element has been ignored.
42: */
43: void ignoredEndElement(QName element, Augmentations augs);
44:
45: }
|