组件/Text

Text

溢出文字的省略位置可选,支持自动、循环与悬停滚动

Verified自 0.9.3

用法

省略位置

Loading demo...

滚动方式

Loading demo...

循环滚动

Loading demo...

最佳实践

  • 给 TxText 一个确定的宽度,或放进定宽的容器;它本身不会撑开父元素。
  • 内边距和边框放在外层容器上,不要直接加在 TxText 上。
  • 文件名用 overflow="middle",保留开头和扩展名;路径用 overflow="start",保留文件名。
  • 同一列表里不要所有条目都用 scroll="auto" 或 scroll="loop",会分散注意力;需要读全文时用 scroll="hover"。
  • 循环滚动默认的 loopEdge="gap" 会让文字整段消失再进来;想保留边缘的渐隐用 loopEdge="fade",想让视口里始终有字用 loopEdge="wrap"。

API 参考

属性

属性名类型默认值说明
textstring-完整文本,放得下时整段显示。
overflow'start' | 'middle' | 'end''end'溢出时省略号放在开头、中间或末尾。scroll="auto" 和 scroll="loop" 时不生效。
scroll'none' | 'auto' | 'hover' | 'loop''none'auto 来回摆动;loop 循环滚动(边缘效果见 loopEdge);hover 悬停时滑动露出被截掉的部分,触屏上改为点按切换。
loopEdge'gap' | 'clip' | 'fade' | 'wrap''gap'仅 scroll="loop" 时生效。gap 移出的文字完全消失后再进入;clip 间隔两个字宽、边缘硬切;fade 同 clip,并在两端渐隐;wrap 首尾相接,视口里始终有字。

概述

  • 根节点是 <span>,默认 display: block,宽度由外层决定。
  • 末尾省略用 CSS;开头和中间省略由测量决定,挂载、尺寸变化和字体加载完成后重新计算。截断时 title 给出完整文本。
  • 循环滚动只在文字溢出时启动,速度约 40px/s,只动 transform。
  • 触屏上 scroll="hover" 点一下展开,再点一下或点组件外收回。
  • 屏幕阅读器读到的是完整文本,不会读到截断后的省略形式。
  • 减少动效时所有滚动都停止,回到静态截断。

技术实现

  • 源码:packages/tuffex/packages/components/src/text/。
查看源码
packages/tuffex/packages/components/src/text/index.ts