<list> is a formatting element used to encode a list of <item> elements or <defitem> elements. Lists may be defined in 3 types: deflist, ordered, and unordered. See more info in the attribute section.
It may be used within <accessrestrict>, <accruals>, <acqinfo>, <altformavail>, <appraisal>, <arrangement>, <bibliography>, <bioghist>, <blockquote>, <controlaccess>, <controlnote>, <custodhist>, <dsc>, <entry>, <event>, <fileplan>, <footnote>, <index>, <item>, <legalstatus>, <odd>, <originalsloc>, <otherfindaid>, <p>, <phystech>, <prefercite>, <processinfo>, <relatedmaterial>, <scopecontent>, <separatedmaterial>, and <userestrict>.
Attributes
- @altrender – not required. Use if the content of the element should be displayed or printed differently than the rendering established in a style sheet for other occurrences of the element.
- @audience – not required. Use to set whether the element’s contents will be visible to external users or to internal ones. Possible values are: “internal” and “external.”
- @id – not required. Creates an ID for element. Can be used for linking.
- @lang – not required. Three-letter code that indicates the language in which the element’s contents were written. It should come from ISO 639-2b.
- @listtype – not required. Use to indicate the type of list. Possible values: deflist (used to put together definition lists), ordered (can be rendered to display as an ordered list with numbers/letters/etc.), unordered (plain unordered list).
- @mark – not required. Use to define the type of mark for the list. Possible values: armenian, circle, decimal, decimal-leading-zero, disc, georgian, inherit, lower-alpha, lower-greek, lower-latin, lower-roman, none, square, upper-alpha, upper-latin, upper-roman.
- @numeration – not required. May indicate the kind of numeration of an ordered list. Possible values: arabic, loweralpha, lowerroman, upperalpha, upperroman.
- @script – not required. Four-letter code that indicates the script in which the element’s contents were written. It should come from ISO 15924.
Child Elements
<list> may contain a <head> element. It them must contain either:
a) one or more <item> elements
or
b) an optional <listhead> and one or more <defitem> elements if its @listtype is “deflist.” It if is a “deflist”, <head> and <listhead> may be used within the same <list> as the first may be used to name the list and the second to name the columns.
Examples
<p>The following terms are used in correspondence throughout the series.</p> <list listtype="deflist"> <listhead> <head01>Term</head02> <head02>Definition</head03> </listhead> <defitem> <label>cutter</label> <item>a rotary cutter used to cut fabric</item> </defitem> <defitem> <label>Hera</label> <item>The Clover brand Hera tool is used to mark and fold fabric.</item> </defitem> <defitem> <label>jelly roll</label> <item>a rolled bundle of fabric strips, cut 2.5" wide</item> </defitem> </list> |
<accessrestrict> <head>Restrictions on Access</head> <p>The collection is open for reearch. The following series require review by the archivist to redact protected information:</p> <list listtype="unordered"> <item>Meeting Notes (for records less than 20 years old)</item> <item>Grants</item> </list> </accessrestrict> |
<fileplan> <head>List of Courses</head> <p>The following list associates course codes with course titles represented in the syllabuses.</p> <list listtype="deflist"> <listhead> <head01>Course Number</head01> <head02>Course Title</head02> </listhead> <defitem> <label>QT-512</label> <item>What is Technology?</item> </defitem> <defitem> <label>QT-537</label> <item>History of the Quilt</item> </defitem> <defitem> <label>QT-570</label> <item>Traditional Quilts, Art Quilts, and Feminism</item> </defitem> <defitem> <label>QT-614</label> <item>Quilting and the Industrial Revolution</item> </defitem> <defitem> <label>QT-638</label> <item>Women's Work: Society, Technology, and Misogyny</item> </defitem> <defitem> <label>QT-687</label> <item>Technologies of Improvisation</item> </defitem> <defitem> <label>QT-712</label> <item>Needle, Thimble, and Computer: Textiles and Technologies</item> </defitem> <defitem> <label>QT-729</label> <item>Technological Design and the Textile Future</item> </defitem> </list> </fileplan> |
Changes from EAD 2002
<list> gained attributes @lang and @script. @type changed to @listtype and “marked” is no longer a possible value of @listtype. The attribute @mark may be used to designate any type of marker (to be styled with CSS), in a move that matches the original/continued use of @numeration. While some parent elements have changed because of deprecation and addition of elements, <list> remains one of the very common generic elements.