ਫਰਮਾ:Flatlist/doc ਲਈ ਸਰੋਤ ਵੇਖੋ

{{Documentation subpage}}
{{uses TemplateStyles|Template:Flatlist/styles.css}}
<!-- PLEASE ADD CATEGORIES 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, per [[w:WP:FLATLIST]] and [[w:WP:HLIST]].
{{TOC limit|3}}

==Usage==
{{tlf|flatlist}} starts a horizontal list, such as:

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

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.

==Optional parameters==
; class
: Adds a CSS class to the containing div. Use {{tt|nowraplinks}} 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.
: 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.)
: Example: {{para|<var>indent</var>|<var>2</var>}}

; sep
: Alternative separator. Only <code>,</code> is supported.

==Examples==

{{doc example|content=
<syntaxhighlight lang="wikitext">
 {{flatlist|
 * [[cat]]
 * [[dog]]
 * [[horse]]
 * [[cow]]
 * [[sheep]]
 * [[pig]]
 }}
</syntaxhighlight>

produces:

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

===Alternative syntax===

{{doc example|content=
<syntaxhighlight lang="wikitext">
 {{startflatlist}}
 * [[cat]]
 * [[dog]]
 * [[horse]]
 * [[cow]]
 * [[sheep]]
 * [[pig]]
 {{endflatlist}}
</syntaxhighlight>

produces:

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

===Syntax for ordered lists===
{{doc example|content=
<pre>
{{flatlist|
# [[first]]
# [[second]]
# [[third]]
# [[fourth]]
# [[fifth]]
# [[sixth]]
}}
</pre>

produces:

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

=== Using optional parameters ===

{{doc example|content=
<syntaxhighlight lang="wikitext">
 {{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]]
 }}
</syntaxhighlight>

produces:

{{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]]
}}
}}


{{doc example|title=Comma Separators|content=
<syntaxhighlight lang="wikitext">
{{flatlist|sep=,|
 * [[cat]]
 * [[dog]]
 * [[horse]]
 * [[cow]]
 * [[sheep]]
 * [[pig]]
}}
</syntaxhighlight>

produces:

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

==Technical details==
This template 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 some older browsers, notably Internet Explorer 6 and 7.

{| class="wikitable"
! Wikitext
! Expanded template
! HTML
|- style="vertical-align:top;"
| <pre>
{{flatlist|
* cat
* dog
* horse
* cow
* sheep
* pig
}}
</pre>
| {{nowiki2|tag=pre|
{{flatlist|
* cat
* dog
* horse
* cow
* sheep
* pig
}}
}}
| <syntaxhighlight lang="html">
<div class="wst-flatlist">
<ul><li>cat</li>
<li>dog</li>
<li>horse</li>
<li>cow</li>
<li>sheep</li>
<li>pig</li></ul>
</div>
</syntaxhighlight>
|}

==Redirects==
* {{tl|startflatlist}}
* {{tl|endflatlist}}
* {{tl|flt}}

==See also==
* {{tl|hlist}}
* {{tl|plainlist}} and {{tl|unbulleted list}}
* {{tl|bulleted list}}
* {{tl|ordered list}}
* {{tl|multi-column numbered list}}
* {{tl|nowrap}}
* {{tl|pagelist}}
* [[WP:HLIST]]
{{HTML lists}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- CATEGORIES HERE, THANKS -->
[[Category:Typing-aid templates|Flatlist]]
[[Category:List formatting and function templates|Flatlist]]
}}</includeonly>