List
ListensList@listenssoft/speechui-react-nativeAn editable checklist you can talk to: “checklist add fuel cells and rations”.
The most conversational control: add, delete, check, uncheck, rename, and clear — by voice. Adds stream in live (say “add milk and eggs” and watch two items form as you speak); renames chain correctly across interim results (“rename chicken to beef” lands on beef, not half a word). Tapping a row toggles it; the ✕ deletes.
Basic editable list
Loading the React Native kit…
Hold anywhere and say:“checklist add fuel cells and rations”“checklist check star charts”“checklist delete rations”
Props
- not set
import { ListensList } from "@listenssoft/speechui-react-native";import { useState } from "react";
function Demo() { const [items, setItems] = useState([ { id: "1", text: "oxygen tanks", checked: true }, { id: "2", text: "star charts", checked: false }, ]); return ( <ListensList label="Pre-flight checklist" command="checklist" value={items} onChange={setItems} /> );}What you can say
| Say | Effect |
|---|---|
| “checklist add fuel cells and rations” | Adds two items — “and” separates them; the items refine live while you speak. |
| “checklist delete rations” | Deletes the item whose text matches. “remove” works as a synonym. |
| “checklist check star charts” | Checks the matching item; “uncheck …” clears it. |
| “checklist rename star charts to nav charts” | Renames in place — the new name accumulates correctly as you speak. |
| “checklist clear” | Removes every item. |
With no command configured, the bare action words work directly: “add milk”, “clear”. Item-name matching is on the normalized text (case and quotes ignored). onMatch fires once when listening stops, with the final items.
API reference
React Native props for @listenssoft/speechui-react-native.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
disabled | boolean | — | Disables row interaction. |
Extra props
| Prop | Type | Default | Description |
|---|---|---|---|
command | string | label | The spoken action prefix. |
label | string | — | Label above the list; the command fallback. |
value | ListensListItem[] | — | Controlled items. |
onChange | (items: ListensListItem[]) => void | — | Called with the next items. |
onMatch | (items: ListensListItem[]) => void | — | Fires once when listening stops after speech edits. |
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 / theme.danger | token | — | Checkbox fill and the delete affordance. |
Behavior notes
- All frameworks: Utterance boundaries matter and are handled: pause, then “checklist add beef” starts a new item instead of revising the previous one.
