Template:Drop down list/doc
This is a documentation subpage for Template:Drop down list. It may contain usage information, categories and other content that is not part of the original template page. |
Usage
[edit]This template can be transcluded to display a Drop down list. This template had 3 parameters (described below). The Id parameter is very important if you are using 2 drop down lists on the same page.
Parameters
[edit]This template contains 11 parameters for different purposes:
Name
[edit]This is the name parameter that shall display the name of the list, defaults to 'Text'. To set the name parameter type {{Drop down list|Name=Items|Value1=One|Value2=Two|Value3=Three}}
which will render as:
As another examples, links can also be used as names, as shown below:
{{Drop down list|Name=[[WP:TW|TW]]}}
renders as
Values
[edit]The list can hold up to 8 values i.e the text within the list. To add the values type {{Drop down list|Name=Name|Value1=Hello|Value2=Wikipedia|Value3=Blah!}}
and so on until
Value8
.
The values support both Wikilinks and external links i.e you can also type {{Drop down list|Name=Name|Value1=[[Hello]]|Value2=[[Wikipedia|'pedia]]|Value3=[https://www.google.co.in/ Google]}}
which will render as
Note that any blank parameters will be omitted when rendering the template.
Id
[edit]If you are using more than one drop down list on the same page this parameter is very important. The Id parameter for each list should be different and unique (if using more than one on the same page).
Hence the for example
{{Drop down list|Name=text1|id=IdName1|Value1=a|Value2=b|Value3=c}}
{{Drop down list|Name=text2|id=IdName2|Value1=aaaaaaaaaaaaaaaaaaaaa|Value2=bb|Value3=ccccc}}
renders as
Colors
[edit]Additionally, the background and border of the dropdown can also be customized. When either parameter is left blank, it will default to the template's white background and grey-ish border colors.
To change the background color, set a value for the parameter background-color
.
{{Drop down list|background-color=#444654|Name=Items|Value1=One|Value2=Two|Value3=Three}}
Which will render as:
This can be set to none
to effectively disable the background.
{{Drop down list|background-color=none|Name=Items|Value1=One|Value2=Two|Value3=Three}}
which will render as:
Similarly, you can change the border color by setting a value for the parameter border-color
.
{{Drop down list|border-color=black|Name=Items|Value1=One|Value2=Two|Value3=Three}}
which will render as:
This can also be set to none
to also disable the border, for example
{{Drop down list|border-color=none|Name=Items|Value1=One|Value2=Two|Value3=Three}}
will render as: