# text

> 基础库 1.0.0 开始支持，低版本需做[兼容处理](1003706)。

> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

渲染框架支持情况：Skyline （使用最新 [Nightly](/miniprogram/dev/devtools/nightly.html) 工具调试）、WebView

## 功能描述

文本。

1. 内联文本只能用 text 组件，不能用 view，如 <text> foo <text>bar</text> </text>

2. 新增 span 组件用于内联文本和图片，如 <span> <image> </image> <text>bar</text> </span>

## 通用属性


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

## Skyline 特有属性


```json
[
  {
    "属性": "overflow",
    "类型": "string",
    "默认值": "visible",
    "必填": "是",
    "说明": "文本溢出处理",
    "子项": [
      {
        "合法值": "clip",
        "说明": "修剪文本"
      },
      {
        "合法值": "fade",
        "说明": "淡出"
      },
      {
        "合法值": "ellipsis",
        "说明": "显示省略号"
      },
      {
        "合法值": "visible",
        "说明": "文本不截断"
      }
    ]
  },
  {
    "属性": "max-lines",
    "类型": "number",
    "默认值": "",
    "必填": "是",
    "说明": "限制文本最大行数"
  },
  {
    "属性": "select-on-gesture",
    "类型": "boolean",
    "默认值": "true",
    "必填": "是",
    "说明": "是否允许通过手势选择文本，关闭后通常可以结合 SelectionContext.selectRange 接口使用"
  }
]
```

## WebView 特有属性


```json
[
  {
    "属性": "space",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "显示连续空格",
    "最低版本": "[1.4.0](1003706)",
    "子项": [
      {
        "合法值": "ensp",
        "说明": "中文字符空格一半大小"
      },
      {
        "合法值": "emsp",
        "说明": "中文字符空格大小"
      },
      {
        "合法值": "nbsp",
        "说明": "根据字体设置的空格大小"
      }
    ]
  },
  {
    "属性": "decode",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "是否解码",
    "最低版本": "[1.4.0](1003706)"
  }
]
```

## Bug & Tip

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

## 示例代码

[在开发者工具中预览效果](https://developers.weixin.qq.com/s/LQxYkQmm7fJj)