#text
文本渲染组件,是展示文字内容的基础元件,支持文字样式配置。
#扫码预览
#Props
| 属性名 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| children | ReactNode | - | 否 | 子元素 |
| className | string | - | 否 | 组件类名 |
| customContextMenu | boolean | false | 否 | 开启文本选择后,是否使用自定义弹窗菜单 |
| flatten | boolean | true | 否 | 是否将节点扁平化以加速渲染,开启文本选择等需要真实节点的能力时需设为 false |
| id | string | - | 否 | 元素的唯一标识 |
| key | string | number | null | - | 否 | React key 属性 |
| onClick | (event: TouchEvent) => void | - | 否 | 点击时的回调函数 |
| onLayout | (event: LayoutEvent) => void | - | 否 | 文本布局完成时触发,事件对象包含文本布局信息 |
| onSelectionChange | (event: SelectionChangeEvent) => void | - | 否 | 文本选择变化时触发(需开启 text-selection) |
| ref | Ref<NodesRef> | - | 否 | 用于获取组件实例的 ref |
| style | CSSProperties | - | 否 | 组件样式 |
| tailColorConvert | boolean | false | 否 | 文本截断时,省略号颜色是否使用外层 text 标签样式(默认使用最近 inline-text 样式) |
| textMaxline | string | - | 否 | 文本显示的最大行数,超出将显示省略号 |
| textSelection | boolean | false | 否 | 是否开启文本选择功能,开启时需同时设置 flatten={false} |
| textSingleLineVerticalAlign | "bottom" | "top" | "center" | "normal" | 'normal' | 否 | 单行纯文本在行内垂直居中/对齐方式,inline 文本不支持 |