Switch
Installation
npx shadcn@latest add https://ui.timkit.cn/r/switch.json
Usage
import { Switch } from "@/components/ui/switch"
Examples
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Structured API
Component
switch
Logic
zag / switch
Runtime Frameworks
ReactVueWeappHTML
Supported Platforms
WebWeChat Mini Program
Configuration
| Prop | Type | Default | Description |
|---|---|---|---|
| logic.provider* | enum (zag | native | none) | zag | State and interaction provider used by this component. |
| logic.machine | string | switch | Underlying state machine identifier when provider is zag. |
| platforms* | array | Web, WeChat Mini Program | Platforms officially supported by this schema. |
| frameworks* | array | React, Vue, Weapp, HTML | Framework demos/code currently available in registry files. |
| dependencies | array | @timui/core, @zag-js/react | Runtime package dependencies required by this registry item. |
| optionalPeerDependencies | array | - | Optional peer dependencies used by this registry item. |
| registryDependencies | array | use-machine | Dependent Timkit registry components/hook entries. |
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| checked | boolean | - | The controlled checked state. |
| disabled | boolean | false | Whether the switch is disabled. |
Events
| Prop | Type | Default | Description |
|---|---|---|---|
| onCheckedChange | event | - | Callback called when checked state changes. |
Slots
| Prop | Type | Default | Description |
|---|---|---|---|
| default | slot | - | Default slot content rendered inside the component root. |
Parts
| Prop | Type | Default | Description |
|---|---|---|---|
| root* | root | - | The switch container |
| thumb | part | - | The thumb element that slides |
This API reference is generated from `/packages/core` component schemas to keep React/Vue/Weapp docs consistent.
Extended notes are not available for this component yet.
On This Page
- Installation
- Usage
- Examples
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- API Reference
Switch
Installation
npx shadcn@latest add https://ui.timkit.cn/r/switch.json
Usage
import { Switch } from "@/components/ui/switch"
Examples
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Switch · With label
Loading preview...
Structured API
Component
switch
Logic
zag / switch
Runtime Frameworks
ReactVueWeappHTML
Supported Platforms
WebWeChat Mini Program
Configuration
| Prop | Type | Default | Description |
|---|---|---|---|
| logic.provider* | enum (zag | native | none) | zag | State and interaction provider used by this component. |
| logic.machine | string | switch | Underlying state machine identifier when provider is zag. |
| platforms* | array | Web, WeChat Mini Program | Platforms officially supported by this schema. |
| frameworks* | array | React, Vue, Weapp, HTML | Framework demos/code currently available in registry files. |
| dependencies | array | @timui/core, @zag-js/react | Runtime package dependencies required by this registry item. |
| optionalPeerDependencies | array | - | Optional peer dependencies used by this registry item. |
| registryDependencies | array | use-machine | Dependent Timkit registry components/hook entries. |
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| checked | boolean | - | The controlled checked state. |
| disabled | boolean | false | Whether the switch is disabled. |
Events
| Prop | Type | Default | Description |
|---|---|---|---|
| onCheckedChange | event | - | Callback called when checked state changes. |
Slots
| Prop | Type | Default | Description |
|---|---|---|---|
| default | slot | - | Default slot content rendered inside the component root. |
Parts
| Prop | Type | Default | Description |
|---|---|---|---|
| root* | root | - | The switch container |
| thumb | part | - | The thumb element that slides |
This API reference is generated from `/packages/core` component schemas to keep React/Vue/Weapp docs consistent.
Extended notes are not available for this component yet.
On This Page
- Installation
- Usage
- Examples
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- Switch · With label
- API Reference