Template:Unbulleted list/doc: Difference between revisions
From Video Credit Archive
Content deleted Content added
imported>Pigsonthewing m + |
imported>Jonesey95 →Controlling line-breaking: class=nowrap |
||
(59 intermediate revisions by 37 users not shown) | |||
Line 1: | Line 1: | ||
{{Documentation subpage}} |
{{Documentation subpage}} |
||
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). --> |
|||
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> |
|||
{{High-use| 635585 }} |
|||
{{Template shortcuts|ubl|ubt|ublist|unbullet}} |
|||
This template is used (primarily in infoboxes) to create unbulleted lists using the correct HTML mark-up using CSS to hide the bullets. Up to nine entries are supported. |
|||
{{stack|{{Lua|Module:List}}}} |
|||
This template creates [[WP:UBLIST|unbulleted lists]]. Each item in the list may have [[CSS]] styles added to it individually, by appending a numbered parameter. |
|||
== Usage == |
== Usage == |
||
:<code><nowiki>{{Unbulleted list|entry1|entry2|entry3}}</nowiki></code> |
|||
'''Basic usage''' |
|||
== Example == |
|||
{{pre2|<nowiki>{{</nowiki>unbulleted list<nowiki>|</nowiki>''first item''<nowiki>|</nowiki>''second item''<nowiki>|</nowiki>''third item''<nowiki>|</nowiki>...<nowiki>}}</nowiki>}} |
|||
'''All parameters''' |
|||
{{pre2| |
|||
<nowiki>{{</nowiki>unbulleted list |
|||
<nowiki>|</nowiki>''first item''<nowiki>|</nowiki>''second item''<nowiki>|</nowiki>''third item''<nowiki>|</nowiki>... |
|||
<nowiki>|class = </nowiki>''class'' |
|||
<nowiki>|style = </nowiki>''style'' |
|||
<nowiki>|list_style = </nowiki>''style for ul tag'' |
|||
<nowiki>|item_style = </nowiki>''style for all li tags'' |
|||
<nowiki>|item1_style = </nowiki>''style for first li tag''<nowiki> |item2_style = </nowiki>''style for second li tag''<nowiki> |</nowiki>... |
|||
<nowiki>}}</nowiki> |
|||
}} |
|||
=== Parameters === |
|||
* Positional parameters (<code>1</code>, <code>2</code>, <code>3</code>...) – these are the list items. If no list items are present, the module will output nothing. |
|||
* <code>class</code> – a custom class for the {{tag|div}} tags surrounding the list, e.g. <code>plainlinks</code>. |
|||
* <code>style</code> – a custom CSS style for the {{tag|div}} tags surrounding the list, e.g. <code>font-size: 90%;</code>. |
|||
* <code>list_style</code> – a custom CSS style for the {{tag|ul}} tags around the list. The format is the same as for the {{para|style}} parameter. |
|||
* <code>item_style</code> – a custom CSS style for all of the list items (the {{tag|li}} tags). The format is the same as for the {{para|style}} parameter. |
|||
* <code>item1_style</code>, <code>item2_style</code>, <code>item3_style</code>... – custom CSS styles for each of the list items. The format is the same as for the {{para|style}} parameter. |
|||
=== Example === |
|||
{| class="wikitable" |
{| class="wikitable" |
||
! Code !! Result |
! style="width: 80%;" | Code !! Result |
||
|- |
|- |
||
| <code><nowiki>{{Unbulleted list|entry1|entry2|entry3|entry4|entry5|entry6|entry7|entry8|entry9}}</nowiki></code> |
| <code><nowiki>{{Unbulleted list|entry1|entry2|entry3|entry4|entry5</nowiki>{{wbr}}<nowiki>|entry6|entry7|entry8|entry9}}</nowiki></code> |
||
| {{Unbulleted list|entry1|entry2|entry3|entry4|entry5|entry6|entry7|entry8|entry9}} |
|||
|- |
|- |
||
| <code><nowiki>{{Unbulleted list| | |
| <code><nowiki>{{Unbulleted list|Winner|Runner-up|Third place|item_style=color:blue;}}</nowiki></code> |
||
| {{Unbulleted list|Winner|Runner-up|Third place|item_style=color:blue;}} |
|||
|- |
|- |
||
| <code><nowiki>{{Unbulleted list| |
| <code><nowiki>{{Unbulleted list|Winner|Runner-up|Third place|item1_style=background-color:yellow;|item2_style=background-color:silver;}}</nowiki></code> |
||
| {{Unbulleted list|Winner|Runner-up|Third place|item1_style=background-color:yellow;|item2_style=background-color:silver;}} |
|||
|- |
|||
|} |
|||
| <code><nowiki>{{Unbulleted list|entry1|entry2| }}</nowiki></code> || {{Unbulleted list|entry1|entry2| }} |
|||
|- |
|||
=== Controlling line-breaking === |
|||
| <code><nowiki>{{Unbulleted list|entry1| | }}</nowiki></code> || {{Unbulleted list|entry1| | }} |
|||
Template {{tlx|nbsp}} may be used with {{tlx|wbr}} and {{tlx|nowrap}} to control line-breaking in bulletless lists, to prevent wrapped long entries from being confused with multiple entries. See [[Template:Wbr/doc#Controlling line-breaking in infoboxes]] for details. |
|||
|- |
|||
| <code><nowiki>{{Unbulleted list| |entry2| }}</nowiki></code> || {{Unbulleted list| |entry2| }} |
|||
Wrapping this entire template with {{tlx|nowrap}} causes syntax errors. Use {{para|class|nowrap}} instead. |
|||
|- |
|||
| <code><nowiki>{{Unbulleted list| | |entry3}}}</nowiki></code> || {{Unbulleted list| | |entry3}} |
|||
==Technical details== |
|||
|- |
|||
{{tl|Unbulleted list}} works by constructing a [[span and div|div]] with the [[Cascading Style Sheets|CSS]] class "plainlist" which has the following style (see [[MediaWiki:Common.css]]): |
|||
| <code><nowiki>{{Unbulleted list| | | }}}</nowiki></code> || {{Unbulleted list| | | }} |
|||
<syntaxhighlight lang="css"> |
|||
.plainlist ul { |
|||
line-height: inherit; |
|||
list-style: none none; |
|||
margin: 0; |
|||
} |
|||
.plainlist ul li { |
|||
margin-bottom: 0; |
|||
} |
|||
</syntaxhighlight> |
|||
{| class="wikitable" |
|||
! Wikitext |
|||
! Expanded template |
|||
! HTML |
|||
|- style="vertical-align:top;" |
|||
| class="nowrap | <pre> |
|||
{{Unbulleted list |
|||
| Example 1 |
|||
| Example 2 |
|||
| Example 3 |
|||
}} |
|||
</pre> |
|||
| <syntaxhighlight lang="html"> |
|||
<div class="plainlist"><ul><li>Example 1</li><li>Example 2</li><li>Example 3</li></ul></div> |
|||
</syntaxhighlight> |
|||
| class="nowrap | <syntaxhighlight lang="html"> |
|||
<div class="plainlist"> |
|||
<ul> |
|||
<li>Example 1</li> |
|||
<li>Example 2</li> |
|||
<li>Example 3</li> |
|||
</ul> |
|||
</div> |
|||
</syntaxhighlight> |
|||
|} |
|} |
||
== See also == |
== See also == |
||
* {{tl|plainlist}} – essentially the same but uses <code><nowiki>|* ... * ... * ...</nowiki></code> instead of <code><nowiki>| ... | ... | ...</nowiki></code> |
|||
* {{tl|do list}} |
|||
* {{tl|flatlist}} |
* {{tl|flatlist}} and {{tl|hlist}} (replacements for comma- or dash-separated lists) |
||
* {{tl| |
* {{tl|bulleted list}} |
||
* {{tl| |
* {{tl|ordered list}} |
||
{{Navbox lists}} |
|||
<includeonly>{{Sandbox other|| |
|||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! --> |
|||
[[Category:List formatting and function templates]] |
|||
[[Category:Semantic markup templates]] |
|||
<includeonly> |
}}</includeonly> |
||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS --> |
|||
[[Category: Wikipedia list formatting templates]] |
|||
</includeonly> |
Latest revision as of 15:14, 19 July 2020
File:Edit-copy green.svg | This is a documentation subpage for Template:Unbulleted list. It contains usage information, categories and other content that is not part of the original template page. |
Warning | This template is used on approximately 770,000 pages, or roughly 22958% of all pages To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
- REDIRECT Template:Template shortcut
File:Lua-logo-nolabel.svg | This template uses Lua: |
This template creates unbulleted lists. Each item in the list may have CSS styles added to it individually, by appending a numbered parameter.
Usage
Basic usage
{{unbulleted list|first item|second item|third item|...}}
All parameters
{{unbulleted list |first item|second item|third item|... |class = class |style = style |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 |... }}
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, e.g.plainlinks
.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.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.
Example
Code | Result |
---|---|
{{Unbulleted list|entry1|entry2|entry3|entry4|entry5
|
|
{{Unbulleted list|Winner|Runner-up|Third place|item_style=color:blue;}}
|
|
{{Unbulleted list|Winner|Runner-up|Third place|item1_style=background-color:yellow;|item2_style=background-color:silver;}}
|
|
Controlling line-breaking
Template {{nbsp}}
may be used with {{wbr}}
and {{nowrap}}
to control line-breaking in bulletless lists, to prevent wrapped long entries from being confused with multiple entries. See Template:Wbr/doc#Controlling line-breaking in infoboxes for details.
Wrapping this entire template with {{nowrap}}
causes syntax errors. Use |class=nowrap
instead.
Technical details
{{Unbulleted list}} works by constructing a div with the CSS class "plainlist" which has the following style (see MediaWiki:Common.css):
.plainlist ul {
line-height: inherit;
list-style: none none;
margin: 0;
}
.plainlist ul li {
margin-bottom: 0;
}
Wikitext | Expanded template | HTML |
---|---|---|
{{Unbulleted list | Example 1 | Example 2 | Example 3 }} |
<div class="plainlist"><ul><li>Example 1</li><li>Example 2</li><li>Example 3</li></ul></div>
|
<div class="plainlist">
<ul>
<li>Example 1</li>
<li>Example 2</li>
<li>Example 3</li>
</ul>
</div>
|
See also
- {{plainlist}} – essentially the same but uses
|* ... * ... * ...
instead of| ... | ... | ...
- {{flatlist}} and {{hlist}} (replacements for comma- or dash-separated lists)
- {{bulleted list}}
- {{ordered list}}