Nexub DS

Components · AI

Assistant text as it arrives: new chunks fade in, text already shown stays still, and a caret marks the end.

import { Streaming Text } from '@nexub/react';

Usage

When to use

Reach for this component when…

When not to use

Pick a different component if…

Finished text loaded from history: render it as plain text, or with `streaming={false}`.
Model output as HTML or Markdown HTML: StreamingText renders text only. Parse Markdown to React elements yourself; never inject model HTML.

Words arrive on a timer. Restart streams the paragraph again.

Prop	Type	Default	Required	Description
text	string	—	✓	The full text received so far. Append to it; anything that is not an append renders statically.
streaming	boolean	false	—	Shows the caret and sets `aria-busy` while more text is expected.
as	'div' \| 'p' \| 'span'	'div'	—	Element to render.
aria-live	'off' \| 'polite'	'off'	—	Opt-in live announcements. Leave off: screen readers would re-read the region on every token.

Usage

When to use

Reach for this component when…

When not to use

Pick a different component if…

Finished text loaded from history: render it as plain text, or with `streaming={false}`.
Model output as HTML or Markdown HTML: StreamingText renders text only. Parse Markdown to React elements yourself; never inject model HTML.

Props

Prop	Type	Default	Required	Description
text	string	—	✓	The full text received so far. Append to it; anything that is not an append renders statically.
streaming	boolean	false	—	Shows the caret and sets `aria-busy` while more text is expected.
as	'div' \| 'p' \| 'span'	'div'	—	Element to render.
aria-live	'off' \| 'polite'	'off'	—	Opt-in live announcements. Leave off: screen readers would re-read the region on every token.

Accessibility