# text

基础库 1.0.0 开始支持,低版本需做兼容处理

微信 Windows 版:支持

微信 Mac 版:支持

微信 鸿蒙 OS 版:支持

渲染框架支持情况:Skyline (使用最新 Nighly 工具调试)、WebView

# 功能描述

文本。

  1. 内联文本只能用 text 组件,不能用 view,如 <text> foo <text>bar</text> </text>
  2. 新增 span 组件用于内联文本和图片,如 <span> <image> </image> <text>bar</text> </span>

# 通用属性

属性 类型 默认值 必填 说明 最低版本
selectable boolean false 文本是否可选 (已废弃) 1.1.0
user-select boolean false 文本是否可选,该属性会使文本节点显示为 inline-block 2.12.1

# Skyline 特有属性

属性 类型 默认值 必填 说明
overflow string visible 文本溢出处理
合法值 说明
clip 修剪文本
fade 淡出
ellipsis 显示省略号
visible 文本不截断
max-lines number 限制文本最大行数

# WebView 特有属性

属性 类型 默认值 必填 说明 最低版本
space string 显示连续空格 1.4.0
合法值 说明
ensp 中文字符空格一半大小
emsp 中文字符空格大小
nbsp 根据字体设置的空格大小
decode boolean false 是否解码 1.4.0

# Bug & Tip

  1. tip: decode可以解析的有 &nbsp; &lt; &gt; &amp; &apos; &ensp; &emsp;
  2. tip: 各个操作系统的空格标准并不一致。
  3. tip:text 组件内只支持 text 嵌套。
  4. tip: 除了文本节点以外的其他节点都无法长按选中。
  5. bug: 基础库版本低于 2.1.0 时, text 组件内嵌的 text style 设置可能不会生效。

# 示例代码

在开发者工具中预览效果