<list> List

<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.

EAD3 Tag Library Entry

View the official tag library entry for <list>