Files
zeekayandHanzo Dev 751ef5c778 rename the framework to @hanzo/gui and the loader to @hanzogui/loader
Both old names are owned by a different npm account (artemis-prime), so
publishing them returns 403 — which is how this surfaced: the 8.0.0 run
shipped @hanzogui/logo and @hanzogui/demos depending on [email protected], a
version that cannot be published and therefore does not exist. Those two
were uninstallable.

@hanzo/gui and @hanzogui/* are ours, so the framework now carries the name
it is imported by everywhere downstream, and the loader moves under the
scope we control.

The rewrite is limited to package references. `DEBUG?.startsWith('hanzogui')`
is a log-namespace filter and join(dir, 'hanzogui') is a path — rewriting
either would change behaviour, so both are untouched.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-30 20:23:18 -07:00

90 lines
1.6 KiB
Plaintext

---
title: Switch
description: A simple switch component
name: switch
component: Switch
package: switch
demoName: Switch
---
# Switch
<Description>Use in forms to toggle between two states.</Description>
<HeroContainer showAnimationDriverControl>
<SwitchDemo />
</HeroContainer>
```tsx hero template=Switch
```
<Highlights
features={[
`Accessible, easy to compose and customize.`,
`Style and animate both frame and thumb.`,
`Sizable & works controlled or uncontrolled.`,
]}
/>
### Usage
```tsx
import { Switch } from '@hanzo/gui'
export default () => (
<Switch size="$4">
<Switch.Thumb animation="bouncy" />
</Switch>
)
```
### Switch props
Switchs extend Stack views inheriting all the [Gui standard props](/docs/intro/props), plus:
<PropsTable
data={[
{
name: 'labeledBy',
type: 'string',
description: `Set aria-labeled-by.`,
},
{
name: 'name',
type: 'string',
description: `Equivalent to input name.`,
},
{
name: 'value',
type: 'string',
description: `Give it a value (for use in HTML forms).`,
},
{
name: 'checked',
type: 'boolean',
description: `Control the input.`,
},
{
name: 'defaultChecked',
type: 'boolean',
description: `Uncontrolled default value.`,
},
{
name: 'required',
type: 'boolean',
description: `Sets aria-required.`,
},
{
name: 'onCheckedChange',
type: '(checked: boolean) => void',
},
{
name: 'unstyled',
type: 'boolean',
default: 'false',
description: `When true, remove all default hanzogui styling.`,
},
]}
/>