LevelChatDocs
Docs
SettingsModal

Components

SettingsModal

In-call device + display preferences, in a focused, ESC-closable modal.

SettingsModal is the in-call preferences surface — three default tabs (Audio, Video, Display) with device pickers, the noise-suppression toggle, and a placeholder for display preferences. Controlled (open + onOpenChange) so the host app owns visibility.

Install

pnpm add @levelchat/react-components @levelchat/web

Basic usage

import { SettingsModal } from '@levelchat/react-components';

const [open, setOpen] = useState(false);

<SettingsModal open={open} onOpenChange={setOpen} />

Custom tabs

Pass a tabs array to replace or extend the defaults:

<SettingsModal
  open={open}
  onOpenChange={setOpen}
  tabs={[
    { id: 'audio',     label: 'Audio',     render: (s) => <AudioPrefs state={s} /> },
    { id: 'captions',  label: 'Captions',  render: () => <CaptionsPrefs /> },
    { id: 'shortcuts', label: 'Shortcuts', render: () => <KeyboardPrefs /> },
  ]}
/>

Accessibility

  • role="dialog" + aria-modal="true".
  • First tab focused on open; focus restored to the trigger on close.
  • ESC closes; backdrop click closes; content click never propagates.
  • role="tablist" + role="tab" + role="tabpanel" for the section nav.

Props

PropTypeDefaultNotes
openbooleanrequiredModal visibility.
onOpenChange(next: boolean) => voidrequiredVisibility setter.
tabsSettingsTab[]Audio / Video / DisplayReplace or extend the default tabs.
titlestring"Settings"Header label.
SettingsModal — LevelChat Docs