Some properties provide flexibility for specific integrations. Follow the component's usage guidance. Customizations beyond the documented patterns need a use case approved by DNB UX. Read about intended use and customization.
Experimental: The AI extension and its component APIs may change in the future. Please give us feedback on your experience with them.
Properties#
| Type | Description | |
|---|---|---|
status | "running" "done" "error" "canceled" | (optional) Display status supplied by the application. Progress never changes the status automatically. |
actionLabel | string | (optional) The action verb shown before the progress pill while running, e.g. Paying. |
children | string | (required) The target text while running, or the action result, e.g. Spotify Premium while running and Spotify Premium paid. when done. |
agentAvatar | React.ReactNode | (optional) Decorative agent avatar. Defaults to a small Aino Avatar. Use false to hide it. |
targetVisual | React.ReactNode | (optional) Decorative content beside the target text inside the progress pill, such as an Avatar, icon, or image. |
progress | number | (optional) Progress from 0 to 100. Omit it when progress is unknown. Values are clamped; non-finite values use indeterminate progress. |
undoUntil | number | (optional) Absolute Unix timestamp in milliseconds for the Undo deadline. Without it, Undo remains available until the application removes onUndo. |
undoLabel | string | (optional) Undo button text. Defaults to a translated text. |
undoDisabled | boolean | (optional) Disable Undo while the application handles the request. |
announce | boolean | (optional) Announce status, text, and Undo availability changes. Set to false for historical actions or when the application owns announcements. |
Space | string object | (optional) Spacing properties like top or bottom are supported. |
Translations#
| Key | Purpose |
|---|---|
undo | Undo button label. |
undoTimeLeft | Label for the quiet countdown. |
undoAvailable | Announces availability. %action is the button label. |
undoAvailableFor | Announces a time limit. %action is the button label and %seconds is the remaining time. |
undoAvailableForOneSecond | Singular form of the time-limit announcement. |
undoAvailableUntil | Stable button description. %action is the button label and %time is the localized expiry time. |
undoUnavailable | Announces expiry. %action is the button label. |
Status announcements reuse the Ai.Task translations. Application-specific action and result text must be translated by the application. See AI translations.