Jump to content

Template:Plainlist/doc: Difference between revisions

From pool
[checked revision][checked revision]
Content deleted Content added
Created page with "{{Documentation subpage}} <!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE --> {{#ifeq:{{FULLPAGENAME}} | Template:Plainlist | {{high-risk| 171000+ }} }} This template p..."
 
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{#ifeq:{{FULLPAGENAME}} | Template:Plainlist | {{high-risk| 171000+ }} }}
{{#ifeq:{{FULLPAGENAME}} | Template:Plainlist | {{high-risk} }}
{{Commons Import}}


This template provides a [[Web Content Accessibility Guidelines|WCAG]]/ISO-standards-compliant accessible alternative to <code><nowiki><br /></nowiki></code> separated lists, per [[WP:UBLIST]] and [[WP:PLIST]]
This template provides a [[Wikipedia:Web Content Accessibility Guidelines|WCAG]]/ISO-standards-compliant accessible alternative to <code><nowiki><br /></nowiki></code> separated lists, per [[Wikipedia:WP:UBLIST]] and [[Wikipedia:WP:PLIST]]


==Usage==
==Usage==
Line 9: Line 10:


{{plainlist|
{{plainlist|
* [[cat]]
* [[Wikipedia:cat|cat]]
* [[dog]]
* [[Wikipedia:dog|dog]]
* [[horse]]
* [[Wikipedia:horse|horse]]
* [[cow]]
* [[Wikipedia:cow|cow]]
* [[sheep]]
* [[Wikipedia:sheep|sheep]]
* [[pig]]
* [[Wikipedia:pig|]
}}
}}


It uses proper HTML list markup, which is more standards-compliant and more accessible than separating list items with {{tag|br|s}}. Detailed reasons for using this template can be found at [[WP:UBLIST]].
It uses proper HTML list markup, which is more standards-compliant and more accessible than separating list items with {{tag|br|s}}. Detailed reasons for using this template can be found at [[Wikipedia:WP:UBLIST]].


This template can be used with or without {{tl|endplainlist}}. It is an alternative to {{tl|unbulleted list}}, which performs the same function in a more concise but less wiki-style manner. Note that {{tl|unbulleted list}} will work inside image captions, whereas {{tl|plainlist}} does not.
This template can be used with or without {{tl|endplainlist}}. It is an alternative to {{tl|unbulleted list}}, which performs the same function in a more concise but less wiki-style manner. Note that {{tl|unbulleted list}} will work inside image captions, whereas {{tl|plainlist}} does not.
Line 35: Line 36:
|
|
{{plainlist|
{{plainlist|
* [[cat]]
* [[Wikipedia:cat|cat]]
* [[dog]]
* [[Wikipedia:dog|dog]]
* [[horse]]
* [[Wikipedia:horse|horse]]
* [[cow]]
* [[Wikipedia:cow|cow]]
* [[sheep]]
* [[Wikipedia:sheep|sheep]]
* [[pig]]
* [[Wikipedia:pig|pig]]
}}
}}
}}
}}
Line 57: Line 58:
|
|
{{plainlist}}
{{plainlist}}
* [[cat]]
* [[Wikipedia:cat|cat]]
* [[dog]]
* [[Wikipedia:dog|dog]]
* [[horse]]
* [[Wikipedia:horse|horse]]
* [[cow]]
* [[Wikipedia:cow|cow]]
* [[sheep]]
* [[Wikipedia:sheep|sheep]]
* [[pig]]
* [[Wikipedia:pig|pig]]
{{endplainlist}}
{{endplainlist}}
}}
}}
Line 83: Line 84:
"style": {
"style": {
"label": "Custom CSS",
"label": "Custom CSS",
"description": "Adds CSS style options. Complex styles should not be used in articles (per [[WP:Deviations]]) but may be acceptable on user, project, and talk pages.",
"description": "Adds CSS style options. Complex styles should not be used in articles (per [[Wikipedia:WP:Deviations]]) but may be acceptable on user, project, and talk pages.",
"example": "border:solid 1px silver; background:lightyellow"
"example": "border:solid 1px silver; background:lightyellow"
},
},
Line 93: Line 94:
}
}
},
},
"description": "This template provides a WCAG/ISO-standards-compliant accessible alternative to &lt;br /&gt; separated lists, per [[WP:UBLIST]] and [[WP:PLIST]]. It uses proper HTML list markup, which is more standards-compliant and more accessible than separating list items with &lt;br /&gt;. Detailed reasons for using this template can be found at WP:UBLIST."
"description": "This template provides a WCAG/ISO-standards-compliant accessible alternative to &lt;br /&gt; separated lists, per [[Wikipedia:WP:UBLIST]] and [[Wikipedia:WP:PLIST]]. It uses proper HTML list markup, which is more standards-compliant and more accessible than separating list items with &lt;br /&gt;. Detailed reasons for using this template can be found at WP:UBLIST."
} }}
} }}


