Skip to content

fix(a11y): improve toggle switches #1782

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
userquin wants to merge 3 commits into
base: main
Choose a base branch
from
+73 −165
Open

fix(a11y): improve toggle switches #1782

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ee1082e
fix(a11y): improve toggle switches
userquin Mar 1, 2026
b36e9c4
chore: restore forced colors
userquin Mar 1, 2026
77eb000
chore: apply coderabbit.ai suggestion for css label selector
userquin Mar 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
151 changes: 68 additions & 83 deletions app/components/Settings/Toggle.client.vue
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,37 +27,56 @@ const id = useId()
<template>
<label
:for="id"
class="grid items-center gap-1.5 py-1 -my-1 grid-cols-[auto_1fr_auto]"
class="grid items-center gap-1.5 py-1 -my-1 grid-cols-[auto_1fr_auto] cursor-pointer group"
:class="[justify === 'start' ? 'justify-start' : '']"
:style="
props.reverseOrder
? 'grid-template-areas: \'toggle . label-text\''
: 'grid-template-areas: \'label-text . toggle\''
"
>
<span
class="relative inline-flex items-center shrink-0"
style="grid-area: toggle; justify-self: end"
>
<input type="checkbox" :id="id" role="switch" v-model="checked" class="sr-only peer" />

<!-- Track -->
<span
class="w-11 h-6 bg-fg-subtle peer-focus:outline-none peer-focus-visible:ring-2 peer-focus-visible:ring-fg peer-focus-visible:ring-offset-2 rounded-full peer peer-checked:after:translate-x-full rtl:peer-checked:after:-translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:start-[2px] after:bg-bg after:border-gray-300 after:border after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-fg transition-colors duration-200 ease-in-out"
></span>

<!-- Thumb Icon (Check) - Positioned absolutely over the thumb area -->
<span
class="absolute top-[2px] start-[2px] h-5 w-5 rounded-full flex items-center justify-center transition-transform duration-200 ease-in-out pointer-events-none"
:class="checked ? 'translate-x-5 rtl:-translate-x-5' : 'translate-x-0'"
>
<span
class="i-lucide:check w-3.5 h-3.5 text-fg transition-transform duration-200"
:class="checked ? 'scale-100 opacity-100' : 'scale-0 opacity-0'"
aria-hidden="true"
></span>
</span>
</span>

<template v-if="props.reverseOrder">
<input
role="switch"
type="checkbox"
:id
v-model="checked"
class="toggle appearance-none h-6 w-11 rounded-full border border-fg relative shrink-0 bg-fg-subtle checked:bg-fg checked:border-fg focus-visible:(outline-2 outline-fg outline-offset-2) before:content-[''] before:absolute before:h-5 before:w-5 before:top-1px before:rounded-full before:bg-bg"
style="grid-area: toggle"
/>
<TooltipApp
v-if="tooltip && label"
:text="tooltip"
:position="tooltipPosition ?? 'top'"
:to="tooltipTo"
:offset="tooltipOffset"
>
<span class="text-sm text-fg font-medium text-start" style="grid-area: label-text">
<span
class="toggle-label text-sm text-fg font-medium text-start"
style="grid-area: label-text"
>
{{ label }}
</span>
</TooltipApp>
<span
v-else-if="label"
class="text-sm text-fg font-medium text-start"
class="toggle-label text-sm text-fg font-medium text-start"
style="grid-area: label-text"
>
{{ label }}
Expand All @@ -71,25 +90,20 @@ const id = useId()
:to="tooltipTo"
:offset="tooltipOffset"
>
<span class="text-sm text-fg font-medium text-start" style="grid-area: label-text">
<span
class="toggle-label text-sm text-fg font-medium text-start"
style="grid-area: label-text"
>
{{ label }}
</span>
</TooltipApp>
<span
v-else-if="label"
class="text-sm text-fg font-medium text-start"
class="toggle-label text-sm text-fg font-medium text-start"
style="grid-area: label-text"
>
{{ label }}
</span>
<input
role="switch"
type="checkbox"
:id
v-model="checked"
class="toggle appearance-none h-6 w-11 rounded-full border border-fg relative shrink-0 bg-fg-subtle checked:bg-fg checked:border-fg focus-visible:(outline-2 outline-fg outline-offset-2) before:content-[''] before:absolute before:h-5 before:w-5 before:top-1px before:rounded-full before:bg-bg"
style="grid-area: toggle; justify-self: end"
/>
</template>
</label>
<p v-if="description" class="text-sm text-fg-muted mt-2">
Expand All @@ -98,82 +112,53 @@ const id = useId()
</template>

<style scoped>
/* Thumb position: logical property for RTL support */
.toggle::before {
inset-inline-start: 1px;
}

/* Track transition */
.toggle {
transition:
background-color 200ms ease-in-out,
border-color 100ms ease-in-out;
}

.toggle::before {
transition:
background-color 200ms ease-in-out,
translate 200ms ease-in-out;
}

/* Hover states */
.toggle:hover:not(:checked) {
background: var(--fg-muted);
}

.toggle:checked:hover {
background: var(--fg-muted);
border-color: var(--fg-muted);
}

/* RTL-aware checked thumb position */
:dir(ltr) .toggle:checked::before {
translate: 20px;
}

:dir(rtl) .toggle:checked::before {
translate: -20px;
}

@media (prefers-reduced-motion: reduce) {
.toggle,
.toggle::before {
transition: none;
}
}

/* Support forced colors */
@media (forced-colors: active) {
label > span {
background: Canvas;
color: Highlight;
/* Label text */
.toggle-label {
color: Highlight !important;
forced-color-adjust: none;
background: Canvas !important;
}

/* Track (OFF & ON base) */
input + span {
forced-color-adjust: none;
border: 1px solid CanvasText !important;
background: Canvas !important;
}

label:has(.toggle:checked) > span {
background: Highlight;
color: Canvas;
/* Track ON */
input:checked + span {
background: Highlight !important;
border-color: CanvasText !important;
}

.toggle::before {
/* Thumb (OFF) - Purple circle */
input + span::after {
forced-color-adjust: none;
background-color: Highlight;
background-color: Highlight !important;
border: none !important;
}

.toggle,
.toggle:hover {
background: Canvas;
border-color: CanvasText;
/* Thumb (ON) - White circle on purple track */
input:checked + span::after {
background-color: Canvas !important;
}

.toggle:checked,
.toggle:checked:hover {
background: Highlight;
border-color: CanvasText;
/* Icon (ON) - Purple check on white thumb */
.i-lucide\:check {
color: Highlight !important;
forced-color-adjust: none;
}
}

.toggle:checked::before {
background: Canvas;
@media (prefers-reduced-motion: reduce) {
span,
span::after,
.i-lucide\:check {
transition: none !important;
animation: none !important;
}
}
</style>
87 changes: 5 additions & 82 deletions app/components/Settings/Toggle.server.vue
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ const props = withDefaults(
label: string
description?: string
justify?: 'between' | 'start'
tooltip?: string
tooltipPosition?: 'top' | 'bottom' | 'left' | 'right'
tooltipTo?: string
tooltipOffset?: number
reverseOrder?: boolean
}>(),
{
Expand All @@ -15,7 +19,7 @@ const props = withDefaults(

<template>
<div
class="grid items-center gap-4 py-1 -my-1 grid-cols-[auto_1fr_auto]"
class="grid items-center gap-1.5 py-1 -my-1 grid-cols-[auto_1fr_auto]"
:class="[justify === 'start' ? 'justify-start' : '']"
:style="
props.reverseOrder
Expand Down Expand Up @@ -51,84 +55,3 @@ const props = withDefaults(
{{ description }}
</p>
</template>

<style scoped>
/* Thumb position: logical property for RTL support */
.toggle::before {
inset-inline-start: 1px;
}

/* Track transition */
.toggle {
transition:
background-color 200ms ease-in-out,
border-color 100ms ease-in-out;
}

.toggle::before {
transition:
background-color 200ms ease-in-out,
translate 200ms ease-in-out;
}

/* Hover states */
.toggle:hover:not(:checked) {
background: var(--fg-muted);
}

.toggle:checked:hover {
background: var(--fg-muted);
border-color: var(--fg-muted);
}

/* RTL-aware checked thumb position */
:dir(ltr) .toggle:checked::before {
translate: 20px;
}

:dir(rtl) .toggle:checked::before {
translate: -20px;
}

@media (prefers-reduced-motion: reduce) {
.toggle,
.toggle::before {
transition: none;
}
}

/* Support forced colors */
@media (forced-colors: active) {
label > span {
background: Canvas;
color: Highlight;
forced-color-adjust: none;
}

label:has(.toggle:checked) > span {
background: Highlight;
color: Canvas;
}

.toggle::before {
forced-color-adjust: none;
background-color: Highlight;
}

.toggle,
.toggle:hover {
background: Canvas;
border-color: CanvasText;
}

.toggle:checked,
.toggle:checked:hover {
background: Highlight;
border-color: CanvasText;
}

.toggle:checked::before {
background: Canvas;
}
}
</style>
Loading