Template:Listing/doc: Difference between revisions

From HIBIKIFORUM
Jump to navigation Jump to search
m (Protected "Template:Listing/doc" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
mNo edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Documentation subpage}}
{{Documentation subpage}}
{{template rating|p}}
{{Support|Template:Col list}}
<!-- PLEASE ADD CATEGORIES AT THE END OF THIS PAGE -->
__NOTOC__


This template is for use in a list. It automatically breaks the available screen space into equal parts, meaning, for instance, that it is not necessary to guess how many columns to use and then figure out the dividing point(s), e.g., the halfway point to divide the list into two columns, or the one-third and two-thirds points to divide the list into three columns. The default value for the column width is 30em, to change this value use <code>colwidth=#em|</code>.
This template is used to create a multiple column list. It automatically breaks the available screen space into equal parts, meaning, for instance, that it is not necessary to guess how many columns to use and then figure out the dividing point(s), e.g., the halfway point to divide the list into two columns, or the one-third and two-thirds points to divide the list into three columns. The default value for the column width is 30em, to change this value use {{para|colwidth|#}}.


== Use ==
== Notice ==
This template uses [[Wikipedia:CSS|CSS]]3 multiple column layout and is not supported by all [[Wikipedia:WWW|Web]] [[Wikipedia:Web browser|browsers]].
This template uses [[Wikipedia:CSS|CSS]]3 multiple column layout and is not supported by all [[Wikipedia:WWW|Web]] [[Wikipedia:Web browser|browsers]].


=== Examples ===
== Usage ==
Here is an example:
{{tj|Listing
<pre>{{Listing|
  | colwidth:
* Apple
  | List Item 1
* Pear
  | List Item 2
* Tomato
  | List Item 3
* Green Bean
  ...
* Corn
  | List Item last
}}
}}
</pre>


which would render as:
== Examples ==
{{Listing|
<div style="float:right;width:45%">
* Apple
{{space}}
* Pear
{{Listing
* Tomato
  | Apple
* Green Bean
  | Pear
* Corn
  | Tomato
}}
  | Green Bean
  | Corn
}}</div>
 
{{Pre|width=25%|
{{tj|Listing
  | Apple
  | Pear
  | Tomato
  | Green Bean
  | Corn
}} }}
{{clear}}
 
'''An example using {{para|colwidth}}'''
<div style="float:right;width:45%">
{{space}}
{{Listing|colwidth = 10
  | Apple
  | Pear
  | Tomato
  | Green Bean
  | Corn
}}</div>
 
{{Pre|width=25%|
{{tj|Listing
  | colwidth: 10
  | Apple
  | Pear
  | Tomato
  | Green Bean
  | Corn
}} }}
{{clear}}
 
'''An example of a list inside a list''' - Must use {{tl|blist}} for inside list.
<div style="float:right;width:50%">
{{space}}
{{Listing|colwidth = 20
  | '''Fruits'''
  {{blist
    | Apple
    | Pear
    | Strawberry
    | Mango
    | Orange }}
  | '''Vegetables'''
  {{blist
    | Cauliflower
    | Broccoli
    | Green Bean
    | Cabbage
    | Acorn squash }}
}}</div>
 
{{Pre|width=25%|{{{{fcb|#4169e1|Cast listing}}
  | {{fcb|#2e8b57|colwidth}} {{=}} {{fc|#933|20}}
  | {{fc|#933|<nowiki>'''Fruits'''</nowiki>}}
  {{((}}{{fcb|#4169e1|blist}}
    | {{fc|#933|Apple}}
    | {{fc|#933|Pear}}
    | {{fc|#933|Strawberry}}
    | {{fc|#933|Mango}}
    | {{fc|#933|Orange}} {{))}}
  | {{fc|#933|<nowiki>'''Vegetables'''</nowiki>}}
  {{((}}{{fcb|#4169e1|blist}}
    | {{fc|#933|Cauliflower}}
    | {{fc|#933|Broccoli}}
    | {{fc|#933|Green Bean}}
    | {{fc|#933|Cabbage}}
    | {{fc|#933|Acorn squash}} {{))}}
}} }}
 
== TemplateData ==
<templatedata>
{
"description": "Formats a list into columns that automatically space for the given screen size.",
"params": {
"colwidth": {
"label": "Column Width",
"description": "To increase the width of the columns manually, so as to avoid names from breaking into multiple lines.",
"type": "number",
"default": "30",
"required": false
}
}
}
</templatedata>


An example using <code>colwidth</code>
<pre>{{Listing|colwidth=15em|
* Apple
* Pear
* Tomato
* Green Bean
* Corn
}}
</pre>


which would render as:
<includeonly>{{sandbox other||{{testcases other||
{{Listing|colwidth=15em|
* Apple
* Pear
* Tomato
* Green Bean
* Corn
}}


<includeonly>
<!-- Categories below this line, please -->
<!-- Categories below this line, please -->
</includeonly>
[[Category:List templates]]
[[Category:General use templates]]
}}}}</includeonly>

Latest revision as of 03:36, 20 August 2023

Light bulb.png }}
It contains usage information, categories and other content that is not part of the original template page.


This template is used to create a multiple column list. It automatically breaks the available screen space into equal parts, meaning, for instance, that it is not necessary to guess how many columns to use and then figure out the dividing point(s), e.g., the halfway point to divide the list into two columns, or the one-third and two-thirds points to divide the list into three columns. The default value for the column width is 30em, to change this value use |colwidth=#.

Notice

This template uses CSS3 multiple column layout and is not supported by all Web browsers.

Usage

{{Listing
| colwidth =
| List Item 1
| List Item 2
| List Item 3 ...
| List Item last
}}

Examples

 

  • Apple
  • Pear
  • Tomato
  • Green Bean
  • Corn
{{Listing
| Apple
| Pear
| Tomato
| Green Bean
| Corn
}}

An example using |colwidth=

 

  • Apple
  • Pear
  • Tomato
  • Green Bean
  • Corn
{{Listing
| colwidth = 10
| Apple
| Pear
| Tomato
| Green Bean
| Corn
}}

An example of a list inside a list - Must use {{blist}} for inside list.

 

  • Fruits
    • Apple
    • Pear
    • Strawberry
    • Mango
    • Orange
  • Vegetables
    • Cauliflower
    • Broccoli
    • Green Bean
    • Cabbage
    • Acorn squash
{{Cast listing
  | colwidth = 20
  | '''Fruits'''
  {{blist
    | Apple
    | Pear
    | Strawberry
    | Mango
    | Orange }}
  | '''Vegetables'''
  {{blist
    | Cauliflower
    | Broccoli
    | Green Bean
    | Cabbage
    | Acorn squash }}
}}

TemplateData

Formats a list into columns that automatically space for the given screen size.

Template parameters

ParameterDescriptionTypeStatus
Column Widthcolwidth

To increase the width of the columns manually, so as to avoid names from breaking into multiple lines.

Default
30
Numberoptional