htmlelementname.java

HTML解析器是一个Java库

// Jericho HTML Parser - Java based library for analysing and manipulating HTML
// Version 3.0
// Copyright (C) 2007 Martin Jericho
// http://jerichohtml.sourceforge.net/
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of either one of the following licences:
//
// 1. The Eclipse Public License (EPL) version 1.0,
// included in this distribution in the file licence-epl-1.0.html
// or available at http://www.eclipse.org/legal/epl-v10.html
//
// 2. The GNU Lesser General Public License (LGPL) version 2.1 or later,
// included in this distribution in the file licence-lgpl-2.1.txt
// or available at http://www.gnu.org/licenses/lgpl.txt
//
// This library is distributed on an "AS IS" basis,
// WITHOUT WARRANTY OF ANY KIND, either express or implied.
// See the individual licence texts for more details.

package net.htmlparser.jericho;

import java.util.*;

/**
 * Contains static fields representing the {@linkplain Element#getName() names} of
 * <a target="_blank" href="http://www.w3.org/TR/html401/index/elements.html">all elements defined in the HTML 4.01 specification</a>.
 * <p>
 * All of the name strings are in lower case.
 * <p>
 * The {@link HTMLElements} class is closely related to this interface, containing static methods which group these names 
 * by the characteristics of their associated <a href="HTMLElements.html#HTMLElement">elements</a>.
 * <p>
 * This interface does not specify any methods, but can be inherited by other classes, or statically imported (Java 5.0),
 * to provide less verbose access to the contained element name static fields.
 * <p>
 * The field values in this interface can be used as <code>name</code> arguments in <a href="Tag.html#NamedSearch">named tag searches</a>.
 * <p>
 * Note that since the <code>Tag</code> class implements <code>HTMLElementName</code>, all the constants defined in this interface
 * can be referred to via the <code>Tag</code> class.
 * <br />For example, <code>Tag.BODY</code> is equivalent to <code>HTMLElementName.BODY</code>.
 *
 * @see HTMLElements
 * @see Element
 */
public interface HTMLElementName {
	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/links.html#edef-A">HTML element A</a> - anchor.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String A="a";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/text.html#edef-ABBR">HTML element ABBR</a> - abbreviated form (e.g., WWW, HTTP, etc.).
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String ABBR="abbr";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/text.html#edef-ACRONYM">HTML element ACRONYM</a> - acronym.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String ACRONYM="acronym";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/global.html#edef-ADDRESS">HTML element ADDRESS</a> - information on author.
	 * <p>
	 * This is a {@linkplain HTMLElements#getBlockLevelElementNames() block-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String ADDRESS="address";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/objects.html#edef-APPLET">HTML element APPLET</a> - Java applet.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 * <p>
	 * This element is <a target="blank" href="http://www.w3.org/TR/html401/conform.html#deprecated">deprecated</a> in HTML 4.01.
	 * (see {@link HTMLElements#getDeprecatedElementNames()})
	 */
	public static final String APPLET="applet";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/objects.html#edef-AREA">HTML element AREA</a> - client-side image map area.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagForbiddenElementNames() forbidden}.
	 */
	public static final String AREA="area";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/present/graphics.html#edef-B">HTML element B</a> - bold text style.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String B="b";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/links.html#edef-BASE">HTML element BASE</a> - document base URI.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagForbiddenElementNames() forbidden}.
	 */
	public static final String BASE="base";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/present/graphics.html#edef-BASEFONT">HTML element BASEFONT</a> - base font size.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagForbiddenElementNames() forbidden}.
 	 * <p>
	 * This element is <a target="blank" href="http://www.w3.org/TR/html401/conform.html#deprecated">deprecated</a> in HTML 4.01.
	 * (see {@link HTMLElements#getDeprecatedElementNames()})
	 */
	public static final String BASEFONT="basefont";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/dirlang.html#edef-BDO">HTML element BDO</a> - I18N BiDi over-ride.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String BDO="bdo";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/present/graphics.html#edef-BIG">HTML element BIG</a> - large text style.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String BIG="big";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/text.html#edef-BLOCKQUOTE">HTML element BLOCKQUOTE</a> - long quotation.
	 * <p>
	 * This is a {@linkplain HTMLElements#getBlockLevelElementNames() block-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String BLOCKQUOTE="blockquote";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/global.html#edef-BODY">HTML element BODY</a> - document body.
	 * <p>
	 * The start tag of this element is {@linkplain HTMLElements#getStartTagOptionalElementNames() optional}.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagOptionalElementNames() optional}:
	 * <table class="CompactDL" cellspacing="0">
	 *  <tr>
	 *   <td title="Start tags that terminate this element"><a href="HTMLElements.html#getTerminatingStartTagNames(java.lang.String)">Terminating start tags</a>:
	 *   <td>(none)
	 *  <tr>
	 *   <td title="End tags that terminate this element"><a href="HTMLElements.html#getTerminatingEndTagNames(java.lang.String)">Terminating end tags</a>:
	 *   <td>{@link #BODY}, {@link #HTML}
	 *  <tr>
	 *   <td title="Elements that can be nested inside this element without terminating it"><a href="HTMLElements#getNonterminatingElementNames(java.lang.String)">Nonterminating elements</a>:
	 *   <td>{@link #HTML}
	 * </table>
	 * <p>
	 * Note that the {@link #HTML} element is included as a
	 * {@linkplain HTMLElements#getNonterminatingElementNames(String) nonterminating element} in case the source contains
	 * (illegaly) nested HTML elements.
	 */
	public static final String BODY="body";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/text.html#edef-BR">HTML element BR</a> - forced line break.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagForbiddenElementNames() forbidden}.
	 */
	public static final String BR="br";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/interact/forms.html#edef-BUTTON">HTML element BUTTON</a> - push button.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String BUTTON="button";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/tables.html#edef-CAPTION">HTML element CAPTION</a> - table caption.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String CAPTION="caption";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/present/graphics.html#edef-CENTER">HTML element CENTER</a> - shorthand for DIV align=center.
	 * <p>
	 * This is a {@linkplain HTMLElements#getBlockLevelElementNames() block-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
 	 * <p>
	 * This element is <a target="blank" href="http://www.w3.org/TR/html401/conform.html#deprecated">deprecated</a> in HTML 4.01.
	 * (see {@link HTMLElements#getDeprecatedElementNames()})
	 */
	public static final String CENTER="center";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/text.html#edef-CITE">HTML element CITE</a> - citation.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String CITE="cite";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/text.html#edef-CODE">HTML element CODE</a> - computer code fragment.
	 * <p>
	 * This is an {@linkplain HTMLElements#getInlineLevelElementNames() inline-level} element.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagRequiredElementNames() required}.
	 */
	public static final String CODE="code";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/tables.html#edef-COL">HTML element COL</a> - table column.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagForbiddenElementNames() forbidden}.
	 */
	public static final String COL="col";

	/**
	 * <a target="_blank" href="http://www.w3.org/TR/html401/struct/tables.html#edef-COLGROUP">HTML element COLGROUP</a> - table column group.
	 * <p>
	 * The end tag of this element is {@linkplain HTMLElements#getEndTagOptionalElementNames() optional}:
	 * <table class="CompactDL" cellspacing="0">
	 *  <tr>
	 *   <td title="Start tags that terminate this element"><a href="HTMLElements.html#getTerminatingStartTagNames(java.lang.String)">Terminating start tags</a>:
	 *   <td>{@link #COLGROUP}, {@link #TBODY}, {@link #TFOOT}, {@link #THEAD}, {@link #TR}
	 *  <tr>
	 *   <td title="End tags that terminate this element"><a href="HTMLElements.html#getTerminatingEndTagNames(java.lang.String)">Terminating end tags</a>:
	 *   <td>{@link #COLGROUP}, {@link #TABLE}
	 *  <tr>
	 *   <td title="Elements that can be nested inside this element without terminating it"><a href="HTMLElements#getNonterminatingElementNames(java.lang.String)">Nonterminating elements</a>:
	 *   <td>{@link #TABLE}
	 * </table>
	 */
	public static final String COLGROUP="colgroup";