<contents>

Module
Attributes
analog, class, copyof, corresp, follows, label, n, next, precedes, prev, resp, sameas, synch, target, targettype, type, xlink:actuate, xlink:role, xlink:show, xml:base, xml:id
analog(optional)Contains a reference to a field or element in another descriptive encoding system to which this MEI element is comparable. Value is plain text.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
target(optional)Identifies passive participants in a relationship; that is, the entities pointed "to". One or more values from data.URI, separated by spaces.
targettype(optional)Characterization of target resource(s) using any convenient classification scheme or typology. Value is a NMTOKEN.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
xlink:actuate(optional)Defines whether a link occurs automatically or must be requested by the user. Allowed values are: "onLoad" (Load the target resource(s) immediately.), "onRequest" (Load the target resource(s) upon user request.), "none" (Do not permit loading of the target resource(s).), "other" (Behavior other than allowed by the other values of this attribute.)
xlink:role(optional)Characterization of the relationship between resources. The value of the role attribute must be a URI. Value conforms to data.URI.
xlink:show(optional)Defines how a remote resource is rendered. Allowed values are: "new" (Open in a new window.), "replace" (Load the referenced resource in the same window.), "embed" (Embed the referenced resource at the point of the link.), "none" (Do not permit traversal to the referenced resource.), "other" (Behavior other than permitted by the other values of this attribute.)
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
(MEI.shared) Attributes common to many elements.
(MEI.shared) Attributes that form the basis of the att.common class.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
(MEI.shared) Attributes that uniquely identify an element.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
(MEI.shared)
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
(MEI.shared) Attributes that specify element-to-element relationships.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes used to supply a number-like designation for an element.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
(MEI.shared) Attributes capturing information regarding responsibility for some aspect of the text's creation, transcription, editing, or encoding.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
(MEI.shared) Bibliographic attributes.
analog(optional)Contains a reference to a field or element in another descriptive encoding system to which this MEI element is comparable. Value is plain text.
(MEI.shared) Attributes common to all pointing/linking elements.
xlink:actuate(optional)Defines whether a link occurs automatically or must be requested by the user. Allowed values are: "onLoad" (Load the target resource(s) immediately.), "onRequest" (Load the target resource(s) upon user request.), "none" (Do not permit loading of the target resource(s).), "other" (Behavior other than allowed by the other values of this attribute.)
xlink:role(optional)Characterization of the relationship between resources. The value of the role attribute must be a URI. Value conforms to data.URI.
xlink:show(optional)Defines how a remote resource is rendered. Allowed values are: "new" (Open in a new window.), "replace" (Load the referenced resource in the same window.), "embed" (Embed the referenced resource at the point of the link.), "none" (Do not permit traversal to the referenced resource.), "other" (Behavior other than permitted by the other values of this attribute.)
target(optional)Identifies passive participants in a relationship; that is, the entities pointed "to". One or more values from data.URI, separated by spaces.
targettype(optional)Characterization of target resource(s) using any convenient classification scheme or typology. Value is a NMTOKEN.
Component declarations that are shared between two or more modules.
analog(optional)Contains a reference to a field or element in another descriptive encoding system to which this MEI element is comparable. Value is plain text.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
target(optional)Identifies passive participants in a relationship; that is, the entities pointed "to". One or more values from data.URI, separated by spaces.
targettype(optional)Characterization of target resource(s) using any convenient classification scheme or typology. Value is a NMTOKEN.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
xlink:actuate(optional)Defines whether a link occurs automatically or must be requested by the user. Allowed values are: "onLoad" (Load the target resource(s) immediately.), "onRequest" (Load the target resource(s) upon user request.), "none" (Do not permit loading of the target resource(s).), "other" (Behavior other than allowed by the other values of this attribute.)
xlink:role(optional)Characterization of the relationship between resources. The value of the role attribute must be a URI. Value conforms to data.URI.
xlink:show(optional)Defines how a remote resource is rendered. Allowed values are: "new" (Open in a new window.), "replace" (Load the referenced resource in the same window.), "embed" (Embed the referenced resource at the point of the link.), "none" (Do not permit traversal to the referenced resource.), "other" (Behavior other than permitted by the other values of this attribute.)
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
Member of
model.titlePagePartGroups elements that may appear as part of a title page transcription.
Contained By
expressionIntellectual or artistic realization of a work.
manifestationA bibliographic description of a physical embodiment of an expression of a work.
seriesStmtGroups information about the series, if any, to which a publication belongs.
workProvides a detailed description of a work — a distinct intellectual or artistic creation — specifically its history, language use, and high-level musical attributes (e.g., key, tempo, meter, medium of performance, and intended duration).
(MEI.shared) Groups elements that may appear as part of a title page transcription.
titlePageContains a transcription of the title page of a text.
FRBR (Functional Requirements for Bibliographic Records) declarations.
expressionIntellectual or artistic realization of a work.
manifestationA bibliographic description of a physical embodiment of an expression of a work.
Metadata header component declarations.
seriesStmtGroups information about the series, if any, to which a publication belongs.
workProvides a detailed description of a work — a distinct intellectual or artistic creation — specifically its history, language use, and high-level musical attributes (e.g., key, tempo, meter, medium of performance, and intended duration).
Component declarations that are shared between two or more modules.
titlePageContains a transcription of the title page of a text.
May Contain
contentItemContains a single entry within a content description element.
labelA container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the label attribute.
(MEI.shared) Groups elements used to provide a heading at the start of a text division or other markup component.
headContains any heading, for example, the title of a section of text, or the heading of a list.
(MEI.shared) Groups paragraph-like elements.
pOne or more text phrases that form a logical prose passage.
Metadata header component declarations.
contentItemContains a single entry within a content description element.
Component declarations that are shared between two or more modules.
headContains any heading, for example, the title of a section of text, or the heading of a list.
labelA container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the label attribute.
pOne or more text phrases that form a logical prose passage.
Remarks

