Skip to content
Theme color
Gray color
AppearanceSizeSmall(1)Medium(2)Large(3)Radius
none
small
medium
large
full
Scale90%95%100%105%110%

基本使用

Text 组件可以直接使用text属性设置文本内容,也可以直接在 children 中渲染文本。但需要注意的是,某些情况必须使用属性设置,例如下面介绍的ellipsisOffset以及ellipsis=center

使用as属性可渲染为不同内容,如linkcodeblockquote等,详细可见下面的其他小节

单行超出隐藏

添加ellipsis属性即可使元素在限定宽度的容器中隐藏超出的内容,并显示省略号。省略号的位置默认为文档方向结束(end)位置,可以设置startcenter,其他所有值均视为end

谨慎使用ellipsis=center,其利用 float 实现,且依赖于元素的高度和行高一致。float 左边可能会出现一些空白,需要手动调整右边的宽度以及设置text-alignword-break等等,比较不友好,而且在 rtl 下句尾的符号显示不正确。

若以后原生支持设置为中间则火速弃用现在的实现

推荐使用ellipsisOffset设置固定的偏移字符数来让省略号在中间显示,见下一小节

省略号偏移

通过ellipsisOffset可设置省略号偏移的字符数,偏移的字符数以ellipsis的位置决定,例如当为end时偏移从text末尾算起,不支持ellipsis=center

链接

使用as="link"可以将文本渲染为超链接

代码片段

使用as="code"可以将文本渲染为代码片段

主题属性

文字组件的主题属性,除了 size 可以继承父组件或使用全局设置,其他属性均需要在组件上直接设置

这是因为 shadowRoot 里没有再包裹一层元素,可能会考虑变更

引用片段

使用as="blockquote"可以将文本渲染为引用片段

不同颜色

文字颜色默认受主题中的grayColor影响,主动设置color属性可以使文字颜色为主题色,但如果同时设置了grayColor属性,则优先使用灰色。

不同大小

不同于一般的组件,Text 组件支持 1 ~ 9 的 size 设置