mirror of
https://github.com/carbon-design-system/carbon-components-svelte.git
synced 2025-09-15 18:31:06 +00:00
9198ed5474Closes #1491 * feat(pagination): dispatch "change" event when interacting with previous/next buttons, page/page size dropdowns * breaking(select): rename dispatched "change" event to "update" * breaking(select): forward `change` event to `Select`
163 lines
5 KiB
Text
163 lines
5 KiB
Text
---
|
|
components: ["Select", "SelectItem", "SelectItemGroup", "SelectSkeleton"]
|
|
---
|
|
|
|
<script>
|
|
import { Select, SelectItem, SelectItemGroup, SelectSkeleton } from "carbon-components-svelte";
|
|
import Preview from "../../components/Preview.svelte";
|
|
</script>
|
|
|
|
## Default
|
|
|
|
If the `selected` prop is not set, the value of the first `SelectItem` will be used as the default value.
|
|
|
|
<Select labelText="Carbon theme" on:change={e => console.log("value", e.target.value)}>
|
|
<SelectItem value="white" />
|
|
<SelectItem value="g10" />
|
|
<SelectItem value="g80" />
|
|
<SelectItem value="g90" />
|
|
<SelectItem value="g100" />
|
|
</Select>
|
|
|
|
## Custom item text
|
|
|
|
Use the `text` prop on `SelectItem` to customize the display value.
|
|
|
|
<Select labelText="Carbon theme" on:change={e => console.log("value", e.target.value)}>
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Initial selected value
|
|
|
|
Use the `selected` prop to specify an initial value.
|
|
|
|
<Select labelText="Carbon theme" selected="g10" on:change={e => console.log("value", e.target.value)}>
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Reactive example
|
|
|
|
The `selected` prop is reactive and supports two-way binding.
|
|
|
|
<FileSource src="/framed/Select/SelectReactive" />
|
|
|
|
## Helper text
|
|
|
|
<Select helperText="Carbon offers 4 themes (2 light, 3 dark)" labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Hidden label
|
|
|
|
<Select hideLabel labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Item groups
|
|
|
|
<Select labelText="Carbon theme" selected="0">
|
|
<SelectItem value="0" text="Select a theme" disabled hidden />
|
|
<SelectItemGroup label="Light theme">
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
</SelectItemGroup>
|
|
<SelectItemGroup label="Dark theme">
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</SelectItemGroup>
|
|
</Select>
|
|
|
|
## Light variant
|
|
|
|
<Select light labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Inline variant
|
|
|
|
<Select inline labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Extra-large size
|
|
|
|
<Select size="xl" labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Small size
|
|
|
|
<Select size="sm" labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Invalid state
|
|
|
|
<Select invalid invalidText="Theme must be a dark variant" labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Warning state
|
|
|
|
<Select warn warnText="The selected theme will not be persisted" labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Disabled state
|
|
|
|
<Select disabled labelText="Carbon theme" selected="g10" >
|
|
<SelectItem value="white" text="White" />
|
|
<SelectItem value="g10" text="Gray 10" />
|
|
<SelectItem value="g80" text="Gray 80" />
|
|
<SelectItem value="g90" text="Gray 90" />
|
|
<SelectItem value="g100" text="Gray 100" />
|
|
</Select>
|
|
|
|
## Skeleton
|
|
|
|
<SelectSkeleton />
|
|
|
|
## Skeleton (hidden label)
|
|
|
|
<SelectSkeleton hideLabel />
|