Toggle
A control for switching a setting on or off when the change is immediate and reversible.
When To Use
| Use | Avoid |
|---|---|
| A control for switching a setting on or off when the change is immediate and reversible. | Avoid using this component when the content has a different job or needs a simpler plain-text treatment. |
| Use real form controls with visible labels, help text, validation, input purpose, keyboard access, and clear submit behaviour. | Avoid changing approved colours, typography, logo artwork, or class names to create a local style guide. |
| Use the starter markup as a copy/paste baseline for websites, Ghost HTML blocks, generated pages, or print previews. | Avoid copying placeholder IDs, links, contact details, or image paths without replacing them. |
Example
Code
CSS Imports
@import "@landcare-design-system/css/dist/landcare.css";
@import "@landcare-design-system/css/dist/components.css";Starter Markup
<label class="lds-switch">
<input type="checkbox" role="switch" name="dark-view">
<span class="lds-switch-control" aria-hidden="true"></span>
<span class="lds-switch-label">Use dark preview</span>
</label>Class Reference
| Class | Use |
|---|---|
.lds-switch | Wraps a native checkbox with `role="switch"` and switch-specific layout. |
.lds-switch-control | Draws the visible switch track and thumb while the native input keeps keyboard and form behaviour. |
.lds-switch-label | Styles the readable switch label beside the visual control. |
Review Notes
Web
Use real form controls with visible labels, help text, validation, input purpose, keyboard access, and clear submit behaviour.
Do not send online controls straight to paper. Use a separate reviewed print pattern when the final material is filled out by hand.
States And Variants
Document required, optional, error, success, disabled, focus, and read-only states.
Checklist
- Brand colours, typography, and logo use are inherited from the approved master brand.
- The first-read message or action is clear.
- Labels, headings, links, and alternative text are meaningful.
- Keyboard focus, colour contrast, and reading order are covered where the component is interactive.
- The component survives its final output: mobile, desktop, Ghost CMS, A4 print, poster, signage, or email.