Checkbox

listens-checkbox@listenssoft/speechui-angular

Multi select by voice: “toppings cheese and olives” toggles both.

A checkbox group holding a string[]. Speech toggles each option once per time it is spoken: “toppings cheese” checks Cheese; saying “cheese” again in the same breath unchecks it. Occurrence counting keeps interim recognition flutter from double-toggling.

Basic multi select

Loading the Angular kit…

Hold anywhere and say:“toppings mushrooms”“toppings cheese and olives”

Props

listeningContent
default command
disabled
default false

Angular

Updates as you tick props

import { Component } from "@angular/core";import { FormsModule } from "@angular/forms";import { ListensCheckboxComponent } from "@listenssoft/speechui-angular";
@Component({  selector: "demo-checkbox",  imports: [ListensCheckboxComponent, FormsModule],  template: `    <listens-checkbox      label="Toppings"      command="toppings"      [options]="['Cheese', 'Mushrooms', 'Olives', 'Peppers']"      [(ngModel)]="toppings"    />  `,})export class DemoCheckbox {  toppings = ["Cheese"];}

What you can say

Say	Effect
“toppings mushrooms”	Toggles Mushrooms.
“toppings cheese and olives”	Toggles both — every matched option in the remainder toggles.
“toppings cheese … cheese”	Checks Cheese, then unchecks it: each spoken occurrence is one toggle.
“…add mushrooms to the toppings…”	Works too — the command may appear anywhere; everything after it is matched.

A new utterance (after a pause) starts fresh, so repeating “toppings cheese” later toggles again. Aliases work exactly as on the radio group.

API reference

Angular inputs & outputs for @listenssoft/speechui-angular.

Inputs

Input	Type	Default	Description
`listeningContent`	`string`	`command`	Label text while the mic is open.
`disabled`	`boolean`	`false`	Disables the checkboxes.

Extra inputs

Input	Type	Default	Description
`value`	`string[]`	`[]`	Two-way bindable — [(value)]; also ngModel / formControlName (ControlValueAccessor, string[]).
`options`	`string[]`	`[]`	The options.
`command`	`string`	`label`	The spoken prefix.
`label`	`string`	`""`	Group label; the command fallback.
`aliases`	`Record<string, string[]>`	`{}`	Spoken aliases per option value.

Outputs

Output	Type	Default	Description
`valueChange`	`string[]`	—	The [(value)] channel.
`matched`	`string[]`	—	Emits when speech toggles options, with the next checked set.

Styling hooks

CSS hooks

Hook	Type	Default	Description
`.listens-checkbox (root)`	`class`	—	Same part classes as React.
`--listens-interactive`	`token`	—	The checkbox accent color.

Behavior notes

All frameworks: Unlike the radio group, the checkbox matches the command anywhere in the phrase (contains), then matches everything after it.