Message Actions
消息下方的操作条,内置复制、重新生成与朗读
用法
基础
Loading demo...
最佳实践
- 自定义操作用原生
<button>或带tabindex的元素;不可聚焦的元素不会进入方向键顺序。 - 剪贴板写入失败时
copy照常触发;需要兜底就在copy中处理,不要另写一份复制。 - 本地化时一并覆盖
copyLabel、copiedLabel、regenerateLabel、speakLabel、stopSpeakLabel与label。 - 消息流式输出结束后再挂载操作条,避免复制到半截内容。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
copyText | string | — | 复制按钮写入的文本;未传时不渲染复制按钮。 |
regenerable | boolean | false | 显示重新生成按钮。 |
speakable | boolean | false | 显示朗读按钮;播放由宿主负责。 |
speakState | 'idle' | 'loading' | 'speaking' | 'idle' | 宿主回写的播放状态:loading 显示旋转环,speaking 显示停止图标。 |
appear | boolean | true | 挂载时播放模糊淡入。 |
copyLabel | string | 'Copy' | 复制按钮的可访问名称与悬停提示。 |
copiedLabel | string | 'Copied' | 已复制状态的可访问名称与悬停提示。 |
regenerateLabel | string | 'Regenerate' | 重新生成按钮的可访问名称与悬停提示。 |
label | string | 'Message actions' | 工具栏的可访问名称。 |
speakLabel | string | 'Read aloud' | 朗读按钮的可访问名称与悬停提示。 |
stopSpeakLabel | string | 'Stop reading' | speaking 时朗读按钮的可访问名称与悬停提示。 |
事件
| 事件名 | 参数 | 说明 |
|---|---|---|
copy | (text: string) | 点击复制后触发,携带 copyText;剪贴板写入失败时同样触发。 |
regenerate | — | 点击重新生成时触发。 |
speak | — | 点击朗读按钮时触发。 |
插槽
| 插槽名 | 说明 |
|---|---|
default | 追加在内置按钮之后;其中的可聚焦元素自动加入方向键顺序。 |
概述
copyText为空字符串时仍渲染复制按钮,但点击无效果;要隐藏就不传。- 复制写入
navigator.clipboard,随后按钮进入「已复制」态 1200ms,期间忽略重复点击。 - 朗读按钮是开关:任何状态下点击都派发
speak(含loading),由宿主开始或停止播放;speaking时aria-pressed="true"。 role="toolbar":只占一个 Tab 落点,方向键在控件间循环移动,Home / End 跳到首尾。- 方向键顺序实时读取 DOM(
button:not([disabled])、[href]、tabindex非 -1),禁用按钮被排除。
技术实现
- 方向键顺序每次调用都由
querySelectorAll从 DOM 查询,不做缓存;插槽里可聚焦的元素同样计入。 - 复制经
navigator.clipboard.writeText;「已复制」态由 1200 毫秒的setTimeout收回,再次复制前先清除旧计时器。 - 源码:
packages/tuffex/packages/components/src/message-actions/。
查看源码
packages/tuffex/packages/components/src/message-actions/index.ts