Difference between revisions of "Template:DropDownList"

Revision as of 10:26, 27 November 2023

Usage

This template can be transcluded to display a DropDownList. This template had 3 parameters (described below). The Id parameter is very important if you are using 2 DropDownLists on the same page.

Parameters

This template contains 11 parameters for different purposes:

Name

This is the name parameter that shall display the name of the list, defaulting to 'Text'. To set the name parameter type {{DropDownList|Name=Items|Value1=One|Value2=Two|Value3=Three}} which will render as:

As another example, links can also be used as names, as shown below:

Values

The list can hold up to 20 values i.e. the text within the list. To add the values type {{DropDownList|Name=Name|Value1=Hello|Value2=Wikipedia|Value3=Blah!}} and so on until Value20 .

Note that any blank parameters will be omitted when rendering the template.

Id

If you are using more than one DropDownList 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). To set the ID type {{DropDownList|id=Your Id name}}

Colors

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.

{{DropDownList|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.

{{DropDownList|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.

{{DropDownList|border-color=red|Name=Items|Value1=One|Value2=Two|Value3=Three}}

Which will render as:

This can also be set to none to also disable the border.

{{DropDownList|border-color=none|Name=Items|Value1=One|Value2=Two|Value3=Three}}

Which will render as:

Source

This template was borrowed from Wikipedia