Template:Hlist

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

This template creates horizontal lists. Each item in the list may be individually styled with CSS.

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

Usage

Basic usage

{{hlist|first item|second item|third item|...}}

All parameters

{{hlist
|first item|second item|third item|...
|class       = class for div tag
|style       = style for div tag
|list_style  = style for ul tag
|item_style  = style for all li tags
|item1_style = style for first li tag
|item2_style = style for second li tag
|...
|indent      = the number of tabs to indent
}}

Example

{{hlist|Jazz|rock|pop|rap}}

produces:

• Jazz
• rock
• pop
• rap

Parameters

• Positional parameters (1, 2, 3...): these are the list items. If no list items are present, the module will output nothing.
• class: a custom class for the <div>...</div> tags surrounding the list. Set to inline when using {{hlist}} inside text.
• style: a custom CSS style for the <div>...</div> tags surrounding the list, e.g. font-size: 90%;.
• list_style: a custom CSS style for the <ul>...</ul> tags around the list. The format is the same as for the |style= parameter.
• item_style: a custom CSS style for all of the list items (the <li>...</li> tags). The format is the same as for the |style= parameter.

  Avoid using the style white-space:nowrap in the item_style parameter, because it will have the unintended effect of avoiding line breaks anywhere in the list, instead of just inside the list item; the workaround is to move this style in the list_style parameter, and then insert {{Wbr}} at the beginning of each item value, to insert an invisible word-break opportunity (and not at end of the item value, as the word-break would occur just before the trailing spaced-bullet separator).

• item1_style, item2_style, item3_style...: custom CSS styles for each of the list items. The format is the same as for the |style= parameter.
• indent: the number of tabs to indent the list. Default value is 0.

Examples

Markup	Renders as
{{hlist|entry1|entry2|entry3|entry4|entry5|entry6|entry7|entry8|entry9}}	entry1 entry2 entry3 entry4 entry5 entry6 entry7 entry8 entry9
✘ Giant planets ({{hlist|[[Jupiter|J]]|[[Saturn|S]]|[[Uranus|U]]|[[Neptune|N]]}}).	✘ Giant planets ( J S U N ). (incorrect markup)
✔ Giant planets ({{hlist|class=inline|[[Jupiter|J]]|[[Saturn|S]]|[[Uranus|U]]|[[Neptune|N]]}}).	✔ Giant planets ( J S U N ). (correct markup)
{{hlist|Winner|Runner-up|Third place|indent=2}}	Winner Runner-up Third place
{{hlist|Winner|Runner-up|Third place|item_style=color:blue;}}	Winner Runner-up Third place
{{hlist|Winner|Runner-up|Third place|item1_style=background-color:yellow;color:black;|item2_style=background-color:silver;color:black;}}	Winner Runner-up Third place

Avoiding Linter errors

{{hlist}} will produce Linter errors if placed inside a template that uses <span>...</span> tags, such as {{small}}, {{larger}}, etc. To avoid this, use the substitutions from the table below:

N Incorrect markup	Y Correct markup
{{small|{{hlist|...}}}}	{{hlist|...|style=font-size:85%}}
{{resize|{{hlist|...}}}}	{{hlist|...|style=font-size:90%}}
{{midsize|{{hlist|...}}}}	{{hlist|...|style=font-size:92%}}
{{larger|{{hlist|...}}}}	{{hlist|...|style=font-size:120%}}
{{big|{{hlist|...}}}}	{{hlist|...|style=font-size:120%}}
{{large|{{hlist|...}}}}	{{hlist|...|style=font-size:120%}}
{{huge|{{hlist|...}}}}	{{hlist|...|style=font-size:180%}}
{{resize|x%|{{hlist|...}}}}	{{hlist|...|style=font-size:x%}}
{{font|size=x%|{{hlist|...}}}}	{{hlist|...|style=font-size:x%}}
{{nowrap|{{hlist|...}}}}	{{hlist|...|style=white-space: nowrap}}

The above documentation is transcluded from Template:Hlist/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.