<list>

A formatting element that contains a series of items separated from one another and arranged in a linear, often vertical, sequence.
3.7.1.2 Title Pages, 9.1.2.1 Front Matter, 9.2.3.1 Figure Captions and Descriptions, 9.2.4 Lists, 13.2.1 Pointers and References
Module
MEI.text
Attributes
class, copyof, corresp, facs, follows, form, label, n, next, precedes, prev, resp, sameas, synch, translit, type, x, xml:base, xml:id, xml:lang, y
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.
<list>att.classed@class
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
<list>att.linking@copyof
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.
<list>att.linking@corresp
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
<list>att.facsimile@facs
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.
<list>att.linking@follows
form(optional)Used to indicate the format of a list. In a simple list, li elements are not numbered or bulleted. In a marked list, the sequence of the list items is not critical, and a bullet, box, dash, or other character is displayed at the start of each item. In an ordered list, the sequence of the items is important, and each li is lettered or numbered. Style sheet functions should be used to specify the mark or numeration system for each li. Allowed values are: "simple" (Items are not numbered or bulleted.), "marked" (Bullet, box, dash, or other character is displayed before each item.), "ordered" (Each item is numbered or lettered.)
<list>direct children@form
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.
<list>att.labelled@label
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.
<list>att.nNumberLike@n
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.
<list>att.linking@next
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.
<list>att.linking@precedes
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<list>att.linking@prev
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.
<list>att.responsibility@resp
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.
<list>att.linking@sameas
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
<list>att.linking@synch
translit(optional)Specifies the transliteration technique used. Value is a NMTOKEN.
<list>att.lang@translit
type(optional)Captures the nature of the content of a list. Allowed values are: "gloss" (Each list item glosses some term or concept, which is given by a label element preceding the list item.), "index" (Each list item is an entry in an index such as the alphabetical topical index at the back of a print volume.), "instructions" (Each list item is a step in a sequence of instructions, as in a recipe.), "litany" (Each list item is one of a sequence of petitions, supplications or invocations, typically in a religious ritual.), "syllogism" (Each list item is part of an argument consisting of two or more propositions and a final conclusion derived from them.)
<list>direct children@type
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
<list>att.xy@x
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.
<list>att.basic@xml:base
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.
<list>att.basicatt.id@xml:id
xml:lang(optional)Identifies the language of the element’s content. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use sub-tags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag’s value. Value is a language.
<list>att.lang@xml:lang
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
<list>att.xy@y
form(optional)Used to indicate the format of a list. In a simple list, li elements are not numbered or bulleted. In a marked list, the sequence of the list items is not critical, and a bullet, box, dash, or other character is displayed at the start of each item. In an ordered list, the sequence of the items is important, and each li is lettered or numbered. Style sheet functions should be used to specify the mark or numeration system for each li. Allowed values are: "simple" (Items are not numbered or bulleted.), "marked" (Bullet, box, dash, or other character is displayed before each item.), "ordered" (Each item is numbered or lettered.)
type(optional)Captures the nature of the content of a list. Allowed values are: "gloss" (Each list item glosses some term or concept, which is given by a label element preceding the list item.), "index" (Each list item is an entry in an index such as the alphabetical topical index at the back of a print volume.), "instructions" (Each list item is a step in a sequence of instructions, as in a recipe.), "litany" (Each list item is one of a sequence of petitions, supplications or invocations, typically in a religious ritual.), "syllogism" (Each list item is part of an argument consisting of two or more propositions and a final conclusion derived from them.)
(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) 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.facsimile) Attributes that associate a feature corresponding with all or part of an image.
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
(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) Language attributes common to text elements.
xml:lang(optional)Identifies the language of the element’s content. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use sub-tags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag’s value. Value is a language.
translit(optional)Specifies the transliteration technique used. Value is a NMTOKEN.
(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) Output coordinate attributes. Some elements may have their exact rendered *output* coordinates recorded. x and y attributes indicate where to place the rendered output. Recording the coordinates of a feature in a facsimile requires the use of the facs attribute.
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
Facsimile component declarations.
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
Component declarations that are shared between two or more modules.
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.
translit(optional)Specifies the transliteration technique used. Value is a NMTOKEN.
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
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.
xml:lang(optional)Identifies the language of the element’s content. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use sub-tags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag’s value. Value is a language.
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
Text component declarations.
form(optional)Used to indicate the format of a list. In a simple list, li elements are not numbered or bulleted. In a marked list, the sequence of the list items is not critical, and a bullet, box, dash, or other character is displayed at the start of each item. In an ordered list, the sequence of the items is important, and each li is lettered or numbered. Style sheet functions should be used to specify the mark or numeration system for each li. Allowed values are: "simple" (Items are not numbered or bulleted.), "marked" (Bullet, box, dash, or other character is displayed before each item.), "ordered" (Each item is numbered or lettered.)
type(optional)Captures the nature of the content of a list. Allowed values are: "gloss" (Each list item glosses some term or concept, which is given by a label element preceding the list item.), "index" (Each list item is an entry in an index such as the alphabetical topical index at the back of a print volume.), "instructions" (Each list item is a step in a sequence of instructions, as in a recipe.), "litany" (Each list item is one of a sequence of petitions, supplications or invocations, typically in a religious ritual.), "syllogism" (Each list item is part of an argument consisting of two or more propositions and a final conclusion derived from them.)
Member of
model.listLikeGroups list-like elements.
Contained By
eventContains a free-text event description.
spContains an individual speech in a performance text.
(MEI.text) Groups list-like elements.
(MEI.shared) Groups elements which may appear as part of the paragraph content model. A paragraph may contain inline elements and all other block-level elements except itself.
epigraphContains a quotation, anonymous or attributed, appearing on a title page.
imprimaturContains a formal statement authorizing the publication of a work, sometimes required to appear on a title page or its verso.
pOne or more text phrases that form a logical prose passage.
quoteContains a paragraph-like block of text attributed to an external source, normally set off from the surrounding text by spacing or other typographic distinction.
(MEI.shared) Groups block-level text elements.
annotProvides a statement explaining the text or indicating the basis for an assertion.
argumentContains a formal list or prose description of topics addressed.
dedicationContains a dedicatory statement.
divMajor structural division of text, such as a preface, chapter or section.
figDescContains a brief prose description of the appearance or content of a graphic figure, for use when documenting an image without displaying it.
historyProvides a container for information about the history of a resource other than the circumstances of its creation.
liSingle item in a list.
pgDescContains a brief prose description of the appearance or description of the content of a physical page.
pgFootA running footer.
pgHeadA running header.
tdDesignates a table cell that contains data as opposed to a cell that contains column or row heading information.
thDesignates a table cell containing column or row heading information as opposed to one containing data.
titlePageContains a transcription of the title page of a text.
(MEI.critapp) Groups elements that may appear as part of a textual variant.
(MEI.critapp) Groups elements that may appear as part of a textual or musical variant.
lemContains the lemma, or base text, of a textual variation.
rdgContains a single reading within a textual variation.
(MEI.edittrans) Groups elements that may appear as part of editorial and transcription elements in prose.
(MEI.edittrans) Groups elements that may appear as part of editorial and transcription elements.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Critical apparatus component declarations.
lemContains the lemma, or base text, of a textual variation.
rdgContains a single reading within a textual variation.
Dramatic text component declarations.
spContains an individual speech in a performance text.
Editorial and transcriptional component declarations.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Figures and tables component declarations.
figDescContains a brief prose description of the appearance or content of a graphic figure, for use when documenting an image without displaying it.
tdDesignates a table cell that contains data as opposed to a cell that contains column or row heading information.
thDesignates a table cell containing column or row heading information as opposed to one containing data.
Metadata header component declarations.
dedicationContains a dedicatory statement.
historyProvides a container for information about the history of a resource other than the circumstances of its creation.
Component declarations that are shared between two or more modules.
annotProvides a statement explaining the text or indicating the basis for an assertion.
divMajor structural division of text, such as a preface, chapter or section.
eventContains a free-text event description.
pOne or more text phrases that form a logical prose passage.
pgDescContains a brief prose description of the appearance or description of the content of a physical page.
pgFootA running footer.
pgHeadA running header.
titlePageContains a transcription of the title page of a text.
Text component declarations.
argumentContains a formal list or prose description of topics addressed.
epigraphContains a quotation, anonymous or attributed, appearing on a title page.
imprimaturContains a formal statement authorizing the publication of a work, sometimes required to appear on a title page or its verso.
liSingle item in a list.
quoteContains a paragraph-like block of text attributed to an external source, normally set off from the surrounding text by spacing or other typographic distinction.
May Contain
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.
liSingle item in a list.
(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.
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.
Text component declarations.
liSingle item in a list.
Remarks

The model of this element is based on the list element of the Encoded Archival Description (EAD), the list element of the Text Encoding Initiative (TEI), and the respective elements of HTML.

Constraints

In a list of type "gloss" all items must be immediately preceded by a label.

Declaration
<elementSpec ident="list" module="MEI.text">
<desc xml:lang="en">A formatting element that contains a series of items separated from one another and arranged in a linear, often vertical, sequence.</desc>
<classes>
<memberOf key="att.basic"/>
<memberOf key="att.classed"/>
<memberOf key="att.facsimile"/>
<memberOf key="att.labelled"/>
<memberOf key="att.lang"/>
<memberOf key="att.linking"/>
<memberOf key="att.nNumberLike"/>
<memberOf key="att.responsibility"/>
<memberOf key="att.xy"/>
<memberOf key="model.listLike"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:ref name="model.headLike"/>
</rng:zeroOrMore>
<rng:zeroOrMore>
<rng:optional>
<rng:ref name="label"/>
</rng:optional>
<rng:ref name="li"/>
</rng:zeroOrMore>
</content>
<constraintSpec ident="list_type_constraint" scheme="schematron">
<constraint>
<sch:rule context="mei:list[contains(@type,'gloss')]">
<sch:assert test="count(mei:label) = count(mei:li)">In a list of type "gloss" all items must be immediately preceded by a label.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<attList>
<attDef ident="form" usage="opt">
<desc xml:lang="en">Used to indicate the format of a list. In a
<val>simple</val>
list,
<gi scheme="MEI">li</gi>
elements are not numbered or bulleted. In a
<val>marked</val>
list, the sequence of the list items is not critical, and a bullet, box, dash, or other character is displayed at the start of each
<gi scheme="MEI">item</gi>
. In an
<val>ordered</val>
list, the sequence of the items is important, and each
<gi scheme="MEI">li</gi>
is lettered or numbered. Style sheet functions should be used to specify the mark or numeration system for each
<gi scheme="MEI">li</gi>
.</desc>
<valList type="closed">
<valItem ident="simple">
<desc xml:lang="en">Items are not numbered or bulleted.</desc>
</valItem>
<valItem ident="marked">
<desc xml:lang="en">Bullet, box, dash, or other character is displayed before each item.</desc>
</valItem>
<valItem ident="ordered">
<desc xml:lang="en">Each item is numbered or lettered.</desc>
</valItem>
</valList>
</attDef>
<attDef ident="type" usage="opt">
<desc xml:lang="en">Captures the nature of the content of a list.</desc>
<datatype>
<rng:data type="NMTOKENS"/>
</datatype>
<valList type="semi">
<valItem ident="gloss">
<desc xml:lang="en">Each list item glosses some term or concept, which is given by a label element preceding the list item.</desc>
</valItem>
<valItem ident="index">
<desc xml:lang="en">Each list item is an entry in an index such as the alphabetical topical index at the back of a print volume.</desc>
</valItem>
<valItem ident="instructions">
<desc xml:lang="en">Each list item is a step in a sequence of instructions, as in a recipe.</desc>
</valItem>
<valItem ident="litany">
<desc xml:lang="en">Each list item is one of a sequence of petitions, supplications or invocations, typically in a religious ritual.</desc>
</valItem>
<valItem ident="syllogism">
<desc xml:lang="en">Each list item is part of an argument consisting of two or more propositions and a final conclusion derived from them.</desc>
</valItem>
</valList>
<remarks xml:lang="en">
<p>In a list of type
<val>gloss</val>
it is a semantic error not to precede each list item with a label.</p>
</remarks>
</attDef>
</attList>
<remarks xml:lang="en">
<p>The model of this element is based on the <ref target="https://www.loc.gov/ead/EAD3taglib/EAD3-TL-eng.html#elem-list">list</ref> element of the Encoded Archival Description (EAD), the <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/ref-list.html">list</ref> element of the Text Encoding Initiative (TEI), and the respective elements of
<abbr>HTML</abbr>
.</p>
</remarks>
</elementSpec>
MEI Version: 5.0(#eb14650)