413 lines
13 KiB
Markdown
413 lines
13 KiB
Markdown
# Accordion
|
||
|
||
Collapsible accordion component for organizing content into expandable sections.
|
||
|
||
## Tag
|
||
|
||
`Accordion`
|
||
|
||
## Props
|
||
|
||
| Prop | Type | Default | Description |
|
||
| :--- | :--- | :--- | :--- |
|
||
| `title` | `string \| VNode \| Signal` | Required | Accordion section title |
|
||
| `open` | `boolean \| Signal<boolean>` | `false` | Whether the accordion is expanded |
|
||
| `name` | `string` | `-` | Group name for radio-style accordions (only one open at a time) |
|
||
| `class` | `string` | `''` | Additional CSS classes (DaisyUI + Tailwind) |
|
||
| `children` | `VNode \| Array<VNode>` | Required | Content to display when expanded |
|
||
|
||
## Styling
|
||
|
||
Accordion supports all **daisyUI Collapse classes**:
|
||
|
||
| Category | Keywords | Description |
|
||
| :--- | :--- | :--- |
|
||
| Type | `collapse-arrow`, `collapse-plus`, `collapse-minus` | Expand indicator style |
|
||
| Color | `collapse-primary`, `collapse-secondary`, `collapse-accent` | Color variants |
|
||
| Background | `bg-base-100`, `bg-base-200` | Background colors |
|
||
|
||
> For further details, check the [daisyUI Collapse Documentation](https://daisyui.com/components/collapse) – Full reference for CSS classes.
|
||
|
||
### Example
|
||
|
||
```javascript
|
||
Accordion({
|
||
title: "Click to expand",
|
||
class: "collapse-arrow bg-base-100",
|
||
open: isOpen,
|
||
onclick: () => isOpen(!isOpen())
|
||
}, [
|
||
Div({ class: "p-4" }, "Hidden content here")
|
||
]);
|
||
```
|
||
|
||
## Live Examples
|
||
|
||
### Basic Accordion
|
||
|
||
<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"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const BasicDemo = () => {
|
||
const open1 = $(false);
|
||
const open2 = $(false);
|
||
const open3 = $(false);
|
||
|
||
return Div({ class: 'flex flex-col gap-2' }, [
|
||
Accordion({
|
||
title: 'Section 1',
|
||
open: open1,
|
||
onclick: () => open1(!open1())
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Content for section 1. This is a basic accordion section.')
|
||
]),
|
||
Accordion({
|
||
title: 'Section 2',
|
||
open: open2,
|
||
onclick: () => open2(!open2())
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Content for section 2. You can put any content here.')
|
||
]),
|
||
Accordion({
|
||
title: 'Section 3',
|
||
open: open3,
|
||
onclick: () => open3(!open3())
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Content for section 3. Accordions are great for FAQs.')
|
||
])
|
||
]);
|
||
};
|
||
$mount(BasicDemo, '#demo-basic');
|
||
```
|
||
|
||
### Group Accordion (Radio Style)
|
||
|
||
<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-group" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const GroupDemo = () => {
|
||
const openSection = $('section1');
|
||
|
||
return Div({ class: 'flex flex-col gap-2' }, [
|
||
Accordion({
|
||
title: 'Section 1',
|
||
name: 'group',
|
||
open: () => openSection() === 'section1',
|
||
onclick: () => openSection('section1')
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Content for section 1. Only one section can be open at a time.')
|
||
]),
|
||
Accordion({
|
||
title: 'Section 2',
|
||
name: 'group',
|
||
open: () => openSection() === 'section2',
|
||
onclick: () => openSection('section2')
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Content for section 2. Opening this will close section 1.')
|
||
]),
|
||
Accordion({
|
||
title: 'Section 3',
|
||
name: 'group',
|
||
open: () => openSection() === 'section3',
|
||
onclick: () => openSection('section3')
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Content for section 3. This is useful for FAQ sections.')
|
||
])
|
||
]);
|
||
};
|
||
$mount(GroupDemo, '#demo-group');
|
||
```
|
||
|
||
### FAQ Accordion
|
||
|
||
<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-faq" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const FaqDemo = () => {
|
||
const openFaq = $('faq1');
|
||
|
||
const faqs = [
|
||
{ id: 'faq1', question: 'What is this component?', answer: 'This is an accordion component built with DaisyUI and Tailwind CSS for creating collapsible content sections.' },
|
||
{ id: 'faq2', question: 'How do I use it?', answer: 'Simply import the Accordion component and pass title and children props. Use the open prop to control expansion.' },
|
||
{ id: 'faq3', question: 'Can I have multiple open?', answer: 'Yes! By default, accordions can be opened independently. Use the name prop to create groups where only one can be open.' },
|
||
{ id: 'faq4', question: 'Is it accessible?', answer: 'Yes, the accordion uses proper ARIA attributes and keyboard navigation support.' }
|
||
];
|
||
|
||
return Div({ class: 'flex flex-col gap-2' }, faqs.map(faq =>
|
||
Accordion({
|
||
title: faq.question,
|
||
name: 'faq-group',
|
||
open: () => openFaq() === faq.id,
|
||
onclick: () => openFaq(openFaq() === faq.id ? '' : faq.id)
|
||
}, [
|
||
Div({ class: 'p-2 text-sm' }, faq.answer)
|
||
])
|
||
));
|
||
};
|
||
$mount(FaqDemo, '#demo-faq');
|
||
```
|
||
|
||
### With Rich Content
|
||
|
||
<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-rich" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const RichDemo = () => {
|
||
const open1 = $(true);
|
||
const open2 = $(false);
|
||
|
||
return Div({ class: 'flex flex-col gap-2' }, [
|
||
Accordion({
|
||
title: Span({ class: 'flex items-center gap-2' }, ['📊', 'Statistics']),
|
||
open: open1,
|
||
onclick: () => open1(!open1())
|
||
}, [
|
||
Div({ class: 'p-2' }, [
|
||
Div({ class: 'grid grid-cols-2 gap-4' }, [
|
||
Div({ class: 'stat bg-base-100 rounded-lg p-3' }, [
|
||
Div({ class: 'stat-title' }, 'Users'),
|
||
Div({ class: 'stat-value text-lg' }, '1,234')
|
||
]),
|
||
Div({ class: 'stat bg-base-100 rounded-lg p-3' }, [
|
||
Div({ class: 'stat-title' }, 'Revenue'),
|
||
Div({ class: 'stat-value text-lg' }, '$45,678')
|
||
]),
|
||
Div({ class: 'stat bg-base-100 rounded-lg p-3' }, [
|
||
Div({ class: 'stat-title' }, 'Growth'),
|
||
Div({ class: 'stat-value text-lg text-success' }, '+23%')
|
||
]),
|
||
Div({ class: 'stat bg-base-100 rounded-lg p-3' }, [
|
||
Div({ class: 'stat-title' }, 'Active'),
|
||
Div({ class: 'stat-value text-lg' }, '89%')
|
||
])
|
||
])
|
||
])
|
||
]),
|
||
Accordion({
|
||
title: Span({ class: 'flex items-center gap-2' }, ['👥', 'Team Members']),
|
||
open: open2,
|
||
onclick: () => open2(!open2())
|
||
}, [
|
||
Div({ class: 'p-2 space-y-2' }, [
|
||
Div({ class: 'flex items-center gap-3 p-2 hover:bg-base-100 rounded-lg' }, [
|
||
Div({ class: 'avatar placeholder' }, [
|
||
Div({ class: 'bg-primary text-primary-content rounded-full w-10 h-10 flex items-center justify-center' }, 'JD')
|
||
]),
|
||
Div({ class: 'flex-1' }, [
|
||
Div({ class: 'font-medium' }, 'John Doe'),
|
||
Div({ class: 'text-sm opacity-70' }, 'Developer')
|
||
])
|
||
]),
|
||
Div({ class: 'flex items-center gap-3 p-2 hover:bg-base-100 rounded-lg' }, [
|
||
Div({ class: 'avatar placeholder' }, [
|
||
Div({ class: 'bg-secondary text-secondary-content rounded-full w-10 h-10 flex items-center justify-center' }, 'JS')
|
||
]),
|
||
Div({ class: 'flex-1' }, [
|
||
Div({ class: 'font-medium' }, 'Jane Smith'),
|
||
Div({ class: 'text-sm opacity-70' }, 'Designer')
|
||
])
|
||
])
|
||
])
|
||
])
|
||
]);
|
||
};
|
||
$mount(RichDemo, '#demo-rich');
|
||
```
|
||
|
||
### Form Accordion
|
||
|
||
<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-form" class="bg-base-100 p-6 rounded-xl border border-base-300"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const FormAccordion = () => {
|
||
const openStep = $('step1');
|
||
const formData = $({
|
||
name: '',
|
||
email: '',
|
||
address: '',
|
||
payment: 'credit'
|
||
});
|
||
|
||
const updateField = (field, value) => {
|
||
formData({ ...formData(), [field]: value });
|
||
};
|
||
|
||
const nextStep = () => {
|
||
if (openStep() === 'step1') openStep('step2');
|
||
else if (openStep() === 'step2') openStep('step3');
|
||
};
|
||
|
||
const prevStep = () => {
|
||
if (openStep() === 'step2') openStep('step1');
|
||
else if (openStep() === 'step3') openStep('step2');
|
||
};
|
||
|
||
const handleSubmit = () => {
|
||
Toast('Form submitted!', 'alert-success', 2000);
|
||
console.log(formData());
|
||
};
|
||
|
||
return Div({ class: 'flex flex-col gap-2' }, [
|
||
Accordion({
|
||
title: Span({ class: 'flex items-center gap-2' }, ['1️⃣', 'Personal Information']),
|
||
name: 'form-steps',
|
||
open: () => openStep() === 'step1',
|
||
onclick: () => openStep('step1')
|
||
}, [
|
||
Div({ class: 'p-4 space-y-4' }, [
|
||
Input({
|
||
label: 'Full Name',
|
||
value: () => formData().name,
|
||
placeholder: 'Enter your name',
|
||
oninput: (e) => updateField('name', e.target.value)
|
||
}),
|
||
Input({
|
||
label: 'Email',
|
||
type: 'email',
|
||
value: () => formData().email,
|
||
placeholder: 'email@example.com',
|
||
oninput: (e) => updateField('email', e.target.value)
|
||
}),
|
||
Div({ class: 'flex justify-end mt-2' }, [
|
||
Button({
|
||
class: 'btn btn-primary btn-sm',
|
||
onclick: nextStep,
|
||
disabled: () => !formData().name || !formData().email
|
||
}, 'Next →')
|
||
])
|
||
])
|
||
]),
|
||
Accordion({
|
||
title: Span({ class: 'flex items-center gap-2' }, ['2️⃣', 'Address']),
|
||
name: 'form-steps',
|
||
open: () => openStep() === 'step2',
|
||
onclick: () => openStep('step2')
|
||
}, [
|
||
Div({ class: 'p-4 space-y-4' }, [
|
||
Input({
|
||
label: 'Address',
|
||
value: () => formData().address,
|
||
placeholder: 'Street address',
|
||
oninput: (e) => updateField('address', e.target.value)
|
||
}),
|
||
Div({ class: 'flex justify-between mt-2' }, [
|
||
Button({ class: 'btn btn-ghost btn-sm', onclick: prevStep }, '← Back'),
|
||
Button({
|
||
class: 'btn btn-primary btn-sm',
|
||
onclick: nextStep
|
||
}, 'Next →')
|
||
])
|
||
])
|
||
]),
|
||
Accordion({
|
||
title: Span({ class: 'flex items-center gap-2' }, ['3️⃣', 'Payment']),
|
||
name: 'form-steps',
|
||
open: () => openStep() === 'step3',
|
||
onclick: () => openStep('step3')
|
||
}, [
|
||
Div({ class: 'p-4 space-y-4' }, [
|
||
Div({ class: 'flex flex-col gap-2' }, [
|
||
Radio({
|
||
label: 'Credit Card',
|
||
value: () => formData().payment,
|
||
radioValue: 'credit',
|
||
onclick: () => updateField('payment', 'credit')
|
||
}),
|
||
Radio({
|
||
label: 'PayPal',
|
||
value: () => formData().payment,
|
||
radioValue: 'paypal',
|
||
onclick: () => updateField('payment', 'paypal')
|
||
}),
|
||
Radio({
|
||
label: 'Bank Transfer',
|
||
value: () => formData().payment,
|
||
radioValue: 'bank',
|
||
onclick: () => updateField('payment', 'bank')
|
||
})
|
||
]),
|
||
Div({ class: 'flex justify-between mt-2' }, [
|
||
Button({ class: 'btn btn-ghost btn-sm', onclick: prevStep }, '← Back'),
|
||
Button({ class: 'btn btn-success btn-sm', onclick: handleSubmit }, 'Submit')
|
||
])
|
||
])
|
||
])
|
||
]);
|
||
};
|
||
$mount(FormAccordion, '#demo-form');
|
||
```
|
||
|
||
### 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-col gap-6"></div>
|
||
</div>
|
||
</div>
|
||
|
||
```javascript
|
||
const VariantsDemo = () => {
|
||
const open1 = $(true);
|
||
const open2 = $(false);
|
||
const open3 = $(false);
|
||
|
||
return Div({ class: 'flex flex-col gap-4' }, [
|
||
Div({ class: 'text-sm font-bold' }, 'Default Accordion'),
|
||
Div({ class: 'flex flex-col gap-2' }, [
|
||
Accordion({ title: 'Default style', open: open1, onclick: () => open1(!open1()) }, [
|
||
Div({ class: 'p-2' }, 'Default accordion with standard styling.')
|
||
])
|
||
]),
|
||
|
||
Div({ class: 'text-sm font-bold mt-2' }, 'Custom Styling'),
|
||
Div({ class: 'flex flex-col gap-2' }, [
|
||
Accordion({
|
||
title: Span({ class: 'text-primary font-bold' }, 'Primary Title'),
|
||
open: open2,
|
||
onclick: () => open2(!open2()),
|
||
class: 'bg-primary/5 border-primary/20'
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Accordion with custom styling and primary color.')
|
||
])
|
||
]),
|
||
|
||
Div({ class: 'text-sm font-bold mt-2' }, 'With Icons'),
|
||
Div({ class: 'flex flex-col gap-2' }, [
|
||
Accordion({
|
||
title: Span({ class: 'flex items-center gap-2' }, ['✨', 'Featured Content']),
|
||
open: open3,
|
||
onclick: () => open3(!open3())
|
||
}, [
|
||
Div({ class: 'p-2' }, 'Accordion with emoji icons in the title.')
|
||
])
|
||
])
|
||
]);
|
||
};
|
||
$mount(VariantsDemo, '#demo-variants');
|
||
``` |