Text

统一展示文本，支持排版与截断，适合正文、标签和受限空间中的信息表达。

我们正在让 SnowUI 组件成为 AI 对话中可直接操作的界面。目前对话交互能力仍在建设中；本页展示网站用法，支持的对话平台与组件版本将在验证后公布。 AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。

如何使用

用于文本语义、截断、展开和提示。默认不启用 hover 动效；静态普通文字可使用语义 HTML，动态数值或文字过渡按动效组件选择。

import { Text } from '@snowui-design-system/components';

属性	类型	默认值	示例	描述
`tag`	`string`	`—`	`tag="Example"`	根节点标签。默认行为：span。
`stateText`	`StateValueMap<string \| number>`	`—`	`stateText={stateTextOptions}`	根据最近父级 Frame 的 `currentState` 渲染文本；未命中当前状态时回退 `Idle`，再回退 children。
`interactive`	`boolean`	`false`	`interactive`	是否启用 Text hover 动效；显式传 `true` 时开启，默认关闭。
`lines`	`0 \| 1 \| 2 \| 3`	`—`	`lines={value}`	文本截断模式：`0`=可展开，`1/2/3`=固定行数。
`more`	`boolean`	`false`	`more`	`lines=0` 时生成内置展开 Button；默认样式为示例 6 的 ArrowLineDown 按钮。
`tooltip`	`TooltipProp`	`—`	`tooltip={value}`	Tooltip 配置。支持自动推导、固定文本、Snippet，或传对象仅覆写 Tooltip 位置/偏移等配置。
`onTruncate`	`(isTruncated: boolean) => void`	`—`	`onTruncate={(value) => { /* handle value */ }}`	截断状态变化回调。
`children`	`Snippet<[any]>`	`—`	`<Text>Content</Text>`	默认文字或自定义内容，接收含 breakpoint 的渲染上下文；stateText 命中时以对应状态文本替代。
`parts`	`ComponentPartsOf<{ Button: typeof Button; Tooltip: typeof Tooltip; }>`	`—`	`parts={partsOptions}`	仅配置内置 Button 与 Tooltip；显式 children 中的同名组件不继承。