Use this element to provide an enumeration of the contents of a bibliographic entity, like that often found in a table of contents. When a detailed bibliographic description of included material is desired, use the componentList element instead.

Constraints

When labels are used, usually each content item has one.

Declaration
<elementSpec ident="contents" module="MEI.header">
<desc xml:lang="en">List of the material contained within a resource.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.bibl"/>
<memberOf key="att.pointing"/>
<memberOf key="model.titlePagePart"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:ref name="model.headLike"/>
</rng:zeroOrMore>
<rng:choice>
<rng:optional>
<rng:ref name="model.pLike"/>
</rng:optional>
<rng:oneOrMore>
<rng:optional>
<rng:ref name="label"/>
</rng:optional>
<rng:ref name="contentItem"/>
</rng:oneOrMore>
</rng:choice>
</content>
<constraintSpec ident="checkContentsLabels" scheme="schematron">
<constraint>
<sch:rule context="mei:contents[mei:label]">
<sch:assert role="warning" test="count(mei:label) = count(mei:contentItem)">When labels are used, usually each content item has one.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<exemplum>
<egXML xml:space="preserve">
<contents>
<p>A suitable tone ; Left hand coloring ; Rhythm and accent ; Tempo ; Flexibility ; Ornaments</p>
</contents>
</egXML>
</exemplum>
<exemplum>
<egXML xml:space="preserve">
<contents>
<head>Contents</head>
<label>1.</label>
<contentItem>Sonata in D major, op. V, no. 1 / Corelli</contentItem>
<label>2.</label>
<contentItem>Sonata in G minor / Purcell (with Robert Donington, gamba)</contentItem>
<label>3.</label>
<contentItem>Forlane from Concert royal no. 3 / Couperin</contentItem>
</contents>
</egXML>
</exemplum>
<exemplum>
<egXML xml:space="preserve">
<contents target="http://www.contentProvider.org/toc/toc01.html"/>
</egXML>
</exemplum>
<remarks xml:lang="en">
<p>Use this element to provide an enumeration of the contents of a bibliographic entity, like that often found in a table of contents. When a detailed bibliographic description of included material is desired, use the <gi scheme="MEI">componentList</gi> element instead.</p>
</remarks>
</elementSpec>