Radio group
ListensRadioGroup@listenssoft/speechui-react-nativeSingle select by voice: “size large” picks Large.
Say the command followed by an option. The group claims the phrase only when something follows the command, then matches the remainder against options as whole words — longest matching phrase wins, so “Very Satisfied” beats “Satisfied” when both fit. aliases map spoken words to option values, which is how “standard” selects STD.
Basic single select
Loading the React Native kit…
Hold anywhere and say:“size large”“size small”
Props
- not set
import { ListensRadioGroup } from "@listenssoft/speechui-react-native";import { useState } from "react";
function Demo() { const [size, setSize] = useState("Medium"); return ( <ListensRadioGroup label="Size" command="size" options={["Small", "Medium", "Large"]} value={size} onChange={setSize} /> );}Aliases for spoken names
Option values are often codes or abbreviations nobody would say aloud. aliases maps each value to the phrases people actually speak.
Loading the React Native kit…
Hold anywhere and say:“shipping express”“shipping overnight”
import { ListensRadioGroup } from "@listenssoft/speechui-react-native";import { useState } from "react";
function Demo() { const [shipping, setShipping] = useState("STD"); return ( <ListensRadioGroup label="Shipping" command="shipping" options={["STD", "EXP", "PRI"]} aliases={{ STD: ["standard", "regular"], EXP: ["express", "fast"], PRI: ["priority", "overnight"], }} value={shipping} onChange={setShipping} /> );}What you can say
| Say | Effect |
|---|---|
| “size large” | Selects “Large”. The command must lead the phrase, with the option after it. |
| “size extra large” | Selects the longest option whose words all appear — “Extra Large” beats “Large” when both are options. |
| “shipping overnight” | Aliases resolve to their option value (“overnight” → PRI). |
| “large (alone)” | No effect — without the leading command the group never claims the phrase. |
Matching is whole-word: “size l” matches nothing, and stray words around the option are fine (“size large please”).
API reference
React Native props for @listenssoft/speechui-react-native.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
disabled | boolean | — | Disables the options. |
Extra props
| Prop | Type | Default | Description |
|---|---|---|---|
options* | string[] | — | The selectable values. |
command | string | label | The spoken prefix; “<command> <option>” selects. |
label | string | — | Group label; the command fallback. |
value | string | — | Controlled selected value. |
onChange | (value: string) => void | — | Called with the selected value — tap or speech. |
aliases | Record<string, string[]> | — | Spoken aliases per option value, e.g. { Large: ["big"] }. |
style / labelStyle | StyleProp | — | Container and label overrides. |
Styling hooks
Style props and theme keys
| Hook | Type | Default | Description |
|---|---|---|---|
style / labelStyle | StyleProp | — | Direct overrides. |
theme.interactive | token | — | The selected radio's fill. |
Behavior notes
- All frameworks: The radio group uses the two-pass claim flow: it claims only when the command leads with a non-empty remainder, so “size” alone leaves the transcript for others.
