diff --git a/.gitignore b/.gitignore index 3dad9362074..8ef0b049cd6 100644 --- a/.gitignore +++ b/.gitignore @@ -12,7 +12,6 @@ coverage/ reports/ .nyc_output/ tmp/ -docs/ dist/ lib/ es/ diff --git a/website/docs/components/combo_box.mdx b/website/docs/components/combo_box.mdx new file mode 100644 index 00000000000..d299ba1e0eb --- /dev/null +++ b/website/docs/components/combo_box.mdx @@ -0,0 +1,25 @@ +--- +title: EuiComboBox +slug: combo-box +--- + +Use a **EuiComboBox** when the input has so many options that the user needs to be able to search them, +the user needs to be able to select multiple options, and/or the user should have the ability to specify +a custom value in addition to selecting from a predetermined list. If you're unsure of which selection component +to use, see [EUI's in-depth guide to selection components](https://github.com/elastic/eui/discussions/7049) +for more information. + +:::info Accessibility +You must add an accessible label to each instance of EuiComboBox. + +Labels can be created by wrapping the combo box in an EuiFormRow with a label, adding an aria-label prop, +or passing a text node ID to the aria-labelledby prop. +::: + +