The HyperText Markup Language is an SGML application conforming to
International Standard ISO 8879 — Standard Generalized Markup
Language. It provides a simple way of structuring hypertext documents
which refer to one another and which collectively create an enormous
"web" which continues to grow and evolve as many hypertext authors add
and modify documents.
The web has expanded and browser developers have added additional
features to the markup language such as new tags and new semantics for
the tags. As a result, many documents have been created which can
only be rendered faithfully on a limited number of browsers. Normal
web practice is to hide any syntactic problems detected by the browsers
and thus the reader is not always aware that the page being browsed is
not faithful to the original authored document.
This &text; has been developed in an effort to ensure that it will
remain possible for an author to produce simple hypertext for the web
and be confident that a conforming browser will be able to render the
document faithfully. This specification represents a core of the
language to be supported by all conforming browsers and provides
techniques for extending the core that are SGML conformant and
represent good SGML practice.
The language defined by this &text; differs slightly from the &dave;
specification. It omits all deprecated features of the language, and
some other features whose role is purely cosmetic. This is done in
preparation for the expected future introduction of style sheets.
Certain optional facilities such as markup omission of the document
element and the major elements have been removed to produce more robust
texts in keeping with recognized good SGML practice. This does not
reduce in any way the expressive power of the language. A minimal
ISO-HTML document has the form:
<!DOCTYPE ISO-HTML PUBLIC
"ISO 15xxx:199x
//DTD HyperText Markup Language//EN"
[<!ENTITY % ISOhtme PUBLIC "ISO 15xxx//ENTITIES CD//EN" >
<!ENTITY % ISOlat1 PUBLIC "ISO 8879:1986//ENTITIES Added Latin 1//EN" >
%ISOlat1;%ISOhtme;
]>
<ISO-HTML>
<HEAD>
<TITLE>Les unités de base</TITLE>
... other head elements
</HEAD>
<BODY>
... document body
</BODY>
</ISO-HTML>
This &text; follows the current World Wide Web convention of presenting
element and attribute names in upper case, although there is no formal
requirement for the practice.
In order to support world wide use of the markup language, the
internationalization facilities specified by the IETF have been
included in this &text; in anticipation of their expected inclusion in
the W3C specifications.
The elements of the ISO-HTML language are specified in this &text; in
alphabetical order but may also be reviewed in the following order
which reflects more closely the structure of the DTD:
The ISO-HTML element
The HEAD element
The BASE element
The ISINDEX element
The LINK element
The META element
The TITLE element
The BODY element
The ADDRESS element
The block elements parameter entity %block;
The BLOCKQUOTE element
The DIV element
The DL element
The DT element
The DD element
The FORM element
The HR element
The ISINDEX element
The OL element
The LI element
The P element page=yes>
The PRE element
The TABLE element
The CAPTION element
The TR element
The TH element
The TD element
The UL element
The text elements parameter entity %text;
The physical style elements parameter entity %physical.styles;
The B element
The BIG element
The I element
The SMALL element
The STRIKE element
The SUB element
The SUP element
The TT element
The U element
The logical style elements parameter entity %logical.styles;
The CITE element
The CODE element
The DFN element
The EM element
The KBD element
The Q element
The SAMP element
The STRONG element
The VAR element
The form elements, parameter entity %form;
The INPUT element
The SELECT element
The OPTION element
The TEXTAREA element
The special elements, parameter entity %special;
The A element
The BDO element
The BR element
The IMG element
The OBJECT element
The PARAM element
The MAP element
The AREA element
The SPAN element
The sectioning elements
The H1 element
The B1 element
The H2 element
The B2 element
The H3 element
The B3 element
The H4 element
The B4 element
The H5 element
The B5 element
The H6 element
The B6 element
This document
This &text; represents the editors' best efforts to capture the
continuing development of the language. The editors' have copied text
from
- the IETF RFC 1866 ,
- the &dave; specification ,
- the W3C Working Draft dated 1996-04-22 describing work in progress
on Inserting objects into HTML ,
- the SGML Handbook where needed to ensure
consistency with those specifications,
- the IETF HTML internationalisation specification
.
Source markup
This document was prepared using ISO 8879 based technology. Details of
the DTD used to structure this document may be found in ISO/IEC
TR 9573-11 Information processing — SGML support facilities
— Techniques for using SGML — Part 11: Application at ISO
Central Secretariat for International Standards and Reports.
The scope of this &text; is a conforming application of SGML, ISO
8879:1986, which provides a simple and stable markup language for
documents to be published on the World Wide Web. This &text; also
provides techniques whereby application, regional or industry-specific
extensions may be added in a way which follows good SGML practice.
Specificity of the scope
Since it is expected that a wide range of products, user applications,
recommendations and other standards may use this standard, the scope
focuses on the general structuring aspects and provides only
sufficient semantics to ensure that the structures are rendered in a
familiar way.
The scope excludes any standardization of models, services, systems,
protocols or applications which are likely to make use of the ISO-HTML
language. This specification does not define the "look and feel" of
any conforming product.
Conforming ISO-HTML documents
A document which conforms to this &text; shall
- be a conforming SGML document,
&NB;
This requirement is itself required by ISO 8879:1986 subclause 15.2.2
[Goldfarb p.480].
- conform to the requirements of this &text;.
Conforming ISO-HTML systems
A conforming ISO-HTML system is a conforming SGML system which is able to
process any conforming ISO-HTML document.
This requires the system to be capable of processing any conforming
ISO-HTML document that is not inconsistent with its "system
declaration". In order to promote the maximum capability for
document interchange among systems, every conforming system must be
able to support the reference concrete syntax and the ISO-HTML capacity
set [Goldfarb p.481].
Documentation of conforming ISO-HTML systems
Systems conforming to this &text; shall display the ISO-HTML identification
text prominently:
- In a prominent location in the front matter of all publications
(normally the title page and the cover page),
- On all identifying display screens of programs,
- In all promotional and training material.
and in the national language of the documentation.
The ISO-HTML system identification text is: ISO-HTML, an SGML system
conforming to International Standard ISO 8879 — Standard
Generalised Markup Language.
These requirements are intended to help users apply knowledge gained
on one SGML system to the use of other systems, not to inhibit
friendly documentation and human-computer interfaces [Goldfarb p.486].
&NB;
The editors have deliberately omitted any reference to the national language to
be used for the identification text. The issue is too complex, and
not worth the trouble [Goldfarb p.486 subclause 15.5.1 line 6].
The documentation shall distinguish SGML constructs from ISO-HTML
conventions and system functions, and shall identify the SGML
constructs as being part of the Standard Generalized Markup Language.
The objective of this requirement is for the user to be aware of
which constructs are common to all SGML systems, and which are unique
to ISO-HTML. This will reduce the experienced user's learning time for a
new system or application.
&NB;
This requirement is itself required by ISO 8879:1986 subclause 15.5.2
[Goldfarb p.486 line 23].
The documentation shall cite ISO 8879:1986 as a reference for
supported SGML constructs that are not specifically documented for the
system.
For example, if, for simplicity's sake, only a subset of some function
is presented in the documentation (such as omitting some of the
options of the entity declaration), it shall be stated clearly that
other options exist and can be found in the SGML International
Standard [Goldfarb p.487].
&NB;
Do we need to include text to cover the requirement of ISO 8879:1986
subclause 15.5.3 "Terminology"? [Goldfarb p.487].
Validating ISO-HTML systems
In addition to being a conforming ISO-HTML system, a system is also a
validating ISO-HTML system if
- It is a validating SGML parser as defined by ISO 8879:1986
subclause 15.4; and
- It finds and reports an ISO-HTML error if one exits; and
- Does not report an ISO-HTML error where none exists.
&NB;
The &dave; specification does not say what the reportable HTML errors
are.
Character set conformance
&NB;
We have taken the same approach here as was taken by ISO 2022, and
this subclause is based on ISO 2022 clause 3.
The SGML declaration provided with this &text; calls for the use of
the Basic Multilingual Plane of the ISO/IEC 10646 Universal
Multiple-Octet Coded Character Set (UCS). ISO/IEC 10646 addresses
whole classes of provisions and it is not intended by this &text; that
they are all implemented in any user agent. As a result it is only
practicable to envisage limited conformance to ISO/IEC 10646 as
defined in this subclause.
Under limited conformance, the following is required:
- When the characters described by ISO/IEC 10646 are used, they
shall be implemented by the control functions, and with the meanings
and coded representation specified in ISO/IEC 10646.
- When two systems with different levels of implementation of the
ISO/IEC 10646 coded character set are required to communicate with one
another, they shall do so using using that part of the coded character
set they have in common.
- This &text; does not discuss the operation of the HTTP protocol
.
- If a server is unable to express a document using
the limited character set supported by the user agent, it should instead
deliver a document in the limited character set explaining the
impossibility.
- Code positions that are either reserved for registration or
reserved for future standardization shall not be used.
- No registered escape sequence shall be used with a meaning
different from that defined by ISO/IEC 10646.
The UTF-1 transformation format of ISO/IEC 10646, registered by IANA
as ISO-10646-UTF-1, has been removed from the ISO/IEC 10646 and should
not be used.
ISO 639:1988
ISO 646:1991
ISO 3166:1993
ISO 8859-1:1987
ISO 8879:1986
ISO 10646-1:1993
ISO 8879:1986
- Justifying element
- An element which carries an &a.align; attribute used to specify
horizontal justification of its content relative to the current left
and right margins. The &a.align; attribute takes one of the following
values:
- LEFT: text is left justified, ragged right.
- CENTER: text is centered, ragged left and ragged right.
- CENTRE: a permitted alternative specification of CENTER.
- RIGHT: text is right justified, ragged left.
The justifying elements specified by this &text; are &justifying;.
- Boxing element
- An element which carries an &a.align; attribute used to specify
the position of a box around the visible rendered area.
The boxing elements specified by this &text; are &boxing;.
- Browser
- A User Agent whose main function is to present documents to the user.
- Character
- An atom of information, for example a letter or a
digit. Graphic characters have associated glyphs, whereas control
characters have associated processing semantics.
The multiple definitions and techniques for the representation of
characters may be the source of confusion. The following
table shows some of the ideas involved:
The set of characters
in this column forms
the character repertoire
|-------------------->|
| This function called|
|"coded character set"|
| by RFC 1866 |
,---|---------------------|---------------------------------,
| Code | Bit | Character |ISOlat1 |Numeric |Glyph|
|posit- |pattern| name |entity |character| |
| ion |(hexa) | |ref. |reference| |
|-------+-------+------------------+--------+---------+-----|
| 0 | 00 |Unused | | | |
| ... | | | | | |
| 121 | 79 |SMALL LETTER y | | y | y |
| 122 | 7A |SMALL LETTER z | | z | z |
| 123 | 7B |LEFT CURLY BRACKET| | { | { |
| ... | | | | | |
| 199 | C7 |CAPITAL C, CEDILLA|Ç| Ç | |
| 200 | C8 |CAPITAL E, GRAVE |È| È | |
| 201 | C9 |CAPITAL E, ACUTE |É| É | |
| ... | | | | | |
| 255 | FF |SMALL y, UMLAUT |ÿ | ÿ | |
'--|-------|-------------|----------------------------------'
| | |
| |------------>|
| | This function is called the "character encoding
| | scheme" by RFC 1866.
| |<------------|
| | This function is called "character set" by SGML
| |
| Called the "code set" by SGML
Called the "character number" by SGML
Illustration of some character representation definitions
This illustration is based on the character set defined by
ISO 8859-1:1987 "8-bit single-byte coded graphic character sets",
Part 1: Latin alphabet No. 1.
- Character encoding scheme
- A function whose domain is the set of sequences
of octets, and whose range is the set of sequences of characters from
a character repertoire; that is, a sequence of octets and a character
encoding scheme determines a sequence of characters.
- Character repertoire
- A finite set of characters; eg. the range of a
coded character set.
- Code position
- An integer; a coded character set and a code
position from its domain determine a character.
- Coded character set
- A function whose domain is a subset of the
integers and whose range is a character repertoire. That is, for some
set of integers (usually of the form {0, 1, 2, ..., N}), a coded
character set and an integer in that set determine a character.
Conversely, a character and a coded character set determine the
character's code position (or, in rare cases, a few code positions).
- CRLF
- The sequence of the two ISO 646:1983 characters
CR (13) and LF (10) which, taken together, in this order, denote a
line break.
- Form data set
- A sequence of name/value pairs; the names are
given by an ISO-HTML document and the values are given by the user.
- Fragment identifier
- The portion of an &a.href; attribute following
the `#' character which may modify the presentation of the
destination of a hyperlink.
- ISO-HTML browser
- Browser which presents ISO-HTML documents.
- ISO-HTML document
- A document structured in accordance with this &text;.
- Hyperlink
- A relationship between two anchors, called the source and the
target. The link goes from the source to the target. The source is
also known as the tail, and the target is also known as the
destination or head.
The following symbols and abbreviations are used in this &text;.
ISO-HTML
Pertaining to this standard.
HTML 3.2
A specification for the Hypertext Markup Language developed by
the World Wide Web Consortium.
HTTP
IETF RFC 2068 HyperText Transfer Protocol.
HyTime
One or more architectural forms as provided by
ISO 10744:-.
IANA
Internet Assigned Numbers Authority. IANA is the central
coordinator for the assignment of unique parameter values for Internet
protocols. The IANA is chartered by the Internet Society (ISOC) and the
Federal Network Council (FNC) to act as the clearinghouse to assign and
coordinate the use of numerous Internet protocol parameters
.
IETF
Internet Engineering Task Force.
RFC
Request for Comments. An Internet Engineering Task Force specification.
SGML
Notation provided through use of ISO 8879:1986.
URI
Universal Resource Identifier as defined by .
URL
Uniform Resource Locator as defined by .
WWW
World Wide Web
W3C
World Wide Web Consortium, founded in 1994 to develop common
standards for the evolution of the World Wide Web. It is an industry
consortium, hosted by the Massachusetts Institute of Technology
Laboratory for Computer Science (MIT/LCS) in the United States, the
Institut National de Recherche en Informatique et en Automatique
(INRIA) in Europe and the Keio University Shonan Fujisawa Campus in
Asia http://www.w3.org/.
Requirements
This &text; has been designed to satisfy the following requirements,
as documented in ISO/IEC JTC1/SC18/WG8 N1852 dated 24 June 1996:
- Provide a minimum presentation architecture for SGML applications.
- Clarify relationships between ISO-HTML and SGML details, such as SGML
declaration and minimization.
- Allow ISO-HTML to be used in environments where ISO standards are required.
- Allow ISO-HTML to be used as a base architecture for other SGML applications.
- Documents conforming to this &text; should be viewable by browsers
that conform to the &dave; (or an appropriate later version of
that specification).
- Define useful subsets of the &dave; (or an appropriate
later version of that specification).
Internationalization
The early applications of HTML on the World-Wide Web were seriously
restricted by their reliance on the ISO 8859-1:1987 coded character
set, which is appropriate only for Western European languages. This
&text; provides facilities for a fuller internationalization, based on
RFC 2070 . The following subclauses specify the
general internationalization features.
The ALIGN attribute when used for justification
The internationalization facilities use the &a.align; attribute to
specify the horizontal alignment to be applied to content within the
scope of the justifying elements: &justifying;.
The &a.align; justification attribute takes the following values:
- ALIGN=left
- Render "flush left" or left justified. The right edge is
ragged.
- ALIGN=center
- Render "centered". The left and right edges are ragged.
- ALIGN=centre
- A permitted alternative specification of ALIGN=center.
- ALIGN=right
- Render "flush right" or right justified. The left edge is
ragged.
- ALIGN=justify
- Render fully justified on the left and right. There are no ragged
edges.
In the case of nested justification specifications, the innermost
containing specification shall apply. If a justifying &a.align;
attribute is omitted, the value of the next outer justifying
specification is used. If the &a.align; attribute is omitted from all
containing justifying elements, the value "left" shall be used.
There are elements defined by this &text; which have an &a.align;
attribute for historical reasons, but are not justifying elements.
E.g. the &caption; element and the boxing elements &boxing;.
Examples of justifying behaviour
- In this example all the containing justification specifications
are present, and the innermost applies.
<DIV ALIGN=left>
<OL ALIGN=justify>
<LI ALIGN=right>Important sentence ...
</OL>
</DIV>
The
Important sentence
is right aligned.
- In this example only some of the containing justification
specifications are present, and the innermost specification applies.
<DIV ALIGN=left>
<OL>
<LI ALIGN=justify>
<P>Important sentence ...
</OL>
</DIV>
The
Important sentence
is fully justified.
- In this example none of the containing justification specifications
are present, hence the default value applies.
<DIV>
<P>Important sentence ...
</DIV>
The
Important sentence
is left justified.
The CLASS attribute
It is expected that many ISO-HTML documents will be created by automatic
processes from SGML documents structured according to richer document
type definitions, eg. the DTD for ISO documents specified in ISO TR
9573. Conversion to the ISO-HTML structure may lead to the loss of
some information about document content. For example the notes in an
ISO document are tagged using the ¬e; element, rather than the &p;
element. A rendering system might typically apply the ISO note style
to the content of a ¬e; element, making it distinct in the output
presentation. There may be a need to retain this type of information
during the conversion to ISO-HTML so that browsers with the capability may
provide a distinctive rendering.
The &a.class; attribute provides a means of attaching a sequence of
SGML names to the element indicating the class to which the element
belongs: typically the source element name if the document is the
result of an automatic conversion from another document type.
This &text; does not define values for the &a.class; attribute.
An example
A conversion process might convert <note>This text does not
define values for the class attribute.</note> to <P
CLASS=note>This text does not define values for the class
attribute.</P>
The DIR attribute
The &a.dir; attribute indicates the writing direction of text. With
block-type elements the &a.dir; attribute indicates the base writing
direction of the text in the block. If the attribute is omitted, the
writing directional is inherited from the parent element if present.
With inline elements, it indicates the element start a new writing
direction embedding level. Directional-embedding is used to handle
nested changes in writing direction. A common need for embedding
characters is to handle text that has been pasted from one
bidirectional context to another.
An example
Here is an example of a case where direction-embedding is needed:
The following latin (shown in upper case) and arabic (shown in
lower case) letters in backing store with the specified writing
direction embeddings (LRE is shorthand for <SPAN DIR=ltr>, RLE for
<SPAN DIR=rtl> and PDF for </SPAN>):
LRE A B RLE a b LRE C D PDF c d PDF E F PDF
result in the following rendering with square brackets showing the
directional transitions:
[ A B [ d c [ C D ] b a ] E F ]
If the &span; elements with &a.dir; attributes were not used, this
example would result in the following rendering, assuming an inherited
direction of "ltr".
[ A B [ b a [ C D ] d c ] E F ]
Notice that b a is on the left and d c is on
the right unlike the example where writing direction embedding levels
are used. Without writing direction embedding characters there would
be at most two levels: a base directional level and a single
counterflow level.
The ID attribute
When documents with the same information content in different
languages are created, there may be a need to identify elements in the
documents as being the "same" element, differing only in the language
employed.
The &a.id; attribute provides a means of identifying the "same"
element in different documents. Within each document, the elements'
&a.id; attribute is set to the same value.
The LANG attribute
The &a.lang; attribute identifies a natural language spoken, sung,
written or otherwise used by human beings for communication of
information between people. Computer languages are explicitly
excluded. The value of the &a.lang; attribute is referred to as the
"language tag".
The syntax and registry of language tags used by this &text; is the
same as that defined by RFC 1766 , where a
language tag is composed of one or more parts: a primary language tag
and a possible empty series of subtags. For example, using RFC 822
EBNF:
language-tag = primary-tag *( "-" subtag )
primary-tag = 1*8ALPHA
subtag = 1*8ALPHA
Whitespace is not allowed within the tag and all tags are case
insensitive. The namespace of language tags is administered by the
IANA. Example tags include: en, en-US,
en-cockney, i-cherokee and
x-pig-latin.
Two-letter primary-tags are reserved for ISO 639 language
abbreviations. This &text; does not specify three-letter
primary-tags, however their description may be found in the
"Ethnologue" . Any two-letter initial sub-tag is
an ISO 3166 country name.
In the context of this &text;, a language tag is not to be interpreted
as a single token, per RFC 1766, but as a hierarchy. For example, a
user agent that adjusts its rendering according to language should
recognize that it has a match when a language tag in a style sheet
entry matches the initial portion of the language tag of an element.
An exact match should be preferred. This interpretation allows an
element marked up as, for instance, en-US to trigger
styles corresponding to, in order of preference, US-english
(en-US) or `international' English
(en).
Using the language tag as a hierarchy does not imply that all languages
with a common prefix will be understood by those fluent in one or more
of the languages; it simply allows the user to request
commonality when desired.
It is intended that any new element introduced in later versions or
extensions to ISO-HTML will admit the &a.lang; attribute, unless there is
a compelling reason not to do so.
The rendering of elements is meant to be controlled (in part) by the
&a.lang; attribute. Specific user preferences set within a browser
should override the &a.lang; attribute which in turn overrides the
value specified by the &a.lang; attribute of any enclosing element.
If none of these are set, a suitable default, perhaps controlled by
the user's locale, should be used to control rendering.
User agent unable to handle characters
If a user agent is unable to handle a character due, for example, to a
lack of a resource such as a font, this should be indicated to the end
user, clearly but unobtrusively.
Since some documents may contain many characters that cannot be
rendered, showing an alert for each one is excessive.
If a numeric representation of a missing character is given, its
hexadecimal, not decimal, form is to be preferred since this is the
form used in character set standards.
Byte order
When an ISO-HTML text is transmitted directly in a multibyte
representation, this &text; recommends:
- That it be transmitted in big-endian byte order — high order
byte first.
- That the document always begin with a ZERO-WIDTH NON-BREAKING
SPACE character (hexadecimal FEFF) which, when byte-reversed becomes
number FFFE, a character guaranteed never to be assigned. Thus a user
agent receiving an FFFE as the first two octets of a text would know that
bytes have to be reversed for the remainder of the text.
Use of named character references
It is often convenient for an author to use named character references
to specify characters which are not available on the author's
keyboard. Wherever named characters are used for characters specified
by ISO 10646, the name used shall be that specified in ISO TR 9573.
ISO 9573 defines names for all the characters specified by ISO 10646.
The intention of this requirement is to facilitate interchange.
Example: <EM>Liberté Égalité
Fraternité!</EM>
The DTD
The DTD provided by this &text; has a public document type
definition with the invocation:
<!ENTITY % ISO-HTML PUBLIC
"ISO 15xxx:199x
//DTD HyperText Markup Language//EN">
%ISO-HTML;
Alternate public document type definition
Many popular user agents do not support the use this &text; makes
of the document type declaration subset. To facilitate the use of
ISO-HTML an alternate public document type definition is provided
to specify a DTD which is totally self contained and contains all
of the features of ISO-HTML without using the document type
declaration subset.
<!ENTITY % ISO-HTML PUBLIC
"ISO 15xxx:199x
//DTD HyperText Markup Language Core//EN">
%ISO-HTML;
With the use of this public document type definition the minimum
document becomes:
<!DOCTYPE ISO-HTML PUBLIC
"ISO 15xxx:199x
//DTD HyperText Markup Language Core//EN">
<ISO-HTML>
<HEAD>
<TITLE>Les unités de base</TITLE>
... other head elements
</HEAD>
<BODY>
... document body
</BODY>
</ISO-HTML>
Copyright protection
This document makes several references to industry and proprietary
standards, products and publications. Such references are not
normative, and do not imply endorsement by the ISO, IEC, or their
national member bodies or affiliates. Any brand names or trademarks
mentioned are the property of their respective owners.
The formal SGML definitions are part of the text of this &text; and
are protected by copyright held by the IETF and the W3C.
Hyperlinks
&NB;
This clause is based entirely on clause 7 in RFC 1866 HTML
2.0 .
Hyperlinks provide the mechanism which ties the web together and gives
it an overall structure. They are the threads of gossamer glueing
documents together. They have two ends, known as the source
anchor and the target anchor which are both
identified by their address: an absolute Uniform Resource Identifier
(URI) , optionally followed by a `#'
character and a further sequence of characters called a fragment
identifier. For example:
http://www.xyz.org/hypertext/WWW/TheProject.html
http://www.xyz.org/hypertext/WWW/TheProject.html#Overview
&NB; In RFC 1866, source anchors are called tail
anchors, and target anchors are called head anchors as
viewed from the current position in the hypertext document by a user
agent. That is, prior to selecting a hypertext link its destination
is seen as a target, but after selection and rendering the same
position subsequently appears as a source.
In an anchor address, the URL refers to a resource; it may be used in
a variety of information retrieval protocols to obtain an entity that
represents the resource, such as an ISO-HTML document. The fragment
identifier, if present, marks some position in the
resource.
Each of the following constructs provides the target anchor of a
hyperlink or set of hyperlinks:
- The &a; element with the &a.href; attribute present.
- The &img; element.
- The &link; element.
- The &isindex; element.
- The &form; element with &a.method;=get.
- The &input; element with the &a.src; attribute present.
These markup constructs refer to source anchors by URL, in either
absolute or relative form, or to a fragment identifier, or to both.
In the case of a relative URL, the actual address referenced by the
user agent is constructed by combining the specified relative address with an
absolute base URL as in RFC 1808 . The base address is
taken from the document's &base; element, if present; otherwise it is
determined as in RFC 1808 .
Accessing resources
Once the address specified by the target anchor is determined, the user
agent may obtain a representation of the resource (now the source).
For example, if the base address of a document is
http://host/x/y.html and the document contains:
<IMG SRC="../icons/abc.jpeg">
then the user agent uses the URL
http://host/icons/abc.jpeg to access the resource.
The user agent constructs the destination URL by discarding
the file identifier portion of the base address (if present).
Activation of hyperlinks
An ISO-HTML user agent allows the user to navigate the content of a
document and request activation of hyperlinks denoted by &a; elements.
To activate a link, the user agent obtains a representation of the
resource identified by the address specified in the source anchor. If
the representation is another ISO-HTML document, navigation may begin
again with this new document.
Simultaneous presentation of image resources
An ISO-HTML user agent may activate hyperlinks indicated by &img;
elements concurrently with processing a document; that is,
image hyperlinks may be processed without explicit request by the
user. Image resources should be embedded in the presentation at the
point of the source anchor, that is the &img; element.
The same also holds for &input; elements within forms.
Fragment identifiers
Any characters following a `#' character in a hypertext
address constitute a fragment identifier. In particular, an address
of the form #fragment refers to a target anchor in the
document.
The meaning of fragment identifiers depends on the media type of the
representation of the target anchor's resource. For
text/html representations, it refers to the &a; element
whose &a.name; attribute value is the same as the fragment
identifier. Character matching is case sensitive. The target document
shall have exactly one such element. The user agent should render
the source anchor element by scrolling to and/or
highlighting the text at the destination position.
For example, if the base URL is http://host/x/ and
the user activates the link denoted by the following markup:
<P>See: <A> HREF="app1.html#bananas">Appendix 1</A>
for more details on bananas.
then the user agent accesses the resource identified by
http://host/x/app1.html and assuming the resource is
represented using the text/html media type, the user
agent shall locate the &a; element whose &a.name; attribute has the
value bananas and begin navigation at that point.
The extend and addon interfaces
This &text; does not define facilities for specifying style in the
body of a conforming document. However, authors of simple documents
may wish to make use of such a facility and suppliers of user agents
may wish to add the facility to the ISO-HTML document architecture. This
is possible, and conveniently done using one of the extend
or addon interfaces. Many extensions and addons may be
defined in the future: this clause defines the general
extend and addon interface mechanism and
provides an example of its use.
There are three types of interfaces available to document designers:
- New element interface
- The &head.extend; and &body.extend; interfaces which allow the
addition of new elements and their attributes.
- Additional attribute interface
- The &a.addons; interfaces which allow the addition of further
attributes to existing elements.
- Notation interface
- The use of notations as defined by ISO 8879:1986.
This &text; does not define any uses of the extend or
addon interfaces, although an example is given to assist
readers in their understanding of the SGML mechanisms used.
&NB;
This mention of the use of SGML notations does not extend the proposed
ISO-HTML standard. The full power of SGML is available to all conforming
applications [see Goldfarb 15.2.2 p.480].
Conformance of extensions
No extend or addon shall cause a document to be
non-conforming if that document is conforming in the absence of the
extend or addon.
This &text; does not address the question of interdependencies between
possibly incompatible extensions defined by other specifications.
The new element interface
The &head.extend; and &body.extend; interfaces provide a means of
extending the architecture of a document to include additional
elements and attributes. The &head.extend; interface allows additions
within the head of a document, at any point at which the &meta;
element may be used. The &body.extend; interface allows additions
within the body of a document at any point where an &a; element
might be used. The technique used is to extend the content models
which contain the &meta; and &a; elements.
By default the interfaces contain a &nop; element which has no
semantic value, but the interface may be redefined to include an
additional DTD fragment in the document architecture.
The procedure for adding new elements is as follows:
- Place the definitions of the new elements and their attributes in
a DTD fragment and assign a public text identifier. The definitions in
this DTD fragment may make use of the entities defined in the ISO-HTML
entity set.
The fragment may be in a single file, or in two or more files, for
example one file for parameter entity definitions and another for
element definitions.
- Place a new definition for the &head.extend; or &body.extend;
parameter entity in the document type declaration subset. The
definition should provide a content model for the new elements.
Typically it is of the form ELEMENT1 | ELEMENT2 .... The
definition will override the default definition &nop; provided by the
&text; DTD entity set [see Goldfarb p.404 line 32]. More than one
extension may be defined in the &head.extend; or &body.extend;
parameter entities with declarations of the form EXTEND1.EL1 |
EXTEND1.EL2 | ... | EXTEND2.EL1 ....
- Place a parameter entity definition (or definitions) for the DTD
fragment(s) containing definitions of the new elements and attributes
in the document type declaration subset.
- Invoke the &head.extend; or &body.extend; parameter entity.
- Invoke the parameter entities for the DTD fragments at the end of
the document type declaration subset.
The additional attribute interface
The &a.addons; interfaces provide a means of extending the set of
attributes of an existing element. By default, the interfaces contain
an empty string, ie. no additional attributes, but by redefining the
interface, new attributes may be added to extend the document
architecture.
The procedure for adding new attributes to an existing element X is as
follows:
- Place the definitions of the new attributes for the X element in
an &X.addon; parameter entity in a DTD fragment and assign it a public
text identifier. The definitions in this DTD fragment may make use of
the entities defined in the ISO-HTML entity set.
This DTD fragment may be shared with the one defined in .
This definition will override the default definition provided by the
&text; DTD entity set [see Goldfarb p.404 line 32].
- Place a parameter entity definition for the DTD fragment in the
document type declaration subset.
- Invoke the parameter entities for the DTD fragments at the end of
the document type declaration subset.
Use of the document type declaration subset
The extension techniques provided by this &text; make use of the
document type declaration subset which is a part of all SGML
documents. However many historic World Wide Web browsers do not
process the subset, so it is recommended that for wide public use, the
designer of an extension consider repackaging the extension with the
parameter entity set and the document type definition provided by this
&text; as a single entity (file) which can be referenced by a suitable
public text identifier in the DOCTYPE declaration.
Such a repackaging will reduce the risk of error by users of the
extension, and will allow the authority defining the package to
provide better documentation and quality assurance, particularly when
the package contains several extensions.
The NOP attribute
A small number of the elements defined by this specification have a single
&a.nop; attribute assigned to them.
This attribute is defined in the DTD to ensure that the DTD remains
syntactically correct when the addon interface is not used.
This attribute has no meaning and is not intended for use by authors or
authoring systems.
Example of addon definitions
&NB;
See the file sample2.iso-html for an example of a
complete document type declaration subset.
These files will be cleaned up and placed in an informative annex.
Elements rendered as rectangles
The &boxing; elements defined by this &text; are usually rendered as
rectangles with boxes around the visible area. Each of the elements
which creates such a box is provided with an &a.align; attribute to
specify how the rendered item is positioned with respect to the
baseline of the text flow in which it occurs. A user agent may take into
account only that text which has been placed on the line prior to the
placement of the item in deciding the alignment of the enclosing box.
Each of the elements described in this clause use some of the
attribute values from the following list:
- ALIGN=top
- Aligns the top of the rectangle with the top of the text rendered
in the current line.
- ALIGN=texttop
- A permitted alternative specification for &a.align;=top.
- ALIGN=middle
- Aligns the middle of the rectangle with the current baseline.
- ALIGN=textmiddle
- Aligns the middle of the rectangle with a horizontal line drawn
through the middle of the text rendered in the current line.
- ALIGN=bottom
- Aligns the bottom of the rectangle with the current baseline.
- ALIGN=baseline
- A permitted alternative specification for &a.align;=bottom.
- ALIGN=textbottom
- Aligns the bottom of the rectangle with a horizontal line drawn
through the bottom of the text rendered in the current line.
- ALIGN=left
- Places the rectangle to the right of the current left margin,
temporarily changing this margin. Subsequent text may be flowed along
the rectangle's righthand side.
- ALIGN=center
- Places the rectangle after the end of the current line, centered
between the left and right margins. Subsequent text starts at the
beginning of the next line.
- ALIGN=centre
- A permitted alternative specification for &a.align;=center.
- ALIGN=right
- Places the rectangle to the left of the current right margin,
temporarily changing this margin so that subsequent text is flowed
along the rectangle's lefthand side.
The &caption; element and the justifying elements also have an &a.align; attribute, but in
these cases its meaning is different.
The A element — Source and target anchors
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT A - - (%text;)* -(A) >
<!ATTLIST A
CHARSET NAME #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
HREF %URL; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
NAME CDATA #IMPLIED
REL CDATA #IMPLIED
REV CDATA #IMPLIED
TITLE CDATA #IMPLIED
%a.addon; >
&NB;
The attributes &a.rel; and &a.rev; are declared by &dave; to have type
CDATA but &dan; declares them as NAMES. Which do we choose?
Description
The &a; element defines hyperlink source and target anchors (see clause
). A source anchor requires the &a.href;
attribute which provides the address of the target, while a target anchor
requires the &a.name; attribute which identifies it as a location that may
be used as a target in source anchors. At least one of the &a.href and
&a.name attributes shall be present.
Good practice dictates that anchors should not be attached to markup,
thus <H1><A NAME="xxx">Heading</A></H1> is
preferred to <A
NAME="xxx"><H1>Heading</H1></a>.
In the example given, the deprecated usage is also forbidden by the
DTD, since it would not respect the required correct nesting of
sections.
Both start and end tags are required.
Attributes
The attributes of the &a; element are:
- CHARSET
- A hint to the user agent concerning the character encoding scheme used
by the resource pointed to by the link. It should be the appropriate
value of the MIME charset parameter for that resource .
- CLASS
- Please see .
- DIR
- Please see .
- HREF
- Gives the URL of the source anchor of a hyperlink. For example:
The way to <A HREF="hands-on.html">happiness</A>.
- ID
- Please see .
- LANG
- Please see .
- NAME
- Gives the name of the anchor, and makes it available as a target for
a hyperlink. The value shall be unique for the scope of the current
document. For example:
<H2><A NAME=mit>Hacker's Paradise</A></H2>
- REL
- The &a.rel; attribute gives the relationship(s) described by the
hyperlink. The value is a whitespace separated list of relationship
names. The semantics of link relationships are not specified in this
document.
- REV
- Same as the &a.rel; attribute, but the semantics of the relationship
are in the reverse direction. A link from A to B with
REL="X" expresses the same relationship as a link from B
to A with REV="X". An anchor may have both &a.rel; and
&a.rev; attributes.
- TITLE
- Suggests a title for the destination resource — advisory
only. The &a.title; attribute may be used:
- for display prior to accessing the destination resource, for
example, as a margin note or in a small box while the mouse is over
the anchor, or while the document is being loaded;
- for resources that do not include a title, such as graphics, plain
text and Gopher menus, for use as a window title.
Example
...
Please see <A NAME="intro" HREF="#details">here</A>
for further details, and then
<A HREF="http://www.acme.firm">go here</A>
to apply for the job.
...
<H3><A NAME="details">Job description</A></H3>
...
<P>
<A HREF="#intro">Return to introduction.</A>
The ADDRESS element — Author's address
Formal definition
<!ENTITY % justify "(left|center|centre|right|justify)" >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT ADDRESS - - (%text;|P)+ >
<!ATTLIST ADDRESS
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%address.addon; >
Description
The &address; element contains such information as address, signature
and authorship, often at the beginning or end of the body of a
document.
The &address element requires start and end tags. User agents should
render the content with paragraph-breaks before and after. In the
absence of a style-sheet, the &address; element should be rendered in an
italic typeface and may be indented.
Attributes
The &address; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<ADDRESS>
Madame l'Éditrice en Chef<BR>
Le Clarion du Pays<BR>
1, rue Rotative<BR>
Ruritanie<BR>
Téléphone: +800 l2 34 56 789
</ADDRESS>
The AREA element — Region in image map
Formal definition
<!ENTITY % shape "(rect|circle|poly)" >
<!ELEMENT AREA - O EMPTY >
<!ATTLIST AREA
ALT CDATA #REQUIRED
COORDS CDATA #IMPLIED
HREF %URL; #IMPLIED
NOHREF (nohref) #IMPLIED
SHAPE %shape; rect
%area.addon; >
Description
The &area; element describes a region in an image map. It has no
content.
The start tag is required, but the end tag shall be omitted.
Attributes
The &area; element has the following set of attributes:
- ALT
- Specifies a text label which may be displayed in a status line (when
a pointing device is moved over the corresponding region in an image),
or used for constructing a textual menu for non-graphical user agents.
Authors are strongly recommended to provide meaningful &a.alt;
attributes to support interoperability with speech-based or text-only agents.
- COORDS
- Specifies the size and position of a region in an image. See the
&a.shape; attribute for further details.
- HREF
- Specifies the target hypertext link (behaviour) associated with a
region.
- NOHREF
- Specifies that there is no target hypertext link (behaviour)
associated with a region. This allows authors to create holes in regions.
- SHAPE
- Specifies the shape of a region and takes one of the following
values:
- SHAPE=rect
- The region is rectangular and the &a.coords; attribute specifies the
position of its top left and bottom right corners:
&a.coords;="left-x,
top-y, right-x, bottom-y", measured (in pixels) from the top left
corner of the image.
- SHAPE=circle
- The region is circular and the &a.coords; attribute specifies the
position of its centre and the length of its radius:
&a.coords;="centre-x,centre-y,radius".
- SHAPE=poly
- The region is a polygon and the &a.coords; attribute specifies the
position of its corners listed in clockwise order:
&a.coords;="x1,y1, x2,y2, ...".
If an x or y value is given with a percent
sign as suffix, the value will be interpreted as a percentage of the
image's width or height, respectively. For example, SHAPE=rect
COORDS="0,0, 50%,100%".
One of &a.href; or &a.nohref; shall be specified.
Example
<AREA NOHREF SHAPE=circle COORDS="50%,50%,3" ALT="Bulls Eye">
See also the example of a &e.map; element .
The B element — Bold character style
Formal definition
<!ENTITY % physical.styles "B | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
The contents of a &b; element should be rendered in a bold text style.
Both start and end tags are required.
Attributes
The &b; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
Thank you for <B>NOT SMOKING</B>
The BASE element — Base URL specification
Formal definition
<!ENTITY % URL "CDATA" >
<!ELEMENT BASE - O EMPTY >
<!ATTLIST BASE
HREF %URL; #REQUIRED
%base.addon; >
Description
The &base; element provides a base URL for dereferencing relative
URLs, using the rules given by the URL specification .
In the absence of a &base; element the document URL should be used.
This is not necessarily the same as the URL used to request the
document, as the base URL may be overridden by an HTTP header
accompanying a document.
&NB;
This clause appears to contain a normative reference to RFC 1738. How
should this be handled?
The start tag is required, but the end tag shall be omitted.
Attributes
The &base; element has the following required attribute:
- HREF
- The value is a Uniform Resource Locator as defined by IETF RFC
1808 and IETF RFC 1738.
Example
Given the &base; specification
<BASE HREF="http://www.acme.com/intro.html">
the image refernced by
<IMG SRC="icons/logo.jpeg">
is dereferenced to
http://www.acme.com/icons/logo.jpeg
The BDO element — Bidirectional override
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT BDO - - (%text;)+ >
<!ATTLIST BDO
DIR %dirn; #REQUIRED
LANG NAME #IMPLIED
%bdo.addon; >
Description
The &bdo; element contains unusual pieces of text in which
directionality cannot be resolved from the context in an unambiguous
fashion. For example in part numbers, formulas, telephone numbers,
punctuation and other texts whose directionality cannot be determined
by context alone.
Both start and end tags are required.
Attributes
The &bdo; element has the following attributes:
- DIR
- Please see .
- LANG
- Please see .
Example
<p>A palindrome appears the same whether rendered
left-to-write: <BDO DIR=ltr>evil rats on no star live</BDO>
or right-to-left: <BDO DIR=rtl>evil rats on no star live</BDO>.
The BIG element — Big character style
Formal definition
<!ENTITY % physical.styles "... | BIG | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
The contents of a &big; element should be rendered in a larger
font than would otherwise be used.
Both start and end tags are required.
Attributes
The &big; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<BIG>What the large print giveth,</BIG>
<SMALL>the small print taketh away.</SMALL>
The BLOCKQUOTE element — Block quotation
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT BLOCKQUOTE - - %section.content; >
<!ATTLIST BLOCKQUOTE
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%blockquote.addon; >
Description
The &blockquote; element contains a quotation. A typical rendering
might be with a slight left and right indent, and/or an italic font.
The &blockquote; usually provides space above and below the quoted text.
Single font renditions may reflect the quotation style on Internet
mail by putting a vertical line of graphic characters, such as the
greater than symbol (>), in the margin.
Both start and end tags are required.
Attributes
The &blockquote; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<BLOCKQUOTE>Afin de réaliser les objectifs visés
à l'article 129B, la Communauté :
<p>
met en oeuvre toute action qui peut s'avérer nécessaire
pour assurer l'interoperabilité des réseaux, en
particulier dans le domaine de l'harmonisation des normes techniques ;
</BLOCKQUOTE>
Traité sur l'Union Européenne, Article 129 C.
The BODY element — Document body
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT BODY - - (%section.content;, (H1,B1)* ) >
<!ATTLIST BODY
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%body.addon; >
Description
The &body; element contains the textual flow of the document.
Both start and end tags are required.
Attributes
The &body; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of the use of the
&body; element.
The BR element — Line break
Formal definition
<!ELEMENT BR - O EMPTY >
<!ATTLIST BR
NOP (nop) #IMPLIED
%br.addon; >
Description
The &br; element specifies a line break between words. There is no
content.
The start tag is required, but the end tag shall be omitted.
Attributes
This &text; defines no attributes for the &br; element that are
available to the author of ISO-HTML documents, although the following
attribute is present:
- NOP
- Please see .
Example
<ADDRESS>
ISO/IEC Copyright Office<BR>
P.O. Box 56<BR>
1211 Geneva 20<BR>
Switzerland
</ADDRESS>
The B1 element — Major section body
Formal definition
<!ELEMENT B1 O O (%section.content;, (H2,B2)* ) >
<!ATTLIST B1
NOP (nop) #IMPLIED
%b1.addon; >
Description
The &b1; element provides a formal definition for the body of a major
section. This is a part of the mechanism by which the DTD specifies
the required nesting of sections, and thus a validating system will
detect nesting errors.
Since there are many historic HTML browsers which do not handle the
section body elements, it is recommended that authors and authoring
systems make use of the permitted omission of both start and end
tags.
Attributes
This &text; defines no attributes for the &b1; element that are
available to the author of ISO-HTML documents, although the following
attribute is present:
- NOP
- Please see .
The B2 element — Section body
Formal definition
<!ELEMENT B2 O O (%section.content;, (H3,B3)* ) >
<!ATTLIST B2
NOP (nop) #IMPLIED
%b2.addon; >
Description
The &b2; element provides a formal definition for the body of a
section. This is a part of the mechanism by which the DTD specifies
the required nesting of sections, and thus a validating system will
detect nesting errors.
Since there are many historic HTML browsers which do not handle the
section body elements, it is recommended that authors and authoring
systems make use of the permitted omission of both start and end
tags.
Attributes
This &text; defines no attributes for the &b2; element that are
available to the author of ISO-HTML documents, although the following
attribute is present:
- NOP
- Please see .
The B3 element — Subsection body
Formal definition
<!ELEMENT B3 O O (%section.content;, (H4,B4)* ) >
<!ATTLIST B3
NOP (nop) #IMPLIED
%b3.addon; >
Description
The &b3; element provides a formal definition for the body of a
subsection. This is a part of the mechanism by which the DTD specifies
the required nesting of sections, and thus a validating system will
detect nesting errors.
Since there are many historic HTML browsers which do not handle the
section body elements, it is recommended that authors and authoring
systems make use of the permitted omission of both start and end
tags.
Attributes
This &text; defines no attributes for the &b3; element that are
available to the author of ISO-HTML documents, although the following
attribute is present:
- NOP
- Please see .
The B4 element — Subsubsection body
Formal definition
<!ELEMENT B4 O O (%section.content;, (H5,B5)* ) >
<!ATTLIST B4
NOP (nop) #IMPLIED
%b4.addon; >
Description
The &b4; element provides a formal definition for the body of a
subsubsection. This is a part of the mechanism by which the DTD
specifies the required nesting of sections, and thus a validating
system will detect nesting errors.
Since there are many historic HTML browsers which do not handle the
section body elements, it is recommended that authors and authoring
systems make use of the permitted omission of both start and end
tags.
Attributes
This &text; defines no attributes for the &b4; element that are
available to the author of ISO-HTML documents, although the following
attribute is present:
- NOP
- Please see .
The B5 element — Subsubsubsection body
Formal definition
<!ELEMENT B5 O O (%section.content;, (H6,B6)* ) >
<!ATTLIST B5
NOP (nop) #IMPLIED
%b5.addon; >
Description
The &b5; element provides a formal definition for the body of a
subsubsubsection. This is a part of the mechanism by which the DTD specifies
the required nesting of sections, and thus a validating system will
detect nesting errors.
Since there are many historic HTML browsers which do not handle the
section body elements, it is recommended that authors and authoring
systems make use of the permitted omission of both start and end
tags.
Attributes
This &text; defines no attributes for the &b5; element that are
available to the author of ISO-HTML documents, although the following
attribute is present:
- NOP
- Please see .
The B6 element — Minor subsubsubsection body
Formal definition
<!ELEMENT B6 O O (%section.content;) >
<!ATTLIST B6
NOP (nop) #IMPLIED
%b6.addon; >
Description
The &b6; element provides a formal definition for the body of a minor
subsubsubsection. This is a part of the mechanism by which the DTD
specifies the required nesting of sections, and thus a validating
system will detect nesting errors.
Since there are many historic HTML browsers which do not handle the
section body elements, it is recommended that authors and authoring
systems make use of the permitted omission of both start and end
tags.
Attributes
This &text; defines no attributes for the &b6; element that are
available to the author of ISO-HTML documents, although the following
attribute is present:
- NOP
- Please see .
The CAPTION element — Table caption
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT CAPTION - - (%text;)+ >
<!ATTLIST CAPTION
ALIGN (top|bottom) #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%caption.addon; >
Description
The &caption; element is used only in tables, where it contains a
caption for a table.
Both start and end tags are required.
Attributes
The &caption; element has the following attributes:
- ALIGN
- The &a.align; attribute has value top or
bottom and indicates the preferred placement of the
caption with respect to the table. If the &a.align; attribute is
omitted, browsers usually place the caption at the top of the table.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
&caption; is not a justifying element. Authors requiring horizontal
text alignment should consider including a justifying element such as
&p; within the content of the &caption;.
Example
See for an example of the use of the
&caption; element.
The CITE element — Citation
Formal definition
<!ENTITY % logical.styles "CITE | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The &cite; element contains a citation or a reference to other
sources.
Both start and end tags are required.
Attributes
The &cite; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<CITE LANG="en-US">The buck stops here.</CITE>
The CODE element — Program code
Formal definition
<!ENTITY % logical.styles "... | CODE | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The &code; element contains extracts from program code.
Both start and end tags are required.
Attributes
The &code; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
The &a.lang; attribute is used for specifying human languages, not
computer languages.
Example
The list append function may be coded elegantly in Prolog as follows:
<CODE>append([],L,L) .</CODE>
<CODE>append([X|L1],L2,[X|L3]) :- append(L1,L2,L3) .</CODE>
The DD element — Definition data
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT DD - O %section.content; >
<!ATTLIST DD
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%dd.addon; >
Description
The ⅆ element is used only in definition lists and contains a definition for a term marked with a &dt;
element. The definition is usually formatted as an
indented paragraph after the term.
The start tag is required, but the end tag may be omitted.
Attributes
The ⅆ element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of the use of the ⅆ
element.
The DFN element — Defining instance
Formal definition
<!ENTITY % logical.styles "... | DFN | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The contents of the &dfn; element are the defining instance of a term.
Both start and end tags are required.
Attributes
The &dfn; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
ICAO <DFN>International Civil Aviation
Organization</DFN> responsible ...
The DIV element — Document division
Formal definition
<!ELEMENT DIV - - %section.content; >
<!ATTLIST DIV
ALIGN %justify; #IMPLIED
%div.addon; >
Description
The ÷ element may be used to structure documents into divisions.
This &text; makes no recommendation for the presentation of
divisions.
Both start and end tags are required.
Attributes
The ÷ element has the following attribute:
- ALIGN
- Please see .
Example
<BODY>
...
<DIV>
English Dictionary Terms
<DL>
...
</DL>
</DIV>
<DIV>
Japanese Dictionary Terms
<DL>
...
</DL>
</DIV>
...
</BODY>
The DL element — Definition list
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT DL - - (DT|DD)+ >
<!ELEMENT DT - O (%text;)+ >
<!ELEMENT DD - O %section.content; >
<!ATTLIST DL
CLASS NAMES #IMPLIED
COMPACT (compact) #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%dl.addon; >
Description
The &dl; element provides structure for a definition list: a list of
terms and corresponding definitions.
The content is a non empty sequence of intermixed &dt; and ⅆ
elements, usually in pairs. Multiple &dt; may be paired with a single
ⅆ element and vice versa.
Definition lists are usually formatted with the term flushed to the
margin and the definition, formatted paragraph style, indented to
follow the term. If the &dt; term does not fit in the &dt; column
(often one third of the display area), it may be extended across the
page with the ⅆ content moved onto the next line, or it may be
wrapped onto successive lines in the &dt; column.
Both start and end tags are required.
Attributes
The &dl; element has the following attributes:
- CLASS
- Please see .
- COMPACT
- The optional &a.compact; attribute suggests that a compact
rendering be used, perhaps because the list items are small, or the
entire list is large. Unless the &a.compact; attribute is present, a
user agent may leave white space between successive &dt;, ⅆ
groupings. The &a.compact; attribute may also imply a reduction of
the width of the &dt; column.
It is recommended that authors and authoring systems make use of the
permitted omission of the attribute name, see ISO 8879:1986 subclause
7.9.1.2 [Goldfarb p.329 and p.70 line 20]. This will facilitate the use
of historic browsers.
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<DL compact>
<DT>Center
<DT>Centre
<DD>A point equidistant from all points
on the surface of a sphere
<DD>In some field sports the player who
holds the middle position on the field,
court, or forward line
</DL>
The DT element — Definition term
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT DT - O (%text;)+ >
<!ATTLIST DT
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%dt.addon; >
Description
The &dt; element is used only in definition lists and contains a term to be defined. The term is typically
formatted flush to the margin. If the &dt; term does not fit in the &dt;
column (often one third of the display area), it may be extended
across the page with the ⅆ content moved onto the next line, or it
may be wrapped onto successive lines in the &dt; column.
The start tag is required, but the end tag may be omitted.
Attributes
The &dt; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of the use of the &dt;
element.
The EM element — Emphasized text
Formal definition
<!ENTITY % logical.styles "... | EM | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The contents of the &em; element should be emphasized and are
usually rendered in italics.
Both start and end tags are required.
Attributes
The &em; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
Trespassers <EM>will</EM> be prosecuted!
The &form; element provides a template for a form data set and an
associated method and action URL. A form data set is a sequence of
name/value pair fields. The names are specified in the &a.name;
attributes of form input elements, and the values are provided with
initial values by various forms of markup, and may subsequently be
edited by the user. The resulting form data set is used to access an
information service as defined by the &a.action; and &a.method;
attributes.
Form elements can be mixed in with document structuring elements. For
example, a &form; element may contain lists which contain &input;
elements. This gives considerable flexibility in designing the layout
of forms. &form; elements do not contain other &form; elements.
Usually &form; elements contain a sequence of &input; elements along
with additional document structure.
Both start and end tags are required.
Form submission
A user agent usually begins processing by presenting a document with
the fields in their initial state. The user is allowed to modify the
content of fields, constrained by the field type. When the user
indicates that the form should be submitted (using for example a
submit button), the form data set is processed as defined by its
&a.method;, &a.action; URL and &a.enctype; attributes.
Where there is only one single-line text input field in a form, the
user agent should accept "Enter" in that field as a request to submit
the form.
Attributes
The attributes of the &form; element are:
- ACTION
- Specifies the action URL for the form. The action URL of a form
defaults to the base URL of the document .
- CLASS
- Please see .
- DIR
- Please see .
- ENCTYPE
- Specifies the media type used to encode the name/value pairs for
transport, in case the protocol itself does not impose a format. The
default encoding for all forms is
application/x-www-form-urlencoded A form data set is
represented in this media type as follows:
- The form field names and values are escaped; spaces are replaced
by `+', and then reserved characters are escaped as per
RFC 1738 ; that is non-alphanumeric characters are
replaced by %HH, a percent sign and two hexadecimal
digits representing the ASCII code of the character. Line breaks, as
in multi-line text field values, are represented as CRLF pairs,
i.e. %0D%0A.
&NB;
How do we handle the reference to "ASCII"?
- The fields are listed in the order they appear in the document
with the name separated from the value by `=' and the
pairs separated from each other by `;'. Fields with null
values may be omitted. In particular, unselected radio buttons and
checkboxes should not appear in the encoded data, but hidden fields
with &a.value; attributes present should.
&NB;
RFC1866 allows the use of `&' instead of
`;', but notes that this leads to ambiguities, since
`&' is an SGML entity reference delimiter, and encourages
the use of `;'.
- ID
- Please see .
- LANG
- Please see .
- METHOD
- Selects a method for accessing the action URL. The set of
applicable methods is a function of the scheme of the action URL
specified for the form . The
&a.method; attribute has one of the following values:
- METHOD=get — Forms with no server side effects
- If the processing of a form is idempotent (ie. it has no lasting
observable effect on the state of the world), then the form method
should be get. Many database searches have no visible
side-effects and make ideal applications for query forms.
To process a form whose action URL is an HTTP URL and whose method is
get, the user agent starts with the action URL and
appends a `?' and the form data set, in
application/x-www-form-urlencoded format. The user agent
then traverses the link to this URL as if it were an anchor.
The URL encoding may result in very long identifiers, which cause some
historical HTTP server implementations to exhibit defective behaviour.
As a result, some ISO-HTML forms may be written using
METHOD=post even though the form submission has no server
side effects.
- METHOD=post — Forms with server side effects
- If the service associated with the processing of a form has side
effects (for example modification of a data base or subscription to a
service), the method should be `post'.
To process a form whose action URL is an HTTP URL and whose method is
post, the user agent conducts an HTTP `post' transaction
using the action URL, and a message body of type
application/x-www-form-urlencoded format. The user agent
should display the response from the HTTP `post' interaction just as it
would display the response from an HTTP `get'.
Example
<H1>Acme Company Inc</H1>
<H2>Smallsville Agency</H2>
<FORM METHOD=post ACTION="http://www.acme.firm/job">
<B>Job Application Form</B>
<BR>
Your Name:
<INPUT TYPE=text NAME=name VALUE="Yosemite Sam">
<BR>
Do you have a valid driver licence
<BR>
<INPUT TYPE=radio NAME=driver VALUE=yes>Yes
<INPUT TYPE=radio NAME=driver VALUE=no CHECKED>No
<BR>
When you are finished, you may submit this application:
<INPUT TYPE=submit VALUE="Apply">
<BR>
You may clear the application form and start over at any time:
<INPUT TYPE=reset VALUE="New Form">
<BR>
<EM>Acme is an equal opportunity employer<EM>
</FORM>
The HEAD element — Document header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT HEAD - -
(TITLE & ISINDEX? & BASE?)
+(LINK | META | %head.extend;) >
<!ATTLIST HEAD
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%head.addon; >
Description
The &head; element defines the head of an ISO-HTML document, and
contains an unordered collection of general information about the
document.
Both start and end tags are required.
The content model of the &head; element also provides the
&head.extend; interface. See .
Attributes
The &head; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of the use of the
&head; element.
The HR element — Horizontal rule
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT HR - O EMPTY >
<!ATTLIST HR
ALIGN %justify; #IMPLIED
DIR %dirn; #IMPLIED
%hr.addon; >
Description
The &hr; element specifies a horizontal separator in a document.
Visual user agents usually present it as a full width horizontal rule,
while speech-based user agents might present it as a pause.
The start tag is required, but the end tag shall be omitted.
Attributes
The &hr; element has the following attributes:
- ALIGN
- Please see .
- DIR
- Please see .
Example
...
<H5>Monday Activities</H5>
<P>
...
<HR>
<H5>Tuesday Activities</H5>
<P>
...
<HR>
...
The H1 element — Major section header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT H1 - - (%text;)* >
<!ATTLIST H1
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%h1.addon; >
Description
The &h1; element specifies the beginning of a major section of a
document and contains the title of that major section.
Both start and end tags are required.
This &text; requires the correct nesting of sections. The &h1; element
shall not be followed by an &h3;, &h4;, &h5;, or &h6; element without
an intervening &h2; element.
Attributes
The &h1; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<H1>Continent</H1>
...
<H2>Country</H2>
...
<H3>Province</H3>
...
<H4>County</H5>
...
<H5>City</H4>
...
<H3>State</H3>
...
<H4>City</H4>
...
The H2 element — Section header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT H2 - - (%text;)* >
<!ATTLIST H2
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%h2.addon; >
Description
The &h2; element specifies the beginning of a section of a document
and contains the title of the section.
Both start and end tags are required.
This &text; requires correct nesting of sections. The &h2; element
shall not be followed by an &h4;, &h5;, or &h6; element without an
intervening &h3; element. An &h2; element shall be preceded by an
&h1; element.
Attributes
The &h2; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of the use of header
elements.
The H3 element — Subsection header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT H3 - - (%text;)* >
<!ATTLIST H3
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%h3.addon; >
Description
The &h3; element specifies the beginning of a subsection of a
document and contains the title of the subsection.
Both start and end tags are required.
This &text; requires correct nesting of sections. The &h3; element
shall not be followed by an &h5; or &h6; element without an
intervening &h4; element. An &h3; element shall be preceded by an
&h1; element.
Attributes
The &h3; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of the use of header
elements.
The H4 element — Subsubsection header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT H4 - - (%text;)* >
<!ATTLIST H4
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%h4.addon; >
Description
The &h4; element specifies the beginning of a subsubsection of a
document and contains the title of the subsubsection.
Both start and end tags are required.
This &text; requires correct nesting of sections. The &h4; element
shall not be followed by an &h6; element without an intervening &h5;
element. An &h4; element shall be preceded by an &h1; element.
Attributes
The &h4; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of header elements.
The H5 element — Subsubsubsection header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT H5 - - (%text;)* >
<!ATTLIST H5
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%h5.addon; >
Description
The &h5; element specifies the beginning of a subsubsubsection of a
document and contains the title of the subsubsubsection.
Both start and end tags are required.
This &text; requires correct nesting of sections. An &h5; element
shall be preceded by an &h1; element.
Attributes
The &h5; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of header elements.
The H6 element — Minor subsubsubsection header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT H6 - - (%text;)* >
<!ATTLIST H6
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%h6.addon; >
Description
The &h6; element specifies the beginning of a minor subsubsubsection
of a document and contains the title of the minor subsubsubsection.
Both start and end tags are required.
This &text; requires correct nesting of sections. An &h6; element
shall be preceded by an &h1; element.
Attributes
The &h6; element has the following attributes.
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of header elements.
The I element — Italic character style
Formal definition
<!ENTITY % physical.styles "... | I | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
The contents of an &i; element should be rendered in an italic text
style if available, otherwise an alternative representation may be
used.
Both start and end tags are required.
Attributes
The &i; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
Following her <I LANG=fr>affaire</I> with the
well known rugby player, ...
The IMG element — Inline images
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT IMG - O EMPTY >
<!ATTLIST IMG
ALIGN (top|middle|bottom|left|right)
#IMPLIED
ALT CDATA #REQUIRED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
ISMAP (ismap) #IMPLIED
LANG NAME #IMPLIED
SRC %URL; #REQUIRED
USEMAP %URL; #IMPLIED
%img.addon; >
Description
The &img; element refers to an image or icon via a hyperlink, see
.
Non-graphical user agents should process the value of the &a.alt;
attribute as an alternative to processing the image resource indicated
by the &a.src; attribute.
The &img; element has no content.
The start tag is required, but the end tag shall be omitted.
Attributes
The &img; attributes are as follows:
- ALIGN
- Please see
- ALT
- The &a.alt; attribute is required, and specifies text that may be
used in place of the referenced image resource. Use of this attribute
is vital for interoperability with speech-based and text only user
agents.
- CLASS
- Please see .
- DIR
- Please see .
- ISMAP
- If the &a.ismap; attribute is present in an &img; element, the
&img; element shall be contained in an &a; element with an &a.href;
attribute present. This construct represents a set of hyperlinks.
The user can choose from the set by selecting a pixel on the image.
The user agent computes the target URL by appending the character
`? and the comma separated x and y coordinates of the
selected pixel to the URL given in the &a; element.
- ID
- Please see .
- LANG
- Please see .
- SRC
- The &a.src; attribute is required, and specifies the URL of the
image resource.
In practice, the media types of the image resources are limited to a
few raster graphic formats: typically image/jpeg,
image/gif. In particular, text/html
resources are not intended to be used for images.
- USEMAP
- Specifies a URL fragment identifier for a client-side image map
defined with the &e.map; element, see .
Example
If the document contains:
...
<ISO-HTML><HEAD><TITLE>ImageMap Example</TITLE>
<BASE HREF="http://host/index"></HEAD>
<BODY>
<P>Select a point of interest in the following image:
<A HREF="/cgi-bin/imagemap">
<IMG ismap SRC="atlas.jpeg"
ALT="Atlas of central Europe">
</A>
...
and the user selects the upper-leftmost pixel in the image, the chosen
hyperlink has the URL http://host/cgi-bin/imagemap?0,0
The INPUT element — User input field
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ENTITY % InputType "(checkbox|file|hidden|image|
password|radio|reset|submit|text)" >
<!ELEMENT INPUT - O EMPTY >
<!ATTLIST INPUT
CHECKED (checked) #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
MAXLENGTH NUMBER #IMPLIED
NAME CDATA #IMPLIED
SIZE CDATA #IMPLIED
SRC %URL; #IMPLIED
TYPE %InputType; text
VALUE CDATA #IMPLIED
%input.addon; >
Description
The &input; element is used in forms and represents a field for user
input.
The start tag is required, but the end tag shall be omitted.
Attributes
The &a.type; attribute of the &input; element discriminates between
several different types of input field. The set of applicable
attributes depends on the value of the &a.type; attribute as specified
in the following subclauses. By default the value of the &a.type;
attribute is TEXT.
TYPE=CHECKBOX
An &input; element with TYPE=CHECKBOX specifies a boolean choice. A
set of &input; elements in the same &form; element with the same
&a.name; attribute value represents an n-of-many choice.
The other attribute values are as follows:
- CHECKED
- Used to mark the corresponding input item as initially selected.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NAME
- This attribute is required and specifies a name for this &form;
field.
- VALUE
- This attribute is required and specifies the value to be returned
if this input item is selected.
Example:
Which flavours do you like?
<INPUT TYPE=CHECKBOX NAME=flavour VALUE=van CHECKED>Vanilla <BR>
<INPUT TYPE=CHECKBOX NAME=flavour VALUE=str>Strawberry <BR>
<INPUT TYPE=CHECKBOX NAME=flavour VALUE=pec CHECKED>Pecan <BR>
Note that more than one flavour may be checked.
TYPE=FILE
An &input; element with TYPE=FILE provides a means for users to attach
a file to a form's contents. It is typically rendered by a text field
and an associated button which when selected invokes a file browser to
select a file name. The file name can also be entered directly in the
text field. See RFC 1867 for further details .
The other attribute values are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- MAXLENGTH
- The upper limit on the number of characters in the input field.
- NAME
- This attribute is required and specifies a name for this &form; field.
- SIZE
- Prefered size of the visible input line in average character
widths. Users should be able to type more characters than this limit
with the text scrolling through the field to keep the input cursor in
view.
Example:
<FORM ACTION="http://server.rec/cgi/handle"
ENCTYPE="multipart/form-data"
METHOD=post>
What is your name? <INPUT TYPE=TEXT NAME=submitter><BR>
Which file are you sending? <INPUT TYPE=FILE NAME=pics>
</FORM>
The user types "Joe Sixpack" in the name field, and selects an image
file "football.jpeg" for the answer to 'Which file are you sending?'.
TYPE=HIDDEN
An &input; element with TYPE=HIDDEN declares that fields should not be
rendered — they are hidden from the user. The user does not
interact with the field; instead, the &a.value; attribute specifies
the value of the field. The &a.name; and &a.value; attributes are
required, and are returned to the server when the form is submitted.
This input element may be used to handle state information in a form.
The other attribute values are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NAME
- This attribute is required and specifies a name for this &form; field.
- VALUE
- This attribute is required and specifies a value for the field.
Example:
<INPUT TYPE=HIDDEN NAME=customer VALUE="827364">
TYPE=IMAGE
An &input; element with TYPE=IMAGE specifies an image resource to
display. If a point in the image is selected, the x and y coordinates
of that point are returned to the server. The names of the fields
used for returning the x and y pixel coordinates are the specified
name of the field with ".x" and ".y" appended.
TYPE=IMAGE implies TYPE=SUBMIT processing, that is when a pixel is
chosen, the form as a whole is submitted.
The other attribute values are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NAME
- This attribute is required and specifies a name for this &form; field.
- SRC
- This attribute is required and specifies the source of the image.
Example:
Choose a point on the map:
<INPUT TYPE=IMAGE SRC="world.jpeg" NAME=place>
When the user selects a point on the map, say with pixel coordinates
(129,436), the input fields become place.x=129,place.y=436.
See .
TYPE=PASSWORD
An &input; element with TYPE=PASSWORD specifies a single line text
field into which users may type a password. As the user types, the
characters are usually echoed as `*' to hide the password
from prying eyes.
The other attribute values are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- MAXLENGTH
- The upper limit on the number of characters in the input field.
- NAME
- This attribute is required and specifies a name for this &form; field.
- SIZE
- Users should be able to type more characters than this limit
with the password scrolling through the field to keep the input cursor
in view.
Example:
Name: <INPUT NAME=login><>
Password: <INPUT TYPE=PASSWORD SIZE=10 MAXLENGTH=8 NAME=passwd>
TYPE=RADIO
An &input; element with TYPE=RADIO specifies a boolean choice. A set
of &input; elements in a &form; element with the same &a.name;
attribute value represents a 1-of-many choice.
The other attribute values are as follows:
- CHECKED
- Used to mark the corresponding input item as initially selected.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NAME
- This attribute is required and specifies a name for this &form;
field.
- VALUE
- This attribute is required and specifies the value to be returned
if this input item is selected.
At all times one and only one of the radio buttons in a set is
checked. Initially, if none of the &input; elements in a set of radio
buttons specifies CHECKED, then the user agent shall mark the first
radio button of the set as checked.
Example:
Which is your favourite flavour?
<INPUT TYPE=RADIO NAME=flavour VALUE=van>Vanilla <BR>
<INPUT TYPE=RADIO NAME=flavour VALUE=str>Strawberry <BR>
<INPUT TYPE=RADIO NAME=flavour VALUE=pec CHECKED>Pecan <BR>
TYPE=RESET
An &input; element with TYPE=RESET specifies an input option, usually
represented by a button, that instructs the user agent to reset the
form's fields to their initial states.
The other attribute values are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- VALUE
- Indicates a label for the input field.
This value is usually displayed on a button.
Example:
When you are finished, you may submit this request:
<INPUT TYPE=SUBMIT><BR>
You may clear the form and start over at any time:
<INPUT TYPE=RESET VALUE="Reset">
TYPE=SUBMIT
An &input; element with TYPE=SUBMIT represents an input option,
typically a button, that instructs the user agent to submit the form.
The other attribute values are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NAME
- Indicates that this element contributes a form field whose value
is given by the &a.value; attribute. If the &a.name; attribute is not
present, this element does not contribute a form field.
- VALUE
- Indicates a label for the form field.
This value is usually displayed on a button.
Example:
You may submit this request internally:
<INPUT TYPE=SUBMIT NAME=request VALUE=internal>
or externally:
<INPUT TYPE=SUBMIT NAME=request VALUE=external>
TYPE=TEXT
An &input; element with TYPE=TEXT specifies a single line text field
into which users may type a string.
The other attribute values are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- MAXLENGTH
- The upper limit on the number of characters in the input field.
- NAME
- This attribute is required and specifies a name for this &form; field.
- SIZE
- Prefered size of the visible input line in average character
widths. Users should be able to type more than this limit with the
text scrolling through the field to keep the input cursor in view.
- VALUE
- This attribute is required and specifies an initial value for the
text string initially shown in the field.
Example:
<INPUT TYPE=TEXT SIZE=40 NAME=user
VALUE="Intentionally left blank">
Example
For examples of the use of the &input; element, please see subclauses
, ,
, ,
, ,
, and
.
The ISINDEX element — Keyword choice
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT ISINDEX - O EMPTY>
<!ATTLIST ISINDEX
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
PROMPT CDATA #IMPLIED
%isindex.addon; >
Description
The &isindex; element implies a set of hyperlinks. A user agent
enables users to choose from this set by providing keywords.
User agents compute target URLs by appending the character
`?' and the selected keywords to the base URL. Keywords
are escaped according to RFC 1738 and joined
together by the character `+'.
&form; elements with &a.method;=get also represent sets of
hyperlinks. See clause for details.
The start tag is required, but the end tag shall be omitted.
Attributes
The &isindex; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- PROMPT
- A text which encourages a user to make a choice.
Example
If a document &head; element contains:
<BASE HREF="http://host/index">
<ISINDEX>
and a user selects the keywords apple and
berry, then the user agent will access the resource
http://host/index?apple+berry
The ISO-HTML element — Document instance
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT ISO-HTML - - (HEAD, BODY) >
<!ATTLIST ISO-HTML
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
VERSION CDATA #FIXED "&version;"
%iso-html.addon; >
Description
The &iso-html; element contains a document instance marked up in the
language specified by this &text;.
Both start and end tags are required.
Attributes
The &iso-html; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- VERSION
- The &a.version; attribute of the &iso-html; document element may
be omitted, but if specified shall have the value
&version;.
Example
<ISO-HTML>
<HEAD>
<TITLE>Scientific Units</TITLE>
... other head elements
</HEAD>
<BODY>
<H1>Scientific units and their conversions<H1>
... document body
</BODY>
</ISO-HTML>
The KBD element — Keyboard input
Formal definition
<!ENTITY % logical.styles "... | KBD | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The &kbd; element contains text to be typed by a user.
Both start and end tags are required.
Attributes
The &kbd; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
At the prompt, you might try typing:
<KBD>rm -rf *</KBD>
The LI element — List item
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT LI - O %section.content; >
<!ATTLIST LI
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
VALUE NUMBER #IMPLIED
%li.addon; >
Description
The &li; element contains a list item in an ordered list or an unordered list .
The start tag is required, but the end tag may be omitted.
Attributes
The &li; element has the following attributes:
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- VALUE
- This attribute is optional and shall only be used in ordered lists.
It provides an integer number for the ordered list item and
re-sequences the numbering of the items in the ordered list.
Example
See and for
examples of the use of the &li; element.
The LINK element — Interdocument relations
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT LINK - O EMPTY >
<!ATTLIST LINK
CHARSET NAME #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
HREF %URL; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
REL CDATA #IMPLIED
REV CDATA #IMPLIED
TITLE CDATA #IMPLIED
%link.addon; >
Description
The &link; element provides a means for specifying relationships
between this hypertext document and other documents and resources.
Any number of &link; elements may appear in the head of a document and
are typically used to indicate authorship, related indexes and
glossaries, older and more recent versions, document hierarchy and
associated resources such as style sheets.
The start tag is required, but the end tag shall be omitted.
Attributes
The &link; element has the following attributes:
- CHARSET
- Please see the &a.charset; attribute of the &a; element
.
- CLASS
- Please see .
- DIR
- Please see .
- HREF
- Please see the &a.href; attribute of the &a; element.
- ID
- Please see .
- LANG
- Please see .
- REL
- Please see the &a.rel; attribute of the &a; element.
- REV
- Please see the &a.rev; attribute of the &a; element.
- TITLE
- Please see the &a.title; attribute of the &a; element.
Example
See for an example of the use of the
&link; element.
The MAP element — Client-side image map
Formal definition
<!ELEMENT MAP - - (AREA)+ >
<!ATTLIST MAP
NAME CDATA #REQUIRED
%map.addon; >
Description
The &e.map; element provides a mechanism for constructing client-side
image maps. It acts as a container for a set of &area; elements which
define individual regions in an image .
Within a &e.map; careful attention should be given to the ordering of
the &area; elements: If two or more regions overlap, then the first
&area; element listed will take precedence over subsequent &area;
elements, etc. Thus &area; elements with no associated action
(which have the &a.nohref; attribute), should be specified in the
&e.map;
before &area;s defining hotzones (which have the &a.href; attribute).
Both start and end tags are required.
Attributes
The &e.map; element has the following attribute:
- NAME
- This required attribute specifies a name for the map which may be
referenced by the &a.usemap; attribute of an &img; element using a URL
fragment identifier .
The value of the &a.name; attribute is case sensitive.
Example
<IMG SRC="USA.jpeg" USEMAP="#States">
...
<MAP NAME="States">
...
<AREA HREF="Florida.html" ALT="Florida"
SHAPE=poly COORDS="...">
...
<AREA HREF="Texas.html" ALT="Texas"
SHAPE=poly COORDS="...">
...
</MAP>
The META element
Formal definition
<!ELEMENT META - O EMPTY >
<!ATTLIST META
CONTENT CDATA #REQUIRED
HTTP-EQUIV NAME #IMPLIED
NAME NAME #IMPLIED
%meta.addon; >
Description
The &meta; element is an extensible container for use in identifying
specialized document meta-information. Meta-information has two main
functions:
- To provide a means to verify that the data set exists, and
determine how it might be obtained or accessed.
- To document the content, quality and features of a data set,
indicating its fitness for use.
Each &meta; element specifies a name/value pair. If multiple &meta;
elements are provided with the same name, their combined contents
— concatenated as a comma-separated list — is the value
that will be associated with that name.
The &meta; element should not be used where a specific element,
such as &title;, would be more appropriate. Rather than specifying a
&meta; element with a URL as the value of the &a.content; attribute,
use a &link; element instead.
HTTP servers may read the content of a document's &head; element to
generate header fields corresponding to those elements defining a value
for the attribute &a.http-equiv;
The method by which the server extracts document meta-information is
unspecified and not mandatory. The &meta; element only provides an
extensible mechanism for identifying and embedding such document
meta-information — how it may be used is up to the individual
server implementation and ISO-HTML user agent.
An HTTP server shall not use the &meta; element to form an HTTP
response header unless the &a.http-equiv; attribute is present.
An HTTP server may disregard any &meta; elements that specify
information controlled by the HTTP server, for example `Server',
`Date', and `Last-modified'.
The start tag is required, but the end tag shall be omitted.
Attributes
The attributes of the &meta; element are:
- CONTENT
- This attribute is required and specifies the value part of a
name/value pair.
- HTTP-EQUIV
- Binds the element to an HTTP header field. An HTTP server may use
this information to process the document. In particular, it may
include a header field in the responses to requests for this document:
the header name is taken from the &a.http-equiv; attribute value, and
the header value is taken from the value of the &a.content; attribute.
HTTP header names are not case sensitive.
- NAME
- Specifies the name part of the name/value pair. If not present,
then the &a.http-equiv; attribute is used to specify the name.
Either the &a.http-equiv; or the &a.name; attribute shall be present.
Example
If a document contains:
<META HTTP-EQUIV="Expires"
CONTENT="Sat, 1 Jan 2000 00:00:01 UTC">
<META HTTP-EQUIV="Keywords" CONTENT="Fred">
<META HTTP-EQUIV="Reply-to"
CONTENT="Flinstones@bedrock.old">
<META HTTP-EQUIV="Keywords" CONTENT="Barney">
then the server may include the following header fields:
Expires: Sat, 1 Jan 2000 00:00:01 UTC
Keywords: Fred, Barney
Reply-to: Flintstones@bedrock.old
as part of an HTTP response to a `get' or `post' request for that
document.
The NOP element — Interface default value
Formal definition
<!ELEMENT NOP - O EMPTY >
Description
The &nop; element has no content and no meaning. It shall be
ignored by user agents, and shall not be used in conforming documents.
The &nop; element is used in the DTD to ensure syntactically correct
content models for unused interfaces.
Attributes
The &nop; element has no attributes.
The OBJECT element — Simple agent
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT OBJECT - - (PARAM | %section.content;)* >
<!ATTLIST OBJECT
ALIGN (texttop,middle,textmiddle,baseline,
textbottom,left,center,centre,right)
#IMPLIED
CLASS NAMES #IMPLIED
CLASSID %URL; #IMPLIED
CODEBASE %URL; #IMPLIED
CODETYPE CDATA #IMPLIED
DATA %URL; #IMPLIED
DECLARE (declare) #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
NAME %URL; #IMPLIED
STANDBY CDATA #IMPLIED
TYPE CDATA #IMPLIED
USEMAP %URL; #IMPLIED
%object.addon; >
&NB;
The &a.name; attribute is declared as having type %URL;.
Is this correct? [Dix points].
Description
The &object; element provides a technique for specifying richer
behaviour for the document in the form of a simple agent. The scheme
uses only elements and attributes and is simple to implement.
This technique deliberately avoids using sophisticated SGML techniques
in order to facilitate its use by current user agents. Nothing in
this &text; prevents the use of those SGML techniques by more
sophisticated user agents.
The specification of the &object; element supports the general
insertion of media other than text into documents, but excludes the
agent architecture, application programming interface (API) and
inter-agent communication.
The agent may access data specified:
- In the document text flow,
- As a set of named properties,
- In a separate file which is the target of a link specified
within the document,
- Using techniques outside the scope of this &text;.
A conforming ISO-HTML browser is not required to support the agent
behaviour, and if it does not it shall render the
%section.content; part of the content. Browsers which
render the agent behaviour shall not render the
%section.content;. If a browser chooses to render the
%section.content;, then it may also display the content
of the &a.alt; attribute to indicate that this choice has been made.
It is recommended that authors provide a suitable substitute for the
agent behaviour in the %section.content; part of the
content of the element.
The agents are normally loaded relative to the document URL (or &base;
element if it is defined), and the &a.codebase; attribute may be used
to change this default behaviour. If the &a.codebase; attribute is
defined, then it specifies a different location for the agent
resources. The value can be an absolute or relative URL. An absolute
URL is used as is without modification and is not effected by a
document's &base; element. When the &a.codebase; attribute is
relative, then it is relative to the document URL (or &base; tag if
defined).
Both start and end tags are required.
Attributes
The &object; element has the following attributes:
- ALIGN
- Please see .
- CLASS
- Please see .
- CLASSID
- Provides a URL which identifies an implementation for the agent.
In some systems the value is a class identifier. The values are not
defined by this &text;. If this attribute is omitted, a default value
may be deduced from the &a.data; attribute value.
Since the class identifiers in some object systems may be cumbersome,
the &a.classid; attribute may use a short URL to specify a class
identifier indirectly.
- CODEBASE
- Some URL schemes used to identify implementations require an additional
URL to locate the implementation. This attribute provides the additional URL.
The values are not defined by this &text;.
- CODETYPE
- The Internet media type of the code referenced by the &a.classid;
attribute.
- DATA
- Provides a URL for the agent's data, eg. a JPEG file. The
&a.type; attribute may provide the Internet Media Type for the data.
In the absence of the &a.classid; attribute, the Internet Media Type
of the data gives the default value to the &a.classid; attribute.
- DECLARE
- The &a.declare; attribute calls for late binding of the agent.
The attribute is usually used to indicate that
- ¶m; elements are to be "object valued".
- Hyperlinks point to objects which cannot otherwise be addressed
with a single URL.
Each such binding typically results in a separate instantiation of the
agent. <OBJECT DECLARE> is treated as a declaration for
making an instance of the agent.
If the declared agent is not supported, the user agent should use the
content of the <OBJECT DECLARE> element which may
contain another &object; element. The &a.type; attribute may be used
to specify the Internet Media Type for the outer agent as a hint for
this situation.
Anchors may exploit nested declared agents to provide alternative media
for a given resource.
&NB;
This explanation of the &a.declare; attribute is based on text that
came from the W3C. It needs further work and some good examples.
- DIR
- Please see .
- ID
- Please see . The &a.id; attribute
is also available to assist inter agent communication.
- LANG
- Please see .
- NAME
- If the &a.name; attribute is present and if the &object; element
is contained in a &form; element, then this agent participates in the
form submission process. If &a.name; is present and the &a.declare;
attribute is absent, the user agent should include the value of the
&a.name; attribute and the data obtained from the agent along with
information derived from other form fields, see
.
The mechanism used to obtain an agent's data is specific to each
agent.
- STANDBY
- The attribute value provides a message to be displayed while
the agent is being prepared.
- TYPE
- The Internet Media Type of the data referenced through use of
the &a.data; attribute.
- USEMAP
- Specifies a URL fragment identifier for a client-side image map
defined with the &e.map; element, see .
In general, the use of this attribute is only appropriate for static
images.
Examples
&NB;
Good examples are urgently needed.
The OL element — Ordered list
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (OL|UL) - - (LI)+ >
<!ATTLIST OL
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
COMPACT (compact) #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
START NUMBER #IMPLIED
%ol.addon; >
Description
The &ol; element represents a non empty ordered list of items,
presented in sequence or order of importance. It is usually rendered
as a numbered list.
The content is a sequence of &li; elements .
Both start and end tags are required.
Attributes
The attributes of the &ol; element are as follows:
- ALIGN
- Please see .
- CLASS
- Please see .
- COMPACT
- The optional &a.compact; attribute suggests that a compact
rendering be used, perhaps because the list items are small, or the
entire list is large. Unless the &a.compact; attribute is present, a
user agent may leave white space between successive &li; elements.
It is recommended that authors and authoring systems make use of the
permitted omission of the attribute name, see ISO 8879:1986 subclause
7.9.1.2 [Goldfarb p.329 and p.70 line 20]. This will facilitate the use
of historic browsers.
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- START
- Specifies an initial value for the item sequence number. If the
&a.start; attribute is omitted, the default start value is 1. If
specified, the value shall be an integer.
Example
Easter Calendar
<OL START=1997>
<LI>30th March
<LI>12th April
<LI>4th April
<LI>23rd April
</OL>
The OPTION element — User choice
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT OPTION - O (#PCDATA) >
<!ATTLIST OPTION
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
SELECTED (selected) #IMPLIED
VALUE CDATA #IMPLIED
%option.addon; >
Description
The &option; element can only occur within a &select; element and
represents one of the possible choices that is offered. The content
of the &option; element is presented to users as a representation of
the option. Its content is used as the returned value if the
&a.value; attribute is not present.
The start tag is required, but the end tag may be omitted.
Attributes
The attributes of the &option; element are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- SELECTED
- Indicates that the option is initially selected.
- VALUE
- Indicates the value to be returned if this option is chosen. If
omitted, the returned value defaults to the content of the &option;
element.
The name associated with this value is given by the &a.name; attribute
of the parent &select; element.
Example
See for an example of the use of the
&option; element.
The P element — Paragraph
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT P - O (%text;)+ >
<!ATTLIST P
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%p.addon; >
Description
The contents of the &p; element form a paragraph.
Authors often start paragraphs on new lines to facilitate document
maintenance.
The start tag is required, but the end tag may be omitted.
Attributes
The &p; element has the following attributes:
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<P>
It was a dark and stormy night ...
The PARAM element — Agent interface parameter
Formal definition
<!ELEMENT PARAM - O EMPTY>
<!ATTLIST PARAM
NAME NAME #REQUIRED
TYPE CDATA #IMPLIED
VALUE CDATA #IMPLIED
VALUETYPE
(data|ref|object) data
%param.addon; >
Description
The ¶m; element appears only in &object; element content and
specifies the name and value of a parameter to be passed to the
agent . The ¶m; element has no
content.
The start tag is required, but the end tag shall be omitted.
Attributes
The ¶m; element has the following attributes:
- NAME
- This attribute is required and specifies the name of the parameter.
Case sensitivity is implementation dependent.
- TYPE
- This attribute is used only when the &a.valuetype; attribute has
the value "ref" and specifies the Internet Media Type of the
referenced value.
- VALUE
- Specifies the value of the parameter.
For example: VALUE="expensive".
- VALUETYPE
- Specifies how the &a.value; attribute is to be interpreted.
Possible values are as follows:
- VALUETYPE=data
- The value "expensive" is to be passed directly to the agent as a
string. In the absence of a &a.valuetype; attribute, "data" is the
default behaviour for the &a.valuetype; attribute.
- VALUETYPE=object
- The value "expensive" is treated as the URL of an object or agent
in the same document. This is used primarily for object or agent
valued properties where the value of a property is a pointer (or
reference) to a running object or to an agent.
- VALUETYPE=ref
- The value "expensive" is a URL.
The attribute value is obtained from the attribute value literal after
replacing any entity references or character references within the
literal and then normalizing the result by throwing out any entity
ends and record starts and replacing any record end or separator
characters with a space [see Goldfarb p.331].
Example
See for an example of the use of the
¶m; element.
The PRE element — Pre-formatted text
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT PRE - - (%text;)+
-(BIG|IMG|MAP|SMALL|SUB|SUP|%body.extend;) >
<!ATTLIST PRE
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
WIDTH NUMBER #IMPLIED
%pre.addon; >
Description
The &e.pre; element contains a non-empty block of text that is to be
formatted as is, with its contents rendered in a mono-spaced font.
Within pre-formatted text, line breaks are rendered faithfully as line
breaks. A user agent may use a constant indent when rendering
pre-formatted text.
Anchor elements and phrase markup may be embedded in pre-formatted text.
Constraints on the processing of &e.pre; element content may limit the
ability of a user agent to faithfully render phrase markup.
Both start and end tags are required.
Attributes
The &e.pre; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- WIDTH
- Specifies the maximum number of characters in a line and allows
a user agent to select a suitable font and indentation. The value
of this attribute shall be a strictly positive integer.
Example
<PRE WIDTH=16>
Tic Tac Toe
X | | O
-----------
O | X |
-----------
| | X
</PRE>
The Q element — Quote
Formal definition
<!ENTITY % logical.styles "... | Q | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The &q; element contains a quotation. Rendering is usually language
and platform dependent.
Both start and end tags are required.
Attributes
The &q; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
A <Q LANG=de>quotation in German</Q>
and a <Q LANG=fr>quotation in French</Q>.
might be rendered as:
A ,,quotation in German'' and a << quotation in French >>.
The SAMP element — Sample output
Formal definition
<!ENTITY % logical.styles "... | SAMP | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The &samp; element contains sample output from a program or a script.
Both start and end tags are required.
Attributes
The &samp; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
The installation begins:
<samp>Insert diskette 1</samp>
The SELECT element — Selection in forms
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT SELECT - - (OPTION)+ >
<!ATTLIST SELECT
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
MULTIPLE (multiple) #IMPLIED
NAME CDATA #REQUIRED
SIZE NUMBER #IMPLIED
%select.addon; >
Description
The &select; element defines one-from-many and many-from-many menus.
The items from which the choice is made are defined by a sequence of
&option; elements.
At least one &option; shall be specified in a &select; element.
One-from-many menus are usually rendered as drop-down menus while
many-from-many menus are usually rendered as list menus.
The initial state has the first option selected, unless a &a.selected;
attribute is present on at least one of the &option; elements .
Both start and end tags are required.
Attributes
The &select; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- MULTIPLE
- The presence of this attribute signifies that the users can make
multiple selections. If this attribute is omitted, at most one selection
is allowed.
It is recommended that authors and authoring systems make use of the
permitted omission of the attribute name, see ISO 8879:1986 subclause
7.9.1.2 [Goldfarb p.329 and p.70 line 20]. This will facilitate the use
of historic browsers.
- NAME
- Specifies the name used to identify the menu choice when the form
is submitted to a server. Each selected option results in a
name/pair value being included in the form's contents. This attribute
is required.
- SIZE
- Suggests the number of visible choices.
Example
<SELECT NAME="flavour">
<OPTION>Vanilla
<OPTION SELECTED>Chocolate
<OPTION VALUE="LemonLime">Lemon and Lime
<OPTION>Strawberry
</SELECT>
The SMALL element — Small character style
Formal definition
<!ENTITY % physical.styles "... | SMALL | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
The contents of a &small; element should be rendered in a smaller
font than would otherwise be used.
Both start and end tags are required.
Attributes
The &small; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<BIG>What the large print giveth,</BIG>
<SMALL>the small print taketh away.</SMALL>
The SPAN element — Generic container
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT SPAN - - (%text;)+ >
<!ATTLIST SPAN
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%span.addon >
Description
The &span; element provides a generic container to carry language
and bidirectional attributes in cases where no other element is
appropriate.
Both start and end tags are required.
Attributes
The optional attributes of the &span; element are as follows:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
The licence plate <SPAN DIR=ltr>CIA 1</SPAN> will appear
correctly even if cut and pasted into the source of a report normally
rendered in a right-to-left fashion.
The STRIKE element — Strike-out character style
Formal definition
<!ENTITY % physical.styles "... | STRIKE | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
The contents of a &strike; element should be rendered in a
"strike-through" text style if available, otherwise an alternative
representation may be used.
Both start and end tags are required.
Attributes
The &strike; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
The original description should <STRIKE>NOT</STRIKE> have been
omitted.
The STRONG element — Strong emphasis
Formal definition
<!ENTITY % logical.styles "... | STRONG | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The contents of a &strong; element are strongly emphasised and are
usually rendered in a bold font.
Both start and end tags are required.
Attributes
The &strong; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
<EM>High Voltage <STRONG>Danger</STRONG></EM>
The SUB element — Subscript character style
Formal definition
<!ENTITY % physical.styles "... | SUB | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
A &e.sub; element contains subscripted text. Its contents should be
positioned below the base line and rendered in a smaller size than the
preceding text.
Both start and end tags are required.
Attributes
The &e.sub; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
H<SUB>2</SUB>O
The SUP element — Superscript character style
Formal definition
<!ENTITY % physical.styles "... | SUP | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
A &e.sup; element contains superscripted text. Its contents should be
positioned above the base line and rendered in a smaller size than the
preceding text.
Both start and end tags are required.
Attributes
The &e.sup; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
E = mc<SUP>2</SUP>
The TABLE element — Tables
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT TABLE - - (CAPTION?, TR+) >
<!ATTLIST TABLE
ALIGN (left,center,centre,right) left
BORDER %pixels; #IMPLIED
CELLPADDING %pixels; #IMPLIED
CELLSPACING %pixels; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
DUMMY (border) #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
WIDTH %length; #IMPLIED
%table.addon; >
Description
The &table; element provides a widely deployed subset of the
specification given in RFC 1942 . It is used to
- Markup tabular material.
- Describe tabular layout.
Authors should be aware that this latter use causes problems
when rendering to speech or text-only agents.
A table contains an optional caption
followed by a non-empty sequence of table rows .
Both start and end tags are required.
Attributes
The attributes of the &table; element are as follows:
The pixel values refer to screen pixels, and should be multiplied by
an appropriate factor when rendering to high resolution output devices
such as laser printers. For instance if a user agent has a display
with 75 pixels per inch and is rendering to a laser printer with 600
dots per inch, then the pixel values given in the attributes should be
multiplied by a factor of 8 prior to output.
- ALIGN
- Please see .
- BORDER
- Specifies the width of the outer border around a table in screen
pixels, eg. &a.border;=4. The border may be suppressed by setting
&a.border;=0. If both this attribute and the attribute &a.dummy; are
omitted, the border should be suppressed.
- CELLPADDING
- Specifies the padding in screen pixels between a cell's contents
and the border around the cell.
- CELLSPACING
- Each cell in a table has its own border which is separated from
the borders around neighbouring cells. This separation can be set
using the &a.cellspacing; attribute, eg. &a.cellspacing;=10 for a 10
pixel separation. This attribute also determines the separation
between the table border and the borders of the outermost cells.
In traditional desktop publishing software, adjacent table cells share
a common border.
- CLASS
- Please see .
- DIR
- Please see .
- DUMMY
- Allows an author to specify the attribute value BORDER as if it
were an attribute name with no associated value. Such a specification
requests that the border be drawn using the user agent's default
width, usually one pixel.
It is recommended that authors and authoring systems make use of the
permitted omission of the attribute name, see ISO 8879:1986 subclause
7.9.1.2 [Goldfarb p.329 and p.70 line 20]. This will facilitate the use
of historic browsers.
- ID
- Please see .
- LANG
- Please see .
- WIDTH
- Sets the table width. If an integer is specified, the unit is the
screen pixel, eg. &a.width;=212, but if a percentage is specified by
concatenating a "%" character as a suffix to the value, the table
width is defined as a percentage of the space between the current left
and right margins, eg. &a.width="80%".
If this attribute is omitted, the table width is automatically
determined from the table contents.
Example
Tables take the general form:
<TABLE BORDER=3 WIDTH="64%"
CELLSPACING=2 CELLPADDING=2>
<CAPTION>Complexity of sorting algorithms</CAPTION>
<TR><TH> Algorithm <TH> Complexity
<TR><TD> Random shuffle <TD> O(exp(N))
<TR><TD> Bubble sort <TD> O(NxN)
<TR><TD> Quicksort <TD> O(NlogN)
<TR><TD> Heap sort <TD> O(NlogN)
</TABLE>
The TD element — Table data cell
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ENTITY % valign "(top|middle|bottom|baseline)" >
<!ELEMENT (TH|TD) - O %table.content; >
<!ATTLIST ( ... | TD )
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
COLSPAN NUMBER 1
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
NOWRAP (nowrap) #IMPLIED
ROWSPAN NUMBER 1
VALIGN %valign; #IMPLIED
%td.addon; >
Description
The &td; element is found only in &tr; table rows and contains a data cell in a table.
The start tag is required, but the end tag may be omitted.
Attributes
The attributes of the &td; element are as follows:
- ALIGN
- Please see .
- CLASS
- Please see .
- COLSPAN
- Specifies the number of columns spanned by this cell. The value is a
strictly positive integer, and if not specified, defaults to 1.
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NOWRAP
- The presence of this attribute disables automatic word wrap within
the contents of the cell.
It is recommended that authors and authoring systems make use of the
permitted omission of the attribute name, see ISO 8879:1986 subclause
7.9.1.2 [Goldfarb p.329 and p.70 line 20]. This will facilitate the use
of historic browsers.
This is equivalent to using the entity for non-breaking
spaces within the content of the cell.
- ROWSPAN
- Specifies the number of rows spanned by this cell. The value is a
strictly positive integer, and if not specified, defaults to 1.
- VALIGN
- Specifies a default vertical alignment for cell contents which
overrides any value specified by the containing &tr; element . The permitted values are "top", "middle",
"bottom" and "baseline". If not specified, the default vertical
alignment is "middle", unless overridden by the containing &tr;
element. The meanings of the permitted values are the same as those
described for the &a.align; attribute in .
A table cell may contain a nested table.
Example
See for an example of the use of the &td;
element.
The TEXTAREA element — Multi-line text field
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT TEXTAREA - - (#PCDATA) >
<!ATTLIST TEXTAREA
CLASS NAMES #IMPLIED
COLS NUMBER #REQUIRED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
NAME CDATA #REQUIRED
ROWS NUMBER #REQUIRED
%textarea.addon; >
Description
The &textarea; element is used in forms to represent the initial value
of a multi-line text field which may be modified by a user. Its
contents are restricted to text and character entities.
It is recommended that user agents canonicalize line endings to CRLF
when submitting a field's contents to a server.
This &text; does not specify the coded character set to be used for
submitting such text to a server.
The field is usually rendered in a mono-spaced font.
Both start and end tags are required.
Attributes
The attributes of the &textarea; element are:
- CLASS
- Please see .
- COLS
- This required attribute specifies the prefered width of the field
in visible mono-spaced characters. Users should be able to enter
longer lines than this, so user agents should provide a means for
scrolling through the text field when its contents extend beyond the
visible area. User agents may wrap visible text lines to keep long
lines visible without the need for scrolling.
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NAME
- This required attribute specifies the name that is used to
identify the field when the form is submitted to a server.
- ROWS
- This required attribute specifies the number of visible text
lines. Users should be able to enter more lines that this, so user
agents should provide some means for scrolling through the text field
when its contents extend beyond the visible area.
Example
<TEXTAREA NAME=comments ROWS=3 COLS=32>
I found that your product was excellent!
</TEXTAREA>
The TH element — Table header
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ENTITY % valign "(top|middle|bottom|baseline)" >
<!ELEMENT (TH|TD) - O %table.content; >
<!ATTLIST ( TH | ... )
ALIGN %justify;#IMPLIED
CLASS NAMES #IMPLIED
COLSPAN NUMBER 1
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
NOWRAP (nowrap) #IMPLIED
ROWSPAN NUMBER 1
VALIGN %valign; #IMPLIED
%th.addon; >
Description
The &th; element is found only in &tr; table rows and contains a header cell in a table. &th; elements are
distinguished from &td; elements so that a user agent may provide
different rendering styles for cell header and cell data.
&th; is otherwise identical to &td; except that if the &a.align;
attribute is not specified, the default alignment is "centre" unless
overridden by the enclosing &tr; element.
The start tag is required, but the end tag may be omitted.
Attributes
The &th; element has the following attributes:
- ALIGN
- Please see for a general
description. This use of the &a.align; attribute differs only in that
the default value "centre" is to be used if none is supplied.
- CLASS
- Please see .
- COLSPAN
- Specifies the number of columns spanned by this cell. The value is a
strictly positive integer, and if not specified, defaults to 1.
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- NOWRAP
- The presence of this attribute disables automatic word wrap within
the contents of the cell.
This is equivalent to using the entity for non-breaking
spaces within the content of the cell.
It is recommended that authors and authoring systems make use of the
permitted omission of the attribute name, see ISO 8879:1986 subclause
7.9.1.2 [Goldfarb p.329 and p.70 line 20]. This will facilitate the use
of historic browsers.
- ROWSPAN
- Specifies the number of rows spanned by this cell. The value is a
strictly positive integer, and if not specified, defaults to 1.
- VALIGN
- Specifies a default vertical alignment for cell contents which
overrides any value specified by the containing &tr; element. The permitted values are "top", "middle", "bottom"
and "baseline". If not specified, the default vertical alignment is
"middle", unless overridden by the containing &tr; element. The
meanings of the permitted values are the same as those described for
the &a.align; attribute in .
Example
See for an example of the use of the &th;
element.
The TITLE element — Document title
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT TITLE - - (#PCDATA)
-(LINK | META | %head.extend;) >
<!ATTLIST TITLE
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%title.addon; >
&NB;
Shouldn't the content model be replaced by RCDATA?
Description
The &title; element identifies the contents of a document in a
global context. A short title such as "Introduction" may be
meaningless out of context, and hence a title such as "Introduction to
medieval bee-keeping" might be more appropriate.
The length of a title is not limited; however long titles may be
truncated in some applications. To minimize this possibility titles
should contain fewer than 64 characters.
An ISO-HTML document shall contain one &title; element.
A user agent may display the title of a document in a history list or
as a label for the window displaying the document's content.
Both start and end tags are required.
Attributes
The &title; element has the following attributes:
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
See for an example of the use of the
&title; element.
The TR element — Table row
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ENTITY % valign "(top|middle|bottom|baseline)" >
<!ELEMENT TR - O (TH|TD)+ >
<!ATTLIST TR
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
VALIGN %valign; #IMPLIED
%tr.addon; >
Description
The &tr; is found only in a &table; element and specifies a non-empty row in a table. It acts as a
container for &th; table header and &td;
table data elements.
The start tag is required, but the end tag may be omitted.
Attributes
The &tr; element has the following attributes:
- ALIGN
- Please see .
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
- VALIGN
- Specifies a default vertical alignment for cell contents. The
permitted values are "top", "middle", "bottom" and "baseline". If not
specified, the default vertical alignment is "middle". The meanings
of the permitted values are the same as those described for the
&a.align; attribute in .
Example
See for an example of the use of the &tr;
element.
The TT element — Mono-spaced character style
Formal definition
<!ENTITY % physical.styles "... | TT | ..." >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
The contents of a &tt; element should be rendered in a mono-spaced
font.
Both start and end tags are required.
Attributes
The &tt; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
The telex began: <TT LANG=fr>CONFIDENTIEL</TT>
The U element — Underlined character style
Formal definition
<!ENTITY % physical.styles "... | U" >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (%physical.styles;|...) - - (%text;)+ >
<!ATTLIST (%physical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%physical.style.addon; >
Description
The contents of an &u; element should be rendered in an underlined
text style if available, otherwise an alternative representation
may be used.
Both start and end tags are required.
Attributes
The &u; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
Browsers frequently <U>underline</U> the text associated with a link.
The UL element — Unordered list
Formal definition
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (OL|UL) - - (LI)+ >
<!ATTLIST UL
ALIGN %justify; #IMPLIED
CLASS NAMES #IMPLIED
COMPACT (compact) #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%ul.addon; >
Description
The &ul; element represents a non empty unordered list of items usually
rendered as a bulleted sequence.
The content is a sequence
of &li; elements .
Both start and end tags are required.
Attributes
The attributes of the &ul; element are as follows:
- ALIGN
- Please see .
- CLASS
- Please see .
- COMPACT
- The optional &a.compact; attribute suggests that a compact
rendering be used, perhaps because the list items are small, or the
entire list is large. Unless the &a.compact; attribute is present, a
user agent may leave white space between successive &li; elements.
It is recommended that authors and authoring systems make use of the
permitted omission of the attribute name, see ISO 8879:1986 subclause
7.9.1.2 [Goldfarb p.329 and p.70 line 20]. This will facilitate the use
of historic browsers.
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
&NB;
Full details to be provided by Italian NB.
<P LANG=it>Gelati
<UL>
<LI>Vanilla
<LI>Chocolate
<LI>Strawberry
</UL>
The VAR element — Generic variable
Formal definition
<!ENTITY % logical.styles "... | VAR" >
<!ENTITY % dirn "(ltr|rtl)" >
<!ELEMENT (...|%logical.styles;) - - (%text;)+ >
<!ATTLIST (%logical.styles;)
CLASS NAMES #IMPLIED
DIR %dirn; #IMPLIED
ID ID #IMPLIED
LANG NAME #IMPLIED
%logical.style.addon; >
Description
The &var; element contains a placeholder variable, usually rendered
in italic.
Both start and end tags are required.
Attributes
The &var; element has the following attributes.
- CLASS
- Please see .
- DIR
- Please see .
- ID
- Please see .
- LANG
- Please see .
Example
Type
<CODE>rm <VAR>file</VAR></CODE>
to delete <VAR>file</VAR> from directory.
Formal definitions
These formal definitions are not intended to be self documenting. The
elements and attributes are described in the body of this &text;.
The SGML techniques are described in .
The SGML declaration
iso-html.dcl
The entity set
iso-html.ent
The elements and attributes
iso-html.dtd
Sample marked up documents
&NB;
Sample documents will not be provided until any corrections resulting
from the CD balloting process have been folded into the text.
Bibliography
GrimesBarbara F.
Ethnologue, Languages of the World
12th
Dallas
Summer Institute of Linguistics
1992
ISBN xxxxxxxxxxx
NebelErnesto
MasinterLarry
Form-based File Upload in HTML
URL:ftp://ds.internic.net/rfc/rfc1867.txt
Internet Engineering Task Force
Novenber 1994
RFC 1867
GoldfarbCharles F.
The SGML Handbook
1st
Oxford
Oxford University Press
1990
ISBN 0-19-853737-9
Berners-LeeTim
Connolly>Daniel
Hypertext Markup Language — 2.0
URL:ftp://ds.internic.net/rfc/rfc1866.txt
Internet Engineering Task Force
1995
RFC 1866
RaggettDave
HTML 3.2 Reference Specification REC-html32
URL:http://www.w3.org/pub/WWW/TR
World-Wide Web Consortium
1997
FieldingRoy T.
GettysJim
MogulJeffrey C.
NielsenHenrik Frystyk
Berners-LeeTim
Hypertext Transfer Protocol — HTTP/1.1
URL:ftp://ds.internic.net/rfc/rfc2068.txt
Internet Engineering Task Force
1997
RFC 2068
BorensteinN.
FreedN.
MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms
for Specifying and Describing the Format of Internet Message Bodies.
URL:ftp://ds.internic.net/rfc/rfc1521.txt
Internet Engineering Task Force
September 1993
RFC 1521
RaggetDave
KindelCharlie
MontulliLou
SinkEric
GramlichWayne
HirschmanJonathan
Berners-LeeTim
ConnollyDan
Inserting objects into HTML, work in progress
URL:http://www.w3.org/pub/WWW/TR/WD-object.html
World Wide Web Consortium
1996
WD-object-960422
FieldingRoy T.
Relative Uniform Resource Locators
URL:ftp://ds.internic.net/rfc/rfc1808.txt
Internet Engineering Task Force
June 1995
RFC 1808
YergeauFrançois
NicolGavin
AdamsGlenn
DürstMartin
Internationalization of the Hypertext Markup Language
URL:ftp://ds.internic.net/rfc/rfc2070.txt
Internet Engineering Task Force
January 1997
RFC 2070
ReynoldsJ
PostelJon
Assigned Numbers
URL:ftp://ds.internic.net/rfc/rfc1700.txt
Internet Engineering Task Force
October 1994
RFC 1700
AlverstrandH
Tags for the Identification of languages
URL:ftp://ds.internic.net/rfc/rfc1766.txt
Internet Engineering Task Force
March 1995
RFC 1766