Skip to Content
✨ Just dropped my UI Library — still cooking up some magic! Stay tuned & maybe… hire me  or sponsor me 😉 
DocumentationCheckbox

Checkbox

A modern, accessible checkbox component with smooth animations and multiple size variants. Perfect for forms, settings, and selection interfaces.

Install Dependencies

npx
quickcode-ui add Checkbox

Default Usage

Default Checkbox

Size Variants

Size Variants

Disabled States

Disabled States

Form Integration

Form Integration

Email Preferences

Props

PropTypeDefaultDescription
checkedbooleanfalseWhether the checkbox is checked
onChange(checked: boolean) => void-Callback fired when the checkbox state changes
disabledbooleanfalseWhether the checkbox is disabled
size"sm" | "md" | "lg""md"Size variant of the checkbox
labelstring-Optional label text displayed next to the checkbox
classNamestring-Additional CSS classes for custom styling
idstring-HTML id attribute for proper form association

Features

  • Smooth Animations: Subtle scale and fade transitions for better user experience
  • Keyboard Accessible: Full keyboard navigation with Space and Enter key support
  • Screen Reader Friendly: Proper ARIA labels and semantic HTML structure
  • Multiple Sizes: Three size variants (sm, md, lg) to fit different UI contexts
  • Disabled State: Visual and functional disabled state with reduced opacity
  • Form Integration: Works seamlessly with form libraries and controlled components
  • Dark Mode Ready: Built-in support for light and dark themes using design tokens
  • Touch Friendly: Optimized touch targets for mobile devices

Usage Notes

The Checkbox component is controlled, meaning you need to manage the checked state and provide an onChange handler. This gives you full control over the checkbox behavior and makes it easy to integrate with forms and state management solutions.

Last updated on