<select>
Creates a drop-down list. The <select> tag can be populated with lists contained in WebEOC Nexus. The lists are entered using the Lists Manager. To populate a <select> tag with a WebEOC Nexus list, use a list attribute on the <select> tag to set the name of the list.
To include text designed to guide users when selecting options from a list, use defaulttext. By using this attribute, if the user saves the entry with the default option selected, a value is not recorded for this field.
The defaulttext attribute has no effect when used with <option> tags and, therefore, should only be used when a <select> tag is used in conjunction with the list attribute.
Attribute | Allowed Values | Requirements | Description |
---|---|---|---|
defaulttext | Optional | Default option for the value in the drop-down list. | |
name | table column name | Required | Make sure it is a valid identifier. |
list | WebEOC Nexus list name | Optional | Name of a WebEOC Nexus list. |
parent | parent field name | Optional | Name of the parent field for a multi-tier list. |
label | CDATA | Optional | Text of the label for the drop-down list. |
Examples
When using hard-coded <select> lists with <option> tags, each <option> tag must contain a value attribute where the value matches the text between the opening and closing <option> tag. The following is a very basic example of this concept.
<select name="Match">
<option value="1">Not checked yet </option>
<option value="2">Not on List</option>
<option value="3">Further checks required</option>
<option value="4">On List</option>
</select>
For something a bit more advanced, you can use an existing WebEOC Nexus list for options in the drop-down by defining the list within the tag itself.
<select name="Match" list="Match List"/>
A list of all groups and positions for a process permission can be displayed by using two attributes. The processpermission attribute specifies the name of the process permission, and the processgroup attribute specifies whether the list should be populated with WebEOC Nexus groups or positions.
To see all groups for the requesting process permission:
<select name="FieldName" processpermission="Requesting" processgroup="groups">
</select>
To see all positions for the requesting process permission:
<select name="FieldName" processpermission="Requesting" processgroup="positions">
</select>
-
WebEOC Nexus administrators can define multiple levels of lists. Multi-tiered lists are configured using the Lists Manager and then used in boards by manually adding code to the board HTML through the Advanced Board Editor.
-
The example code below can be used to set up multi-tiered lists in a board. In the example, State List is the name of the list. County List and City List are the sub-lists, both part of the parent list.
<select name="StateName" list="State List" />
<select name="CountyName" list="State List" parent="StateName" />
<select name="CityName" list="State List" parent="CountyName" />