Components

ToggleGroup

Segmented control component for single or multiple option selection.

iOSAndroid
Preview ToggleGroup on your device

Scan with Expo Go

Download Expo Go, then scan the QR code to preview native components.

Installation

pnpm dlx @docyrus/cli add @docyrus/rn-toggle-group

Usage

import { ToggleGroup, ToggleGroupItem } from '@/components/docyrus-native/toggle-group';

<ToggleGroup value={view} onValueChange={setView}>
  <ToggleGroupItem value="list">List</ToggleGroupItem>
  <ToggleGroupItem value="grid">Grid</ToggleGroupItem>
  <ToggleGroupItem value="board">Board</ToggleGroupItem>
</ToggleGroup>

API Reference

ToggleGroup

PropTypeDefaultDescription
type'single' | 'multiple''single'Selection mode
valuestring | string[]—Selected value(s)
onValueChange(value: string | string[]) => void—Value change handler
size'sm' | 'md' | 'lg''md'Item size
variant'default' | 'outline''default'Visual variant
disabledbooleanfalseDisable all items
childrenReactNode—ToggleGroupItem elements
classNamestring—Additional CSS classes

ToggleGroupItem

PropTypeDefaultDescription
valuestring—Item value (required)
childrenReactNode—Item content
disabledbooleanfalseDisable this item
classNamestring—Item CSS classes
textClassNamestring—Text CSS classes

Components

ComponentDescription
ToggleGroupRoot container with context provider
ToggleGroupItemIndividual toggle item

Type Exports

TypeDescription
ToggleGroupPropsProps for ToggleGroup
ToggleGroupItemPropsProps for ToggleGroupItem
ToggleGroupType'single' | 'multiple'
ToggleGroupSize'sm' | 'md' | 'lg'
ToggleGroupVariant'default' | 'outline'

On this page