Line 100: Line 101:


==Technical details==
==Technical details==
{{tl|Plainlist}} 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]]):
{{tl|Plainlist}} works by constructing a [[span and div|div]] with the [[Wikipedia:Cascading Style Sheets|CSS]] class "plainlist" which has the following style (see [[MediaWiki:Common.css]]):
<syntaxhighlight lang="css">
<syntaxhighlight lang="css">
.plainlist ul {
.plainlist ul {

Latest revision as of 14:56, 31 October 2020

{{#ifeq:Template:Plainlist/doc | Template:Plainlist | {{high-risk} }}


This template provides a WCAG/ISO-standards-compliant accessible alternative to <br /> separated lists, per Wikipedia:WP:UBLIST and Wikipedia:WP:PLIST

Usage

{{plainlist}} starts a plain (i.e. unbulleted) list, such as:

{{plainlist|

}}

It uses proper HTML list markup, which is more standards-compliant and more accessible than separating list items with <br />. Detailed reasons for using this template can be found at Wikipedia:WP:UBLIST.

This template can be used with or without {{endplainlist}}. It is an alternative to {{unbulleted list}}, which performs the same function in a more concise but less wiki-style manner. Note that {{unbulleted list}} will work inside image captions, whereas {{plainlist}} does not.

Examples

Markup Renders as
{{plainlist|
* [[cat]]
* [[dog]]
* [[horse]]
* [[cow]]
* [[sheep]]
* [[pig]]
}}

Alternative syntax

Markup Renders as
{{plainlist}}
* [[cat]]
* [[dog]]
* [[horse]]
* [[cow]]
* [[sheep]]
* [[pig]]
{{endplainlist}}

Parameters

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Plainlist/doc

This template provides a WCAG/ISO-standards-compliant accessible alternative to <br /> separated lists, per Wikipedia:WP:UBLIST and Wikipedia:WP:PLIST. It uses proper HTML list markup, which is more standards-compliant and more accessible than separating list items with <br />. Detailed reasons for using this template can be found at WP:UBLIST.
ParameterDescriptionTypeStatus
List content1
If supplied, the list, as a normal bulleted list. (Every line should start with an asterisk. No blank lines between lines.) See template page for how this works otherwise.
Contentsuggested
CSS classesclass
Adds a CSS class to the containing div.
Default
The class "plainlist" is always applied.
Stringoptional
Custom CSSstyle
Adds CSS style options. Complex styles should not be used in articles (per Wikipedia:WP:Deviations) but may be acceptable on user, project, and talk pages.
Example
border:solid 1px silver; background:lightyellow
Unknownoptional
Indent levelindent
Indents the list by a number of standard indents (one indent being 1.6em), particularly handy for inclusion in an indented discussion thread.
Example
2
Numberoptional

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 for details.

Technical details

{{Plainlist}} 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
{{Plainlist|
* Example 1
* Example 2
* Example 3
}}
<div class="plainlist " >
* Example 1
* Example 2
* Example 3

</div>
<div class="plainlist">
<ul>
<li>Example 1</li>
<li>Example 2</li>
<li>Example 3</li>
</ul>
</div>

Redirects

See also