Template:Flatlist

Template documentation[view] [edit] [history] [purge]

This template provides a WCAG/ISO-standards-compliant accessible alternative to comma- or dash- (or other single character-) separated lists, per WP:FLATLIST and MOS:HLIST.

Lists output by {{Flatlist}} and {{Hlist}} are semantically and visually identical, and differ only in the wiki-markup used to create the lists.

Usage

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

• cat
• dog
• horse
• cow
• sheep
• pig

This template can be used with or without {{endflatlist}}. 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.

Parameters

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Flatlist in articles based on its TemplateData.

TemplateData for Flatlist

Used to create plain (i.e. unbulleted) lists.

Parameter		Description	Type	Status
Content	1	The list to wrap.	Content	suggested
Extra Classes	class	Adds extra CSS classes to the containing div.	String	optional
CSS Style	style	Adds extra CSS properties to the containing div. Complex styles should not be used in articles (per MOS:DEVIATIONS) but may be acceptable on user, project and talk pages. Example border: solid 1px silver; background: lightyellow;	String	optional
Indent	indent	Indents the list by a number of standard indents (one indent being 1.6em). (Useful in an indented discussion thread.) Example 2	Number	optional

Format: inline

Examples

{{flatlist|
* [[cat]]
* [[dog]]
* [[horse]]
* [[cow]]
* [[sheep]]
* [[pig]]
}}

produces:

• cat
• dog
• horse
• cow
• sheep
• pig

Alternative syntax

{{startflatlist}}
* [[cat]]
* [[dog]]
* [[horse]]
* [[cow]]
* [[sheep]]
* [[pig]]
{{endflatlist}}

produces:

• cat
• dog
• horse
• cow
• sheep
• pig

Syntax for ordered lists

{{flatlist|
# [[first]]
# [[second]]
# [[3|third]]
# [[fourth]]
# [[fifth]]
# [[sixth]]
}}

produces:

1. first
2. second
3. third
4. fourth
5. fifth
6. sixth

Using optional parameters

{{flatlist |indent=2 
|style=border:solid 1px silver; background:lightyellow; 
|class=nowraplinks |
* [[Alpine skiing at the 1936 Winter Olympics]]
* [[Alpine skiing at the 1948 Winter Olympics]]
* [[Alpine skiing at the 1952 Winter Olympics]]
* [[Alpine skiing at the 1956 Winter Olympics]]
* [[Alpine skiing at the 1960 Winter Olympics]]
* [[Alpine skiing at the 1964 Winter Olympics]]
}}

produces:

• Alpine skiing at the 1936 Winter Olympics
• Alpine skiing at the 1948 Winter Olympics
• Alpine skiing at the 1952 Winter Olympics
• Alpine skiing at the 1956 Winter Olympics
• Alpine skiing at the 1960 Winter Olympics
• Alpine skiing at the 1964 Winter Olympics

Technical details

This template uses the .hlist CSS class defined in MediaWiki: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 interpuncts between list items and parentheses around nested lists. Some of the CSS used is not compatible with some older browsers, notably Internet Explorer 6 and 7.

Wikitext	Expanded template	HTML
{{flatlist| * cat * dog * horse * cow * sheep * pig }}	Template:Nowiki2	<div class="hlist"> <ul><li>cat</li> <li>dog</li> <li>horse</li> <li>cow</li> <li>sheep</li> <li>pig</li></ul> </div>

See also

• {{endflatlist}}
• {{hlist}}
• {{plainlist}} and {{unbulleted list}}
• {{bulleted list}}
• {{ordered list}}
• {{nowrap}}
• {{pagelist}}
• WP:HLIST

Horizontal list {{hlist}} {{hlist|item1 |item2 |...}} item1 item2 ...		Horizontal list {{flatlist}} {{flatlist| * item1 * item2 * ...}} item1 item2 ...		Horizontal list {{cslist}} {{cslist|item1 |item2 |...}} {{bold list}} {{bold list|item1 |item2 |...}}
Bulleted list {{bulleted list}} {{bulleted list|item1 |item2 |...}} item1 item2 ...		Numeric ordered list {{ordered list}} {{Ordered list|first |second |...}} first second ...		Alphabetic ordered list {{ordered list}} {{Ordered list|list_style_type=lower-alpha |first |second |...}} first second ...
Unbulleted list {{unbulleted list}} {{unbulleted list|item1 |item2 |...}} item1 item2 ...		Unbulleted list {{plainlist}} {{plainlist| * item1 * item2 * ...}} item1 item2 ...		Glossary or definition list {{glossary}} (glossary, description, definition, association) {{glossary}} {{term|first term}}{{defn|first description}} Template:TnullTemplate:Tnull Template:TnullTemplate:Tnull {{glossary end}}
Bulleted list to flow around an image {{flowlist}} [[File:Bad Title Example.png|left|thumb|100px]] {{flowlist| *item1 *item2 *...}}		Ordered list in columns {{columns-list}} {{columns-list|colwidth=5em| # first # second # third # ...}}

The above documentation is transcluded from Template:Flatlist/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.