组件/Message Actions

Message Actions

消息下方的操作条,内置复制、重新生成与朗读

Verified自 0.3.9

用法

基础

Loading demo...

最佳实践

  • 自定义操作用原生 <button> 或带 tabindex 的元素;不可聚焦的元素不会进入方向键顺序。
  • 剪贴板写入失败时 copy 照常触发;需要兜底就在 copy 中处理,不要另写一份复制。
  • 本地化时一并覆盖 copyLabel、copiedLabel、regenerateLabel、speakLabel、stopSpeakLabel 与 label。
  • 消息流式输出结束后再挂载操作条,避免复制到半截内容。

API 参考

属性

属性名类型默认值说明
copyTextstring—复制按钮写入的文本;未传时不渲染复制按钮。
regenerablebooleanfalse显示重新生成按钮。
speakablebooleanfalse显示朗读按钮;播放由宿主负责。
speakState'idle' | 'loading' | 'speaking''idle'宿主回写的播放状态:loading 显示旋转环,speaking 显示停止图标。
appearbooleantrue挂载时播放模糊淡入。
copyLabelstring'Copy'复制按钮的可访问名称与悬停提示。
copiedLabelstring'Copied'已复制状态的可访问名称与悬停提示。
regenerateLabelstring'Regenerate'重新生成按钮的可访问名称与悬停提示。
labelstring'Message actions'工具栏的可访问名称。
speakLabelstring'Read aloud'朗读按钮的可访问名称与悬停提示。
stopSpeakLabelstring'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