Update DropdownDoc.vue
parent
5ff00f91ac
commit
0552ee1268
|
@ -119,7 +119,7 @@ export default {
|
||||||
</code></pre>
|
</code></pre>
|
||||||
|
|
||||||
<h5>Properties</h5>
|
<h5>Properties</h5>
|
||||||
<p>Any property as style and class are passed to the main container element. Following are the additional properties to configure the component.</p>
|
<p>Any property of HTMLDivElement are passed to the main container element. Following are the additional properties to configure the component.</p>
|
||||||
<div class="doc-tablewrapper">
|
<div class="doc-tablewrapper">
|
||||||
<table class="doc-table">
|
<table class="doc-table">
|
||||||
<thead>
|
<thead>
|
||||||
|
@ -239,12 +239,6 @@ export default {
|
||||||
<td>false</td>
|
<td>false</td>
|
||||||
<td>When enabled, a clear icon is displayed to clear the value.</td>
|
<td>When enabled, a clear icon is displayed to clear the value.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
|
||||||
<td>tabindex</td>
|
|
||||||
<td>number</td>
|
|
||||||
<td>null</td>
|
|
||||||
<td>Index of the element in tabbing order.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
<tr>
|
||||||
<td>inputId</td>
|
<td>inputId</td>
|
||||||
<td>string</td>
|
<td>string</td>
|
||||||
|
@ -252,10 +246,52 @@ export default {
|
||||||
<td>Identifier of the underlying input element.</td>
|
<td>Identifier of the underlying input element.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>ariaLabelledBy</td>
|
<td>inputStyle</td>
|
||||||
|
<td>any</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Inline style of the input field.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>inputClass</td>
|
||||||
<td>string</td>
|
<td>string</td>
|
||||||
<td>null</td>
|
<td>null</td>
|
||||||
<td>Establishes relationships between the component and label(s) where its value should be one or more element IDs.</td>
|
<td>Style class of the input field.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>inputProps</td>
|
||||||
|
<td>object</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Uses to pass all properties of the HTMLInputElement/HTMLSpanElement to the focusable input element inside the component.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>panelStyle</td>
|
||||||
|
<td>any</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Inline style of the overlay panel.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>panelClass</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Style class of the overlay panel.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>panelProps</td>
|
||||||
|
<td>object</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Uses to pass all properties of the HTMLDivElement to the overlay panel inside the component.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>filterInputProps</td>
|
||||||
|
<td>object</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Uses to pass all properties of the HTMLInputElement to the filter input inside the component.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>clearIconProps</td>
|
||||||
|
<td>object</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Uses to pass all properties of the HTMLElement to the clear icon inside the component.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>appendTo</td>
|
<td>appendTo</td>
|
||||||
|
@ -264,24 +300,6 @@ export default {
|
||||||
<td>A valid query selector or an HTMLElement to specify where the overlay gets attached. Special keywords are "body" for document body
|
<td>A valid query selector or an HTMLElement to specify where the overlay gets attached. Special keywords are "body" for document body
|
||||||
and "self" for the element itself.</td>
|
and "self" for the element itself.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
|
||||||
<td>emptyFilterMessage</td>
|
|
||||||
<td>string</td>
|
|
||||||
<td>No results found</td>
|
|
||||||
<td>Text to display when filtering does not return any results. Defaults to value from PrimeVue locale configuration.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>emptyMessage</td>
|
|
||||||
<td>string</td>
|
|
||||||
<td>No results found</td>
|
|
||||||
<td>Text to display when there are no options available. Defaults to value from PrimeVue locale configuration.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>panelClass</td>
|
|
||||||
<td>string</td>
|
|
||||||
<td>null</td>
|
|
||||||
<td>Style class of the overlay panel.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
<tr>
|
||||||
<td>loading</td>
|
<td>loading</td>
|
||||||
<td>boolean</td>
|
<td>boolean</td>
|
||||||
|
@ -299,6 +317,60 @@ export default {
|
||||||
<td>object</td>
|
<td>object</td>
|
||||||
<td>null</td>
|
<td>null</td>
|
||||||
<td>Whether to use the virtualScroller feature. The properties of <router-link to="/virtualscroller">VirtualScroller</router-link> component can be used like an object in it.</td>
|
<td>Whether to use the virtualScroller feature. The properties of <router-link to="/virtualscroller">VirtualScroller</router-link> component can be used like an object in it.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>autoOptionFocus</td>
|
||||||
|
<td>boolean</td>
|
||||||
|
<td>true</td>
|
||||||
|
<td>Whether to focus on the first visible or selected element when the overlay panel is shown.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>filterMessage</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>{0} results are available</td>
|
||||||
|
<td>Text to be displayed in hidden accessible field when filtering returns any results. Defaults to value from PrimeVue locale configuration.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>selectionMessage</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>{0} items selected</td>
|
||||||
|
<td>Text to be displayed in hidden accessible field when options are selected. Defaults to value from PrimeVue locale configuration.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>emptySelectionMessage</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>No selected item</td>
|
||||||
|
<td>Text to be displayed in hidden accessible field when any option is not selected. Defaults to value from PrimeVue locale configuration.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>emptyFilterMessage</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>No results found</td>
|
||||||
|
<td>Text to be displayed when filtering does not return any results. Defaults to value from PrimeVue locale configuration.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>emptyMessage</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>No results found</td>
|
||||||
|
<td>Text to be displayed when there are no options available. Defaults to value from PrimeVue locale configuration.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>tabindex</td>
|
||||||
|
<td>number</td>
|
||||||
|
<td>0</td>
|
||||||
|
<td>Index of the element in tabbing order.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>ariaLabel</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Defines a string value that labels an interactive element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>ariaLabelledby</td>
|
||||||
|
<td>string</td>
|
||||||
|
<td>null</td>
|
||||||
|
<td>Establishes relationships between the component and label(s) where its value should be one or more element IDs.</td>
|
||||||
</tr>
|
</tr>
|
||||||
</tbody>
|
</tbody>
|
||||||
</table>
|
</table>
|
||||||
|
@ -322,9 +394,14 @@ export default {
|
||||||
<td>Callback to invoke on value change.</td>
|
<td>Callback to invoke on value change.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>input</td>
|
<td>focus</td>
|
||||||
<td>event</td>
|
<td>event</td>
|
||||||
<td>Callback to invoke on value change.</td>
|
<td>Callback to invoke when the component receives focus.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>blur</td>
|
||||||
|
<td>event</td>
|
||||||
|
<td>Callback to invoke when the component loses focus.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>before-show</td>
|
<td>before-show</td>
|
||||||
|
@ -346,16 +423,6 @@ export default {
|
||||||
<td>-</td>
|
<td>-</td>
|
||||||
<td>Callback to invoke when the overlay is hidden.</td>
|
<td>Callback to invoke when the overlay is hidden.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
|
||||||
<td>focus</td>
|
|
||||||
<td>event</td>
|
|
||||||
<td>Callback to invoke when the component receives focus.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>blur</td>
|
|
||||||
<td>event</td>
|
|
||||||
<td>Callback to invoke when the component loses focus.</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
<tr>
|
||||||
<td>filter</td>
|
<td>filter</td>
|
||||||
<td>event.originalEvent: Original event <br />
|
<td>event.originalEvent: Original event <br />
|
||||||
|
@ -384,7 +451,7 @@ export default {
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>hide</td>
|
<td>hide</td>
|
||||||
<td>-</td>
|
<td>isFocus: Decides whether to focus on the component. Default value is false.</td>
|
||||||
<td>Hides the overlay.</td>
|
<td>Hides the overlay.</td>
|
||||||
</tr>
|
</tr>
|
||||||
</tbody>
|
</tbody>
|
||||||
|
@ -401,21 +468,15 @@ export default {
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
<tr>
|
|
||||||
<td>option</td>
|
|
||||||
<td>option: Option instance <br />
|
|
||||||
index: Index of the option</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>optiongroup</td>
|
|
||||||
<td>option: OptionGroup instance <br />
|
|
||||||
index: Index of the option group</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
<tr>
|
||||||
<td>value</td>
|
<td>value</td>
|
||||||
<td>value: Value of the component <br />
|
<td>value: Value of the component <br />
|
||||||
placeholder: Placeholder prop value</td>
|
placeholder: Placeholder prop value</td>
|
||||||
</tr>
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>indicator</td>
|
||||||
|
<td>-</td>
|
||||||
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>header</td>
|
<td>header</td>
|
||||||
<td>value: Value of the component <br />
|
<td>value: Value of the component <br />
|
||||||
|
@ -426,6 +487,16 @@ export default {
|
||||||
<td>value: Value of the component <br />
|
<td>value: Value of the component <br />
|
||||||
options: Displayed options</td>
|
options: Displayed options</td>
|
||||||
</tr>
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>option</td>
|
||||||
|
<td>option: Option instance <br />
|
||||||
|
index: Index of the option</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>optiongroup</td>
|
||||||
|
<td>option: OptionGroup instance <br />
|
||||||
|
index: Index of the option group</td>
|
||||||
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>emptyfilter</td>
|
<td>emptyfilter</td>
|
||||||
<td>-</td>
|
<td>-</td>
|
||||||
|
@ -444,10 +515,6 @@ export default {
|
||||||
<tr>
|
<tr>
|
||||||
<td>loader</td>
|
<td>loader</td>
|
||||||
<td>options: Options of the loader items for virtualscroller</td>
|
<td>options: Options of the loader items for virtualscroller</td>
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>indicator</td>
|
|
||||||
<td>-</td>
|
|
||||||
</tr>
|
</tr>
|
||||||
</tbody>
|
</tbody>
|
||||||
</table>
|
</table>
|
||||||
|
@ -501,13 +568,192 @@ export default {
|
||||||
<td>Filter element.</td>
|
<td>Filter element.</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td>p-dropdown-open</td>
|
<td>p-overlay-open</td>
|
||||||
<td>Container element when overlay is visible.</td>
|
<td>Container element when overlay is visible.</td>
|
||||||
</tr>
|
</tr>
|
||||||
</tbody>
|
</tbody>
|
||||||
</table>
|
</table>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<h5>Accessibility</h5>
|
||||||
|
<h6>Screen Reader</h6>
|
||||||
|
<p>Value to describe the component can either be provided with <i>aria-labelledby</i> or <i>aria-label</i> props. The dropdown element has a <i>combobox</i> role
|
||||||
|
in addition to <i>aria-haspopup</i> and <i>aria-expanded</i> attributes. If the editable option is enabled <i>aria-autocomplete</i> is also added.
|
||||||
|
The relation between the combobox and the popup is created with <i>aria-controls</i> and <i>aria-activedescendant</i> attribute is used
|
||||||
|
to instruct screen reader which option to read during keyboard navigation within the popup list.</p>
|
||||||
|
<p>The popup list has an id that refers to the <i>aria-controls</i> attribute of the <i>combobox</i> element and uses <i>listbox</i> as the role. Each list item has an <i>option</i> role, an id to match the <i>aria-activedescendant</i> of the input element along with <i>aria-label</i>, <i>aria-selected</i> and <i>aria-disabled</i> attributes.</p>
|
||||||
|
|
||||||
|
<p>If filtering is enabled, <i>filterInputProps</i> can be defined to give <i>aria-*</i> props to the filter input element.</p>
|
||||||
|
<pre v-code><code>
|
||||||
|
<span id="dd1">Options</span>
|
||||||
|
<Dropdown aria-labelledby="dd1" />
|
||||||
|
|
||||||
|
<Dropdown aria-label="Options" />
|
||||||
|
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<h6>Closed State Keyboard Support</h6>
|
||||||
|
<div className="doc-tablewrapper">
|
||||||
|
<table className="doc-table">
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Key</th>
|
||||||
|
<th>Function</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td><i>tab</i></td>
|
||||||
|
<td>Moves focus to the dropdown element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>space</i></td>
|
||||||
|
<td>Opens the popup and moves visual focus to the selected option, if there is none then first option receives the focus.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>enter</i></td>
|
||||||
|
<td>Opens the popup and moves visual focus to the selected option, if there is none then first option receives the focus.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>down arrow</i></td>
|
||||||
|
<td>Opens the popup and moves visual focus to the selected option, if there is none then first option receives the focus.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>up arrow</i></td>
|
||||||
|
<td>Opens the popup and moves visual focus to the selected option, if there is none then last option receives the focus.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>any printable character</i></td>
|
||||||
|
<td>Opens the popup and moves focus to the option whose label starts with the characters being typed, if there is none and dropdown is not editable then first option receives the focus.</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<h6>Popup Keyboard Support</h6>
|
||||||
|
<div className="doc-tablewrapper">
|
||||||
|
<table className="doc-table">
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Key</th>
|
||||||
|
<th>Function</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td><i>tab</i></td>
|
||||||
|
<td>Moves focus to the next focusable element in the popup. If there is none, the focusable option is selected and the overlay is closed then moves focus to next element in page.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>shift</i> + <i>tab</i></td>
|
||||||
|
<td>Moves focus to the previous focusable element in the popup. If there is none, the focusable option is selected and the overlay is closed then moves focus to next element in page.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>enter</i></td>
|
||||||
|
<td>Selects the focused option and closes the popup, then moves focus to the dropdown element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>space</i></td>
|
||||||
|
<td>Selects the focused option and closes the popup, then moves focus to the dropdown element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>escape</i></td>
|
||||||
|
<td>Closes the popup, then moves focus to the dropdown element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>down arrow</i></td>
|
||||||
|
<td>Moves focus to the next option, if there is none then visual focus does not change.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>up arrow</i></td>
|
||||||
|
<td>Moves focus to the previous option, if there is none then visual focus does not change.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>alt</i> + <i>up arrow</i></td>
|
||||||
|
<td>Selects the focused option and closes the popup, then moves focus to the dropdown element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>left arrow</i></td>
|
||||||
|
<td>If the dropdown is editable, removes the visual focus from the current option and moves input cursor to one character left.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>right arrow</i></td>
|
||||||
|
<td>If the dropdown is editable, removes the visual focus from the current option and moves input cursor to one character right.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>home</i></td>
|
||||||
|
<td>If the dropdown is editable, moves input cursor at the end, if not then moves focus to the first option.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>end</i></td>
|
||||||
|
<td>If the dropdown is editable, moves input cursor at the beginning, if not then moves focus to the last option.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>pageUp</i></td>
|
||||||
|
<td>Jumps visual focus to first option.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>pageDown</i></td>
|
||||||
|
<td>Jumps visual focus to last option.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>any printable character</i></td>
|
||||||
|
<td>Moves focus to the option whose label starts with the characters being typed if dropdown is not editable.</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<h6>Filter Input Keyboard Support</h6>
|
||||||
|
<div className="doc-tablewrapper">
|
||||||
|
<table className="doc-table">
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Key</th>
|
||||||
|
<th>Function</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td><i>down arrow</i></td>
|
||||||
|
<td>Moves focus to the next option, if there is none then visual focus does not change.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>up arrow</i></td>
|
||||||
|
<td>Moves focus to the previous option, if there is none then visual focus does not change.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>left arrow</i></td>
|
||||||
|
<td>Removes the visual focus from the current option and moves input cursor to one character left.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>right arrow</i></td>
|
||||||
|
<td>Removes the visual focus from the current option and moves input cursor to one character right.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>home</i></td>
|
||||||
|
<td>Moves input cursor at the end, if not then moves focus to the first option.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>end</i></td>
|
||||||
|
<td>Moves input cursor at the beginning, if not then moves focus to the last option.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>enter</i></td>
|
||||||
|
<td>Closes the popup and moves focus to the dropdown element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>escape</i></td>
|
||||||
|
<td>Closes the popup and moves focus to the dropdown element.</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><i>tab</i></td>
|
||||||
|
<td>Moves focus to the next focusable element in the popup. If there is none, the focusable option is selected and the overlay is closed then moves focus to next element in page.</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
|
||||||
<h5>Dependencies</h5>
|
<h5>Dependencies</h5>
|
||||||
<p>None.</p>
|
<p>None.</p>
|
||||||
</AppDoc>
|
</AppDoc>
|
||||||
|
|
Loading…
Reference in New Issue