import { Meta, Story, Canvas, Primary, Controls, Unstyled, Source, } from '@storybook/addon-docs/blocks'; import { Select } from '../../src/lib/components/selectv2/Selectv2.component'; import * as SelectStories from './selectv2.stories'; # Select Select lets users choose one option from a list. Use it when the list is too long for radio buttons or when the options are dynamic. For guidance on when to use Checkbox vs Toggle vs Radio vs Select, see [Guidelines/Selection Controls](?path=/docs/guidelines-selection-controls--stories). ## Label conventions The label identifies the field, not the action. Place it above or to the left of the control. - `Region` not `Select a region` - `Storage class` not `Choose storage class` - `Retention mode` not `Pick retention mode` The placeholder is the text shown inside the control when nothing is selected. Leave it empty when the label above is sufficient. A contextual placeholder like `Select a region` is acceptable, especially when there is no visible label. Avoid generic placeholders that apply to any select in any interface. - `Select a region` or empty, not `Select an option` - `Choose a storage class` or empty, not `Choose a value` ## Usage ### Icons You can use icons to differentiate options. When using icons, all options must have one. Mixing options with and without icons creates an inconsistent list.