Help:DropDown

The `<dropdown>` tag creates an interactive dropdown menu that displays data from a DataTable2 table, allowing you to select a row.

Syntax

The `<dropdown>` tag supports these attributes:

`table`: (Required) The name of the DataTable2 table to display.
`title`: (Optional) The label shown when no item is selected. Defaults to "Select".
`label_column`: (Optional) The table column to use as the display label. Defaults to the first column.
`default`: (Optional) Which item is selected by default (e.g. default=Apple)
`default-index`: (Optional) The zero-based index of the default selected item (takes precedence over `default`).

Basic syntax:

<dropdown table="TableName" title="Choose an option" label_column="ColumnName" default="DefaultLabel" default-index="0" />

Usage

1. Use the `<dropdown>` tag in your wikitext, specifying the `table` attribute with the name of a DataTable2 table. 2. Optionally, customize the dropdown with `title`, `label_column`, `default`, or `default-index`.

The dropdown shows values from the specified column (or the first column by default). Selecting an item makes the row's data available to RiskDisplay elements on the page.

Examples

Basic Dropdown

Display a dropdown using the "Fruits" table, showing the "Name" column:

<dropdown table="Fruits" title="Select a fruit" label_column="Name" />

This lists values like "Apple", "Banana", and "Orange" if they exist in the "Name" column.

Dropdown with Default Selection

Set "Banana" as the default selected item:

<dropdown table="Fruits" title="Select a fruit" label_column="Name" default="Banana" />

Dropdown with Default Index

Select the second item (index 1) by default:

<dropdown table="Fruits" title="Select a fruit" label_column="Name" default-index="1" />

Fully-Qualified Table Name

For a table on a subpage (e.g., "Data:Fruits" under "Market"):

<dropdown table="Market/Data:Fruits" title="Select a fruit" label_column="Name" />

Notes

The `table` attribute can be a simple name (e.g., "Fruits"), a page-specific name (e.g., "Market:Fruits"), or a subpage (e.g., "Market/Data:Fruits"). The system searches the current page and its "Data/" subpage if needed.
If the table is empty or not found, an error message will appear (e.g., "dropdown: empty DataTable2 table Fruits").
Ensure `label_column` matches a column in the table, or an error will list valid columns.
The dropdown's width adjusts automatically based on the longest label or title.

Troubleshooting

**Error: "dropdown: missing table attribute"** – Ensure the `table` attribute is included.
**Error: "dropdown: cannot find DataTable2 table"** – Verify the table exists and the name is correct (check for typos or incorrect page/subpage paths).
**Error: "dropdown: no column named X"** – Confirm `label_column` matches a column in the table.
**Dropdown appears empty** – Check that the DataTable2 table contains data and is properly formatted.