292 lines
8.0 KiB
Markdown
292 lines
8.0 KiB
Markdown
# Swap
|
||
|
||
Toggle component that swaps between two states (on/off) with customizable icons or content.
|
||
|
||
## Tag
|
||
|
||
`Swap`
|
||
|
||
## Props
|
||
|
||
| Prop | Type | Default | Description |
|
||
| :--- | :--- | :--- | :--- |
|
||
| `value` | `boolean \| Signal<boolean>` | `false` | Swap state (true = on, false = off) |
|
||
| `on` | `string \| VNode \| Signal` | `-` | Content to show when state is on |
|
||
| `off` | `string \| VNode \| Signal` | `-` | Content to show when state is off |
|
||
| `class` | `string` | `''` | Additional CSS classes (DaisyUI + Tailwind) |
|
||
| `onclick` | `function` | `-` | Click event handler |
|
||
|
||
## Styling
|
||
|
||
Swap supports all **daisyUI Swap classes**:
|
||
|
||
| Category | Keywords | Description |
|
||
| :--- | :--- | :--- |
|
||
| Base | `swap` | Base swap container |
|
||
| Size | `swap-xs`, `swap-sm`, `swap-md`, `swap-lg` | Swap scale |
|
||
| Effect | `swap-rotate`, `swap-flip` | Animation effect on toggle |
|
||
|
||
> For further details, check the [daisyUI Swap Documentation](https://daisyui.com/components/swap) – Full reference for CSS classes.
|
||
|
||
## Live Examples
|
||
|
||
### Basic Swap
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-basic" class="bg-base-100 p-6 rounded-xl border border-base-300 flex items-center justify-center"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const BasicDemo = () => {
|
||
const isOn = $(false);
|
||
|
||
return Swap({
|
||
value: isOn,
|
||
on: "🌟 ON",
|
||
off: "💫 OFF",
|
||
onclick: () => isOn(!isOn())
|
||
});
|
||
};
|
||
$mount(BasicDemo, '#demo-basic');
|
||
```
|
||
|
||
### Icon Swap
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-icons" class="bg-base-100 p-6 rounded-xl border border-base-300 flex items-center justify-center"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const IconsDemo = () => {
|
||
const isOn = $(false);
|
||
|
||
return Swap({
|
||
value: isOn,
|
||
on: "👁️",
|
||
off: "👁️🗨️",
|
||
onclick: () => isOn(!isOn())
|
||
});
|
||
};
|
||
$mount(IconsDemo, '#demo-icons');
|
||
```
|
||
|
||
### Emoji Swap
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-emoji" class="bg-base-100 p-6 rounded-xl border border-base-300 flex items-center justify-center"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const EmojiDemo = () => {
|
||
const isOn = $(false);
|
||
|
||
return Swap({
|
||
value: isOn,
|
||
on: "❤️",
|
||
off: "🖤",
|
||
onclick: () => isOn(!isOn())
|
||
});
|
||
};
|
||
$mount(EmojiDemo, '#demo-emoji');
|
||
```
|
||
|
||
### Custom Content Swap
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-custom" class="bg-base-100 p-6 rounded-xl border border-base-300 flex items-center justify-center"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const CustomDemo = () => {
|
||
const isOn = $(false);
|
||
|
||
return Swap({
|
||
value: isOn,
|
||
on: Div({ class: "badge badge-success gap-1" }, ["✅", " Active"]),
|
||
off: Div({ class: "badge badge-ghost gap-1" }, ["⭕", " Inactive"]),
|
||
onclick: () => isOn(!isOn())
|
||
});
|
||
};
|
||
$mount(CustomDemo, '#demo-custom');
|
||
```
|
||
|
||
### With Reactive State
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-reactive" class="bg-base-100 p-6 rounded-xl border border-base-300 flex flex-col gap-4"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const ReactiveDemo = () => {
|
||
const isOn = $(false);
|
||
|
||
return Div({ class: 'flex flex-col gap-4 items-center' }, [
|
||
Swap({
|
||
value: isOn,
|
||
on: "👁️",
|
||
off: "👁️🗨️",
|
||
onclick: () => isOn(!isOn())
|
||
}),
|
||
Div({ class: 'text-center' }, () =>
|
||
isOn()
|
||
? Div({ class: 'alert alert-success' }, 'Content is visible')
|
||
: Div({ class: 'alert alert-soft' }, 'Content is hidden')
|
||
)
|
||
]);
|
||
};
|
||
$mount(ReactiveDemo, '#demo-reactive');
|
||
```
|
||
|
||
### Toggle Mode Swap
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-mode" class="bg-base-100 p-6 rounded-xl border border-base-300 flex flex-col gap-4"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const ModeDemo = () => {
|
||
const darkMode = $(false);
|
||
const notifications = $(true);
|
||
const sound = $(false);
|
||
|
||
return Div({ class: 'flex flex-col gap-4 w-full' }, [
|
||
Div({ class: 'flex justify-between items-center' }, [
|
||
Span({}, 'Dark mode'),
|
||
Swap({
|
||
value: darkMode,
|
||
on: "🌙",
|
||
off: "☀️",
|
||
onclick: () => darkMode(!darkMode())
|
||
})
|
||
]),
|
||
Div({ class: 'flex justify-between items-center' }, [
|
||
Span({}, 'Notifications'),
|
||
Swap({
|
||
value: notifications,
|
||
on: "🔔",
|
||
off: "🔕",
|
||
onclick: () => notifications(!notifications())
|
||
})
|
||
]),
|
||
Div({ class: 'flex justify-between items-center' }, [
|
||
Span({}, 'Sound effects'),
|
||
Swap({
|
||
value: sound,
|
||
on: "🔊",
|
||
off: "🔇",
|
||
onclick: () => sound(!sound())
|
||
})
|
||
]),
|
||
Div({ class: 'mt-2 p-3 rounded-lg', style: () => darkMode() ? 'background: #1f2937; color: white' : 'background: #f3f4f6' }, [
|
||
Div({ class: 'text-sm' }, () => `Mode: ${darkMode() ? 'Dark' : 'Light'} | Notifications: ${notifications() ? 'On' : 'Off'} | Sound: ${sound() ? 'On' : 'Off'}`)
|
||
])
|
||
]);
|
||
};
|
||
$mount(ModeDemo, '#demo-mode');
|
||
```
|
||
|
||
### All Variants
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-variants" class="bg-base-100 p-6 rounded-xl border border-base-300 flex flex-wrap gap-8 justify-center"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const VariantsDemo = () => {
|
||
return Div({ class: 'flex flex-wrap gap-8 justify-center items-center' }, [
|
||
Div({ class: 'text-center' }, [
|
||
Div({ class: 'text-xs mb-2' }, 'Volume'),
|
||
Swap({
|
||
value: $(false),
|
||
on: "🔊",
|
||
off: "🔇"
|
||
})
|
||
]),
|
||
Div({ class: 'text-center' }, [
|
||
Div({ class: 'text-xs mb-2' }, 'Like'),
|
||
Swap({
|
||
value: $(true),
|
||
on: "❤️",
|
||
off: "🤍"
|
||
})
|
||
]),
|
||
Div({ class: 'text-center' }, [
|
||
Div({ class: 'text-xs mb-2' }, 'Star'),
|
||
Swap({
|
||
value: $(false),
|
||
on: "⭐",
|
||
off: "☆"
|
||
})
|
||
]),
|
||
Div({ class: 'text-center' }, [
|
||
Div({ class: 'text-xs mb-2' }, 'Check'),
|
||
Swap({
|
||
value: $(true),
|
||
on: "✅",
|
||
off: "❌"
|
||
})
|
||
])
|
||
]);
|
||
};
|
||
$mount(VariantsDemo, '#demo-variants');
|
||
```
|
||
|
||
### Simple Todo Toggle
|
||
|
||
<div class="card bg-base-200 border border-base-300 shadow-sm my-6">
|
||
<div class="card-body">
|
||
<h3 class="card-title text-sm uppercase opacity-50 mb-4">Live Demo</h3>
|
||
<div id="demo-todo" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const TodoDemo = () => {
|
||
const todos = [
|
||
{ id: 1, text: 'Complete documentation', completed: $(true) },
|
||
{ id: 2, text: 'Review pull requests', completed: $(false) },
|
||
{ id: 3, text: 'Deploy to production', completed: $(false) }
|
||
];
|
||
|
||
return Div({ class: 'flex flex-col gap-3' }, [
|
||
Div({ class: 'text-sm font-bold mb-2' }, 'Todo list'),
|
||
...todos.map(todo =>
|
||
Div({ class: 'flex items-center justify-between p-2 bg-base-200 rounded-lg' }, [
|
||
Span({ class: todo.completed() ? 'line-through opacity-50' : '' }, todo.text),
|
||
Swap({
|
||
value: todo.completed,
|
||
on: "✅",
|
||
off: "⬜",
|
||
onclick: () => todo.completed(!todo.completed())
|
||
})
|
||
])
|
||
),
|
||
Div({ class: 'mt-2 text-sm opacity-70' }, () => {
|
||
const completed = todos.filter(t => t.completed()).length;
|
||
return `${completed} of ${todos.length} tasks completed`;
|
||
})
|
||
]);
|
||
};
|
||
$mount(TodoDemo, '#demo-todo');
|
||
``` |