View source for Template:Cast listing/doc

{{Documentation subpage}}
{{Lua|Module:List}}
{{Support|Template:Col list}}
__NOTOC__

This template is for use in a cast 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 {{code|30em}}, to change this value (in case names are too long and get pushed to the next line) use {{para|colwidth|#}}. 

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

== Usage ==
{{tj|Cast listing
  | colwidth: 
  | Cast Name 1
  | Cast Name 2
  | Cast Name 3
  ...
  | Cast Name last
}}

== Examples ==
{| style="width: 40%"
|+ '''Example 1 - Normal Usage'''
|- style="vertical-align:middle;"
| style="width: 45%" | 
{{tj|Cast listing
  | Me as myself
  | You as yourself
  | Her as herself
  | Him as himself
  | Them as themselves
}}
| style="text-align: center" | {{Rarr}}
|{{Cast listing
  | Me as myself
  | You as yourself
  | Her as herself
  | Him as himself
  | Them as themselves
}}
|}

{| style="width: 50%"
|+ '''Example 2 - Using {{para|colwidth}}'''
|- style="vertical-align:middle;"
| style="width: 45%" | 
{{tj|Cast listing|colwidth: 10
  | Me as myself
  | You as yourself
  | Her as herself
  | Him as himself
  | Them as themselves
}}
| style="text-align: center" | {{Rarr}}
|{{Cast listing|colwidth = 10
  | Me as myself
  | You as yourself
  | Her as herself
  | Him as himself
  | Them as themselves
}}
|}

{{clear}}

'''An example of a multiple story cast list'''
{| style="width: 50%"
|+ '''Must use {{tlb|blist}} for inside list'''
|- style="vertical-align:middle;"
| style="width: 45%" | 
 {{{tcn|Cast listing}}
  <nowiki>|</nowiki> {{tcp|colwidth}} = {{tcv|20}}
  <nowiki>|</nowiki> <nowiki>'''Story 1 Name'''</nowiki>
  {{{{tcn|blist}}
    <nowiki>|</nowiki> {{tcv|Me as myself}}
    <nowiki>|</nowiki> {{tcv|You as yourself}}
    <nowiki>|</nowiki> {{tcv|Her as herself}}
    <nowiki>|</nowiki> {{tcv|Him as himself}}
    <nowiki>|</nowiki> {{tcv|Them as themselves}} }}
  <nowiki>|</nowiki> <nowiki>'''Story 2 Name'''</nowiki>
  {{{{tcn|blist}}
    <nowiki>|</nowiki> {{tcv|Me as myself}}
    <nowiki>|</nowiki> {{tcv|You as yourself}}
    <nowiki>|</nowiki> {{tcv|Her as herself}}
    <nowiki>|</nowiki> {{tcv|Him as himself}}
    <nowiki>|</nowiki> {{tcv|Them as themselves}} }}
 }}
| style="text-align: center" | {{Rarr}}
|{{Cast listing
  | colwidth = 20
  | '''Story 1 Name'''
  {{blist
    | Me as myself
    | You as yourself
    | Her as herself
    | Him as himself
    | Them as themselves }}
  | '''Story 2 Name'''
  {{blist
    | Me as myself
    | You as yourself
    | Her as herself
    | Him as himself
    | Them as themselves }}
}}
|}

== TemplateData ==
<templatedata>
{
	"description": "Formats a list of voice actor role names 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>


<includeonly>{{sandbox other||{{testcases other||

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