Text
溢出文字的省略位置可选,支持自动、循环与悬停滚动
用法
省略位置
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 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
text | string | - | 完整文本,放得下时整段显示。 |
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