Editing Template:Flatlist/doc

From Guild of Archivists
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
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 -->
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.
{{#switch:{{FULLPAGENAME}}
| 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 7: Line 14:


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


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


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


{{flatlist|
{{flatlist|
* [[Atrus]]
* [[cat]]
* [[Catherine]]
* [[dog]]
* [[Sirrus]]
* [[horse]]
* [[Achenar]]
* [[cow]]
* [[Yeesha]]
* [[sheep]]
* [[Ti'ana]]
* [[pig]]
}}
}}
===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|
# [[Atrus]]
# [[first]]
# [[Catherine]]
# [[second]]
# [[Sirrus]]
# [[third]]
# [[Achenar]]
# [[fourth]]
# [[Yeesha]]
# [[fifth]]
# [[Ti'ana]]
# [[sixth]]
}}
}}
</pre>
</pre>
Line 55: Line 85:


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


==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, 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 (per [[WP:Deviations]]) 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.6em. (Useful in an indented discussion thread.)
* '''''indent''''' indents the list by a number of standard indents, one indent being 1.6[[Em (typography)|em]]. (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 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.
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.
 
==Redirects==
* {{tl|startflatlist}} and {{tl|endflatlist}}
* {{tl|flt}} and {{tl|flb}}


==See also==
==See also==
* {{tl|hlist}}
* {{tl|hlist}}
* {{tl|unbulleted list}}
* {{tl|plainlist}} and {{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||
Please note that all contributions to Guild of Archivists may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see GoArch:Copyrights for details). Do not submit copyrighted work without permission!
Cancel Editing help (opens in new window)