Reference

ThemeToggle

A button that switches the page between light and dark, over setTheme: a moon in a light page, a sun in a dark one, named for the theme it switches to. The reader's choice is kept.

ThemeToggle

Since 6.2.0

No props to try.

Appearance

Example

wf

Row(gap: .sm, align: .center, justify: .between) { Text("Appearance").bold ThemeToggle } Text("The theme is {theme}.").muted

Beside a choice of three

wf

Row(gap: .sm) { ThemeToggle Button("Follow the system").sm { on click { setTheme("system") } } }

Related:

LocaleSwitch

Props

This element takes no props of its own.

Attribute families: global, aria, data. Plus the 22 universal props every element takes: animate:, exit:, speed:, duration:, delay:, easing:, stagger:, on:, count:, shared:, class:, ref:, drag:, dragGroup:, dropValue:, dropAxis:, dropInside:, roving:, trapFocus:, mount:, update:, cleanup:.

Flags and cases

A flag is written after the parentheses with a dot: a Bool prop, or a case of one of the element's enum props. A case the enum lacks is an error with a hint.

No flags of its own.

Events

Every element also takes the props, the events and the attribute families listed on every element.

Slots

It takes no slots.

Renders with the class wf-icon-btn wf-theme-toggle, stable across releases, so a stylesheet may target it.

These controls list the props' cases; the example below shows them written.