Combobox
ListensComboBox@listenssoft/speechui-react-nativeA filterable select with a spoken trigger word: “destination” opens it, “Mars” picks it.
The command word toggles the dropdown. While it's open, spoken words match options (aliases included) — a full match selects and closes; a partial match narrows the visible list, so “euro” filters to Europa. Saying “clear” shortly after the command empties the selection. Typing filters exactly the same way.
Basic combobox
Loading the React Native kit…
Hold anywhere and say:“destination”“destination mars”“clear (after the command)”
Props
- not set
- not set
React Native
Updates as you tick propsimport { ListensComboBox } from "@listenssoft/speechui-react-native";import { useState } from "react";
function Demo() { const [destination, setDestination] = useState(""); return ( <ListensComboBox label="Destination" command="destination" options={["Luna", "Mars", "Europa", "Titan", "Ganymede"]} placeholder="Choose a destination…" value={destination} onChange={setDestination} /> );}What you can say
| Say | Effect |
|---|---|
| “destination” | Toggles the dropdown. If it was already open with nothing after the word, a brief close-delay runs — you might be about to name an option. |
| “destination mars” | Opens and selects Mars in one phrase. |
| “europa (while open)” | Selects it. Speech only matches options while the dropdown is open — a closed box ignores stray speech. |
| “euro (while open)” | No full match: narrows the list to options containing the fragment. |
| “clear” | Empties the selection — recognized within ~8 seconds of the command word. |
The dropdown never opens from stray speech: only the command word, autoOpenOnListening, or a click opens it.
API reference
React Native props for @listenssoft/speechui-react-native.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
placeholder | string | — | Input placeholder. |
autoOpenOnListening | boolean | — | Open when listening starts (empty selection only). |
disabled | boolean | — | Disables the input and dropdown. |
Extra props
| Prop | Type | Default | Description |
|---|---|---|---|
options* | string[] | — | The selectable options. |
value | string | — | Controlled value. |
onChange | (value: string) => void | — | Called on select and clear. |
command | string | label | The spoken trigger word. |
label | string | — | Label above the input; the command fallback. |
aliases | Record<string, string[]> | — | Spoken aliases per option. |
style / labelStyle | StyleProp | — | Container and label overrides. |
Styling hooks
Style props and theme keys
| Hook | Type | Default | Description |
|---|---|---|---|
style / labelStyle | StyleProp | — | Direct overrides. |
theme.surface / theme.border / theme.menuHairline | token | — | Dropdown chrome colors. |
Behavior notes
- All frameworks: The close-delay timer (≈1.5s after a bare command word) lives in the component; the interpreter is told when it fires so debouncing stays correct.
