mirror of
https://github.com/carbon-design-system/carbon-components-svelte.git
synced 2025-09-18 03:26:36 +00:00
163 lines
No EOL
5 KiB
Text
163 lines
No EOL
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.detail)}>
|
|
<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.detail)}>
|
|
<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.detail)}>
|
|
<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 /> |