v2.13.0

ColorModeButton

A button to toggle between light and dark themes.

Usage

The ColorModeButton component extends the Button component, so you can pass any property such as color, size, etc.

<template>
  <B24ColorModeButton />
</template>
The button defaults to color="air-tertiary-no-accent".

API

Props

Prop Default Type
as'button'any

The element or component this component should render as when not a link.

color'air-tertiary-no-accent'"air-primary" | "air-primary-success" | "air-primary-alert" | "air-primary-copilot" | "air-secondary" | "air-secondary-alert" | "air-secondary-accent" | "air-secondary-accent-1" | "air-secondary-accent-2" | "air-secondary-no-accent" | "air-tertiary" | "air-tertiary-accent" | "air-tertiary-no-accent" | "air-selection" | "air-boost"
loadingboolean

When true, the loading icon will be displayed.

iconIconComponent

Display an icon on the left side.

size'md' "md" | "xs" | "sm" | "lg" | "xl" | "xss"
avatar AvatarProps

Display an avatar on the left side.

autofocus false | true | "true" | "false"
disabledboolean
name string
type'button' "reset" | "submit" | "button"

The type of the button when not a link.

label string
activeColor"air-primary" | "air-primary-success" | "air-primary-alert" | "air-primary-copilot" | "air-secondary" | "air-secondary-alert" | "air-secondary-accent" | "air-secondary-accent-1" | "air-secondary-accent-2" | "air-secondary-no-accent" | "air-tertiary" | "air-tertiary-accent" | "air-tertiary-no-accent" | "air-selection" | "air-boost"
depth'normal' "light" | "dark" | "normal"
Deprecated — removed in 3.0.0

Renders nothing on the air-* colours, the default among them: the depth compound variants are keyed on the legacy colour names only.

activeDepth "light" | "dark" | "normal"
Deprecated — removed in 3.0.0

Same as depth — no effect on the air-* colours.

roundedfalseboolean

Rounds the corners of the button

blockfalseboolean

Render the button full width

loadingAutofalseboolean

Set loading state automatically based on the @click promise state

normalCasetrueboolean

Disable uppercase label

useWaitfalseboolean

Shows LoaderWaitIcon in loading mode

useClockfalseboolean

Shows LoaderClockIcon icon in loading mode

useDropdownfalseboolean

Shows a dropdown chevron on the right side, from the dictionary's chevronDown role, so an app.config override reaches it.

b24ui { base?: SlotClass; baseLoading?: SlotClass; baseLoadingWaitIcon?: SlotClass; baseLoadingClockIcon?: SlotClass; baseLoadingSpinnerIcon?: SlotClass; baseLine?: SlotClass; label?: SlotClass; labelInner?: SlotClass; leadingIcon?: SlotClass; leadingAvatar?: SlotClass; leadingAvatarSize?: SlotClass; trailingIcon?: SlotClass; safeList?: SlotClass; }
This component also supports all native <button> HTML attributes.

Slots

Slot Type