基本使用
Text 组件可以直接使用text属性设置文本内容,也可以直接在 children 中渲染文本。但需要注意的是,某些情况必须使用属性设置,例如下面介绍的ellipsisOffset以及ellipsis=center
使用as属性可渲染为不同内容,如link、code、blockquote等,详细可见下面的其他小节
单行超出隐藏
添加ellipsis属性即可使元素在限定宽度的容器中隐藏超出的内容,并显示省略号。省略号的位置默认为文档方向结束(end)位置,可以设置start或center,其他所有值均视为end。
注
谨慎使用ellipsis=center,其利用 float 实现,且依赖于元素的高度和行高一致。float 左边可能会出现一些空白,需要手动调整右边的宽度以及设置text-align、word-break等等,比较不友好,而且在 rtl 下句尾的符号显示不正确。
若以后原生支持设置为中间则火速弃用现在的实现
推荐使用ellipsisOffset设置固定的偏移字符数来让省略号在中间显示,见下一小节
省略号偏移
通过ellipsisOffset可设置省略号偏移的字符数,偏移的字符数以ellipsis的位置决定,例如当为end时偏移从text末尾算起,不支持ellipsis=center
链接
使用as="link"可以将文本渲染为超链接
代码片段
使用as="code"可以将文本渲染为代码片段
主题属性
文字组件的主题属性,除了 size 可以继承父组件或使用全局设置,其他属性均需要在组件上直接设置
这是因为 shadowRoot 里没有再包裹一层元素,可能会考虑变更
引用片段
使用as="blockquote"可以将文本渲染为引用片段
不同颜色
文字颜色默认受主题中的grayColor影响,主动设置color属性可以使文字颜色为主题色,但如果同时设置了grayColor属性,则优先使用灰色。
不同大小
不同于一般的组件,Text 组件支持 1 ~ 9 的 size 设置