Template:Flatlist/doc: Difference between revisions

From Guild of Archivists
m (1 revision imported)
 
No edit summary
 
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{#switch:{{FULLPAGENAME}}
This template provides a [[w:Web Content Accessibility Guidelines|WCAG]]/ISO-standards-compliant accessible alternative to comma- or dash- (or other single character-) separated lists.
| Template:Flatlist    = {{High-risk|117,000+}}
| Template:Endflatlist = {{High-risk|80,000+}}
}}
{{redirect|Template:Inline list|a navbox listing templates used within lines of text to mark problems needing attention|Template:Inline cleanup tags}}
{{TOClimit|3}}
 
This template provides a [[Web Content Accessibility Guidelines|WCAG]]/ISO-standards-compliant accessible alternative to comma- or dash- (or other single character-) separated lists, per [[WP:FLATLIST]] and [[WP:HLIST]].


==Usage==
==Usage==
Line 14: Line 7:


{{flatlist|
{{flatlist|
* [[cat]]
* [[Atrus]]
* [[dog]]
* [[Catherine]]
* [[horse]]
* [[Sirrus]]
* [[cow]]
* [[Achenar]]
* [[sheep]]
* [[Yeesha]]
* [[pig]]
* [[Ti'ana]]
}}
}}


This template can be used with or without {{tl|endflatlist}}. For navigation boxes using {{tl|navbox}}, one can set {{para|listclass|hlist}}, and achieve the same styling without using this template. For image captions, list (i.e. asterisk) markup does not work, so consider using {{tl|hlist}} instead.
For navigation boxes using {{tl|navbox}}, one can set {{para|listclass|hlist}}, and achieve the same styling without using this template. For image captions, list (i.e. asterisk) markup does not work, so consider using {{tl|hlist}} instead.


==Examples==
==Examples==
<pre>
<pre>
{{flatlist|
{{flatlist|
* [[cat]]
* [[Atrus]]
* [[dog]]
* [[Catherine]]
* [[horse]]
* [[Sirrus]]
* [[cow]]
* [[Achenar]]
* [[sheep]]
* [[Yeesha]]
* [[pig]]
* [[Ti'ana]]
}}
}}
</pre>
</pre>
Line 39: Line 32:


{{flatlist|
{{flatlist|
* [[cat]]
* [[Atrus]]
* [[dog]]
* [[Catherine]]
* [[horse]]
* [[Sirrus]]
* [[cow]]
* [[Achenar]]
* [[sheep]]
* [[Yeesha]]
* [[pig]]
* [[Ti'ana]]
}}
}}
===Alternative syntax===
<pre>
{{startflatlist}}
* [[cat]]
* [[dog]]
* [[horse]]
* [[cow]]
* [[sheep]]
* [[pig]]
{{endflatlist}}
</pre>
produces:
{{startflatlist}}
* [[cat]]
* [[dog]]
* [[horse]]
* [[cow]]
* [[sheep]]
* [[pig]]
{{endflatlist}}


===Syntax for ordered lists===
===Syntax for ordered lists===
<pre>
<pre>
{{flatlist|
{{flatlist|
# [[first]]
# [[Atrus]]
# [[second]]
# [[Catherine]]
# [[third]]
# [[Sirrus]]
# [[fourth]]
# [[Achenar]]
# [[fifth]]
# [[Yeesha]]
# [[sixth]]
# [[Ti'ana]]
}}
}}
</pre>
</pre>
Line 85: Line 55:


{{flatlist|
{{flatlist|
# [[first]]
# [[Atrus]]
# [[second]]
# [[Catherine]]
# [[third]]
# [[Sirrus]]
# [[fourth]]
# [[Achenar]]
# [[fifth]]
# [[Yeesha]]
# [[sixth]]
# [[Ti'ana]]
}}
}}


==Parameters==
==Parameters==
* '''''class''''' adds a CSS class to the containing div. Use <tt>nowraplinks</tt> to prevent links from wrapping.
* '''''class''''' adds a CSS class to the containing div. Use <tt>nowraplinks</tt> to prevent links from wrapping.
* '''''style''''' adds CSS styling to the containing div. Complex styles should not be used in articles (per [[WP:Deviations]]) but may be acceptable on user, project and talk pages.
* '''''style''''' adds CSS styling to the containing div. Complex styles should not be used in articles, but may be acceptable on user, project and talk pages.
::Example: {{para|<var>style</var>|<var>border:solid 1px silver; background:lightyellow</var>}}
::Example: {{para|<var>style</var>|<var>border:solid 1px silver; background:lightyellow</var>}}
* '''''indent''''' indents the list by a number of standard indents, one indent being 1.6[[Em (typography)|em]]. (Useful in an indented discussion thread.)
* '''''indent''''' indents the list by a number of standard indents, one indent being 1.6em. (Useful in an indented discussion thread.)
::Example: {{para|<var>indent</var>|<var>2</var>}}
::Example: {{para|<var>indent</var>|<var>2</var>}}


==Technical details==
==Technical details==
This template uses the <code>.hlist</code> CSS class defined in Common.css to generate horizontal lists. It causes ordinary html list items to be displayed inline (horizontally), where they would normally display as block elements (vertically). The class also generates the [[interpunct]]s between list items and parentheses around nested lists. Some of the CSS used is not compatible with all browsers, notably Internet Explorer 6 and 7.
This template uses the <code>.hlist</code> CSS class defined in Common.css to generate horizontal lists. It causes ordinary html list items to be displayed inline (horizontally), where they would normally display as block elements (vertically). The class also generates the dots between list items and parentheses around nested lists. Some of the CSS used is not compatible with all browsers, notably Internet Explorer 6 and 7.
 
==Redirects==
* {{tl|startflatlist}} and {{tl|endflatlist}}
* {{tl|flt}} and {{tl|flb}}


==See also==
==See also==
* {{tl|hlist}}
* {{tl|hlist}}
* {{tl|plainlist}} and {{tl|unbulleted list}}
* {{tl|unbulleted list}}
* {{tl|ordered list}} and {{tl|unordered list}}
* {{tl|multi-column numbered list}}
* {{tl|nowrap}}
* {{tl|nowrap}}
* {{tl|pagelist}}
* [[WP:HLIST]]


<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||

Latest revision as of 07:34, 11 July 2016

This template provides a WCAG/ISO-standards-compliant accessible alternative to comma- or dash- (or other single character-) separated lists.

Usage[edit]

{{flatlist}} starts a horizontal list, such as:

For navigation boxes using {{navbox}}, one can set |listclass=hlist, and achieve the same styling without using this template. For image captions, list (i.e. asterisk) markup does not work, so consider using {{hlist}} instead.

Examples[edit]

{{flatlist|
* [[Atrus]]
* [[Catherine]]
* [[Sirrus]]
* [[Achenar]]
* [[Yeesha]]
* [[Ti'ana]]
}}

produces:

Syntax for ordered lists[edit]

{{flatlist|
# [[Atrus]]
# [[Catherine]]
# [[Sirrus]]
# [[Achenar]]
# [[Yeesha]]
# [[Ti'ana]]
}}

produces:

Parameters[edit]

  • class adds a CSS class to the containing div. Use nowraplinks to prevent links from wrapping.
  • style adds CSS styling to the containing div. Complex styles should not be used in articles, but may be acceptable on user, project and talk pages.
Example: |style=border:solid 1px silver; background:lightyellow
  • indent indents the list by a number of standard indents, one indent being 1.6em. (Useful in an indented discussion thread.)
Example: |indent=2

Technical details[edit]

This template uses the .hlist CSS class defined in Common.css to generate horizontal lists. It causes ordinary html list items to be displayed inline (horizontally), where they would normally display as block elements (vertically). The class also generates the dots between list items and parentheses around nested lists. Some of the CSS used is not compatible with all browsers, notably Internet Explorer 6 and 7.

See also[edit]