Template:Unbulleted list/doc: Difference between revisions
From Video Credit Archive
Content deleted Content added
imported>ساجد امجد ساجد No edit summary |
imported>Jonesey95 →Controlling line-breaking: class=nowrap |
||
(40 intermediate revisions by 22 users not shown) | |||
Line 1:
{{Documentation subpage}}
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
{{High-use| 635585 }}
{{Template shortcuts|ubl|ubt|ublist|unbullet}}
{{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 ==
'''Basic usage'''
{{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>
}}
===
* 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"
! style="width: 80%;" | Code !! Result
|-
| <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|Winner|Runner-up|Third place|
| {{Unbulleted list|Winner|Runner-up|Third place|
|-
| <code><nowiki>{{Unbulleted list|Winner|Runner-up|Third place|
| {{Unbulleted list|Winner|Runner-up|Third place|
|}
=== Controlling line-breaking ===
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.
Wrapping this entire template with {{tlx|nowrap}} causes syntax errors. Use {{para|class|nowrap}} instead.
==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]]):
<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 ==
* {{tl|plainlist}} – essentially the same but uses <code><nowiki>|* ... * ... * ...</nowiki></code> instead of <code><nowiki>| ... | ... | ...</nowiki></code>
* {{tl|flatlist}} and {{tl|hlist}} (replacements for comma- or dash-separated lists)
* {{tl|
* {{tl|
{{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>
|
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}}