基础组件

Typography

Alune 月光主题下的文字，直接保留 Ant Design 原有属性、类型与行为。

使用方式

文字由宿主传入状态和回调，适合在不同应用和文档中复用。先完成快速开始中的 Provider 与样式配置。

import { Typography } from '@alune/ui';

接入要求见快速开始，选择依据见交互与无障碍规范。

运行示例

运行与复制源码来自同一 TSX 文件。浮层、状态和主题独立于文档；所有回调只更新本地模拟数据。

查看运行源码

源码文件

import { Typography } from '@alune/ui';

export default function Example() {
  return (
    <div className="example">
      <div>
        <Typography.Title level={3}>清晰的内容层级</Typography.Title>
        <Typography.Paragraph>说明文字使用语义化段落，并保持可读对比度。</Typography.Paragraph>
      </div>
      <div className="example-row">
        <Typography.Text type="secondary">辅助说明</Typography.Text>
        <Typography.Text code>main</Typography.Text>
      </div>
    </div>
  );
}

API

直接转导出 Ant Design 的 Typography，保留原始 Props、泛型、复合成员与回调语义。下表列出常用属性；类型取自当前安装版本，默认值沿用 Ant Design 6。

AluneUIProvider 统一主题与减少动效；宿主维护受控状态、校验和业务回调。

Typography 完整 API 与默认值 ↗

Typography

TypographyProps

属性 / 方法	类型	默认值	必填	说明
`children`	`ReactNode`	`—`	否	文本或排版子内容。

TextProps

属性 / 方法	类型	默认值	必填	说明
`type`	`BaseType`	`—`	否	secondary / success / warning / danger。
`strong`	`boolean`	`false`	否	加粗。
`copyable`	`boolean \| CopyConfig`	`false`	否	复制操作及配置。
`ellipsis`	`boolean \| Omit<EllipsisConfig, "rows" \| "expandable" \| "onExpand">`	`false`	否	单行省略。

TitleProps

属性 / 方法	类型	默认值	必填	说明
`level`	`2 \| 1 \| 5 \| 3 \| 4`	`1`	否	标题层级 1～5，需符合文档结构。
`type`	`BaseType`	`—`	否	文本语义。
`copyable`	`boolean \| CopyConfig`	`false`	否	复制操作及配置。
`ellipsis`	`boolean \| EllipsisConfig`	`false`	否	省略配置。

ParagraphProps

属性 / 方法	类型	默认值	必填	说明
`type`	`BaseType`	`—`	否	文本语义。
`copyable`	`boolean \| CopyConfig`	`false`	否	复制操作及配置。
`ellipsis`	`boolean \| EllipsisConfig`	`false`	否	行数与展开配置。
`editable`	`boolean \| EditConfig`	`false`	否	可编辑配置。

交互与使用限制

为每个操作提供可访问名称，为输入关联 label；使用语义化组件和清晰焦点。不要只靠颜色传达状态，禁用与等待时避免重复执行。

宿主负责状态、业务操作、错误处理与真实内容。组件不读取业务 store、路由或 Electron。示例中的反馈和等待均为本地模拟。

键盘、焦点、风险确认与通知策略的完整约定见交互规范。

查看实现 ↗ 编辑文档 ↗ 设计与验收