<select-multiple>
The <select-multiple> element represents a user input widget that allows multiple selected options. <select-multiple> contains <option> elements.
<form>
<select-multiple name="grade">
<option value="1" selected="true">
<text>1st grade</text>
</option>
<option value="2">
<text>2nd grade</text>
</option>
<option value="3">
<text>3rd grade</text>
</option>
</select-multiple>
</form>
If the user presses "2nd grade", the <option> element with value="2" will get the attribute selected="true", and the first option will remain as selected="true". Pressing either option will change their attribute to selected="true".
Structure
A <select-multiple> element most often appears within a <form> element. However, this is not a requirement, and the element can be used for local interactions that don't get serialized in a form.
Attributes
name
The name of the selection input within a <form> element. This name will be used when serializing a form to form data that gets sent in a server request.
style
| Type | Required |
|---|---|
| string | No |
A space-separated list of styles to apply to the element. See Styles. Note that text style rules cannot be applied to a <select-multiple>.
id
| Type | Required |
|---|---|
| string | No |
A global attribute uniquely identifying the element in the whole document.
hide
| Type | Required |
|---|---|
| false (default), true | No |
If hide="true", the element will not be rendered on screen. If the element or any of the element's children have a behavior that triggers on "load" or "visible", those behaviors will not trigger while the element is hidden.
collapsable
| Type | Required |
|---|---|
| true (default), false | No |
When this element is only used to lay out its children, it may be automatically removed from the native view hierarchy as an optimization. Setting collapsable="false" disables this optimization and ensures the element exists in the native view hierarchy. See the React Native docs for details.
collapsable-children
Setting collapsable-children="false" prevents the direct children of this element from being removed from the native view hierarchy, similar to setting collapsable="false" on each child. See the React Native docs for details.