Index is a very general class of list. You’ll most often see it containing blurbs, or as the content in a listbox, but it isn’t restricted to those. Index has very few rules; it’s a flexible grouping class.
It doesn’t have its own style sheet, but index styles are declared in the style sheet named 10-types-groups.css.
HTML structure
An index can be any of the three kinds of HTML list.
- dl.index
- ol.index
- ul.index
You can never have any other kind of index.
dl.index
dl.index
is sometimes used to display simple paired data (e.g. on a translated news post), but it more often functions as a sort of brief alternative to showing a full blurb (or a full list of blurbs).
Instead of displaying a full work blurb on a user’s related works or subscriptions page, we use a dl.index
to provide basic information and options, and we do the same instead of displaying each individual request blurb on a user’s assignments page.
While it’s less work to display these shorter blurbs, Archive users frequently express a preference for more information rather than less, and it is not uncommon for us to switch from an abbreviated dl.index
to an index with a full li.blurb
.
XHTML diagram of dl.index
The following diagram is taken from the assignments page a user can access from their dashboard.
-
<dl class="assignment index group">
-
<dt>
-
<a>Assignment link
-
-
<dd>
-
<ul class="actions" role="menu">
-
<li>
-
<a role="button">Fulfill
-
-
<li>
-
<a role="button">Default
-
-
-
-
<dt>
-
<a>Assignment link
-
-
<dd>
-
<a>Work link
-
<dl class="stats">
-
<dt>
-
<dd>
-
-
-