Update CascadeSelectDoc.vue

pull/2639/head
mertsincan 2022-08-07 23:49:29 +01:00
parent f66fc40c3c
commit fc9edc7bab
1 changed files with 242 additions and 131 deletions

View File

@ -164,6 +164,12 @@ data() {
<td>null</td> <td>null</td>
<td>Property name or getter function to use as the value of an option, defaults to the option itself when not defined.</td> <td>Property name or getter function to use as the value of an option, defaults to the option itself when not defined.</td>
</tr> </tr>
<tr>
<td>optionDisabled</td>
<td>string | function</td>
<td>null</td>
<td>Property name or getter function to use as the disabled flag of an option, defaults to false when not defined.</td>
</tr>
<tr> <tr>
<td>optionGroupLabel</td> <td>optionGroupLabel</td>
<td>string | function</td> <td>string | function</td>
@ -195,10 +201,46 @@ data() &#123;
<td>A property to uniquely identify an option.</td> <td>A property to uniquely identify an option.</td>
</tr> </tr>
<tr> <tr>
<td>tabindex</td> <td>inputId</td>
<td>number</td> <td>string</td>
<td>null</td> <td>null</td>
<td>Index of the element in tabbing order.</td> <td>Identifier of the underlying input element.</td>
</tr>
<tr>
<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>null</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.</td>
</tr> </tr>
<tr> <tr>
<td>appendTo</td> <td>appendTo</td>
@ -220,40 +262,64 @@ data() &#123;
<td>Icon to display in loading state.</td> <td>Icon to display in loading state.</td>
</tr> </tr>
<tr> <tr>
<td>inputId</td> <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>searchLocale</td>
<td>string</td>
<td>undefined</td>
<td>Locale to use in searching. The default locale is the host environment's current locale.</td>
</tr>
<tr>
<td>searchMessage</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>emptySearchMessage</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 available options</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>aria-label</td>
<td>string</td> <td>string</td>
<td>null</td> <td>null</td>
<td>Identifier of the underlying input element.</td> <td>Defines a string value that labels an interactive element.</td>
</tr> </tr>
<tr> <tr>
<td>inputProps</td> <td>aria-labelledby</td>
<td>object</td>
<td>null</td>
<td></td>
</tr>
<tr>
<td>inputClass</td>
<td>any</td>
<td>null</td>
<td>Style class of the input field.</td>
</tr>
<tr>
<td>inputStyle</td>
<td>any</td>
<td>null</td>
<td>Inline style of the input field.</td>
</tr>
<tr>
<td>panelClass</td>
<td>string</td> <td>string</td>
<td>null</td> <td>null</td>
<td>Style class of the overlay panel.</td> <td>Establishes relationships between the component and label(s) where its value should be one or more element IDs.</td>
</tr>
<tr>
<td>panelProps</td>
<td>object</td>
<td>null</td>
<td></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -276,6 +342,21 @@ data() &#123;
event.value: Selected option value </td> event.value: Selected option value </td>
<td>Callback to invoke on value change.</td> <td>Callback to invoke on value change.</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>
<td>click</td>
<td>event</td>
<td>Callback to invoke on click.</td>
</tr>
<tr> <tr>
<td>group-change</td> <td>group-change</td>
<td>event.originalEvent: Original event <br /> <td>event.originalEvent: Original event <br />
@ -371,13 +452,16 @@ data() &#123;
<tr> <tr>
<td>p-cascadeselect-item</td> <td>p-cascadeselect-item</td>
<td>An item in the list.</td> <td>An item in the list.</td>
</tr>
<tr>
<td>p-overlay-open</td>
<td>Container element when overlay is visible.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
</div> </div>
<h5>Accessibility</h5> <h5>Accessibility</h5>
<DevelopmentSection>
<h6>Screen Reader</h6> <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 cascadeselect element has a <i>combobox</i> role <p>Value to describe the component can either be provided with <i>aria-labelledby</i> or <i>aria-label</i> props. The cascadeselect element has a <i>combobox</i> role
in addition to <i>aria-haspopup</i> and <i>aria-expanded</i> attributes. The relation between the combobox and the popup is created with <i>aria-controls</i> that refers to the id of the popup.</p> in addition to <i>aria-haspopup</i> and <i>aria-expanded</i> attributes. The relation between the combobox and the popup is created with <i>aria-controls</i> that refers to the id of the popup.</p>
@ -410,10 +494,22 @@ data() &#123;
<td><i>space</i></td> <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> <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>
<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> <tr>
<td><i>down arrow</i></td> <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> <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>
<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 then first option receives the focus.</td>
</tr>
</tbody> </tbody>
</table> </table>
</div> </div>
@ -430,7 +526,7 @@ data() &#123;
<tbody> <tbody>
<tr> <tr>
<td><i>tab</i></td> <td><i>tab</i></td>
<td>Hides the popup and moves focus to the next tabbable element.</td> <td>Hides the popup and moves focus to the next tabbable element. 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>
<tr> <tr>
<td><i>shift</i> + <i>tab</i></td> <td><i>shift</i> + <i>tab</i></td>
@ -456,6 +552,10 @@ data() &#123;
<td><i>up arrow</i></td> <td><i>up arrow</i></td>
<td>Moves focus to the previous option.</td> <td>Moves focus to the previous option.</td>
</tr> </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 cascadeselect element.</td>
</tr>
<tr> <tr>
<td><i>right arrow</i></td> <td><i>right arrow</i></td>
<td>If option is closed, opens the option otherwise moves focus to the first child option.</td> <td>If option is closed, opens the option otherwise moves focus to the first child option.</td>
@ -464,10 +564,21 @@ data() &#123;
<td><i>left arrow</i></td> <td><i>left arrow</i></td>
<td>If option is open, closes the option otherwise moves focus to the parent option.</td> <td>If option is open, closes the option otherwise moves focus to the parent option.</td>
</tr> </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>any printable character</i></td>
<td>Moves focus to the option whose label starts with the characters being typed.</td>
</tr>
</tbody> </tbody>
</table> </table>
</div> </div>
</DevelopmentSection>
<h5>Dependencies</h5> <h5>Dependencies</h5>
<p>None.</p> <p>None.</p>