Typography 排版
文本、标题、段落排版组件。
Text 文本
文本类型
修饰样式
自定义标记色（mark + CSS 变量）
字重档（weight）
数字等宽（numeric）
文本对齐（align）
文字深度（depth）
换标签（tag）
省略
文本省略
多行省略（line-clamp）
省略保留后缀（ellipsis-suffix）
可复制
可复制文本
自定义复制内容（copy-text）
操作条（actions）
操作条位置
字号档位（size）
size 提供三档字号：small（小字辅助）/ medium（基准，缺省回落继承字号）/ large（大字强调），映射 --oas-font-size-* token；sm/lg 别名等价，非法值回落 medium。仅 oas-text 开放（标题字号由 level 驱动，避免双轨打架）。
size 字号档
Title 标题
标题级别
Paragraph 段落
段落
内容块排版（blockquote / 列表 / 表格）
tag 白名单覆盖内容块级形态，三件（text/title/paragraph）通用——不引入独立长文容器，直接在现有 tag 体系上扩展：
tag="blockquote"：引用块（起始侧 token 边条 + 逻辑缩进，RTL 随书写方向镜像）；tag="ul"/tag="ol"：列表块（归一缩进，li 间距内建；li 内容放默认插槽）；tag="table"：内容表（全宽 + 合并边框；th/td 单元细节建议宿主自理或改用oas-table功能表）；- 表格部件（
thead/tbody/tr/th/td/caption）与描述列表（dl/dt/dd）同在白名单，可按需换标签。
列表/表格块采用解包投影：默认插槽直接挂在根元素上（ul 的子元素只能是 li、table 只收表格部件——content span 包装在这些标签下非法）。
引用块（tag=blockquote）
列表块（tag=ul / tag=ol）
内容表（tag=table）
th 加粗与 td 单元格的边框、内边距等细节样式由宿主自理（shadow 样式无法作用到插槽子树深层）；需要排序/筛选/分页等内容表请直接使用 oas-table。
API
| 组件 | 标签 | 属性 |
|---|---|---|
| Text | oas-text | type、ellipsis、copyable |
| Title | oas-title | level（1-5）、type、ellipsis |
| Paragraph | oas-paragraph | type、ellipsis |
type 取值：default / secondary / success / warning / danger / disabled。
oas-text
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
actions-position | 操作条位置：start（文字前）/ end（默认，文字后），配合 slot="actions" | string | end |
align | 文本对齐：start/center/end/justify | AlignType | — |
code | 行内代码样式（等宽字体 + 浅底） | boolean | — |
copy-text | 自定义复制内容（缺省复制当前文本） | string | — |
copyable | 显示复制按钮，点击复制文本内容 | boolean | — |
delete | 删除线（<del> 语义） | boolean | — |
depth | 文字弱化档位：1 / 2 / 3（主色渐淡）；仅 type="default" 时生效 | string | — |
ellipsis | 超出容器宽度后单行省略（nowrap + ellipsis） | boolean | — |
ellipsis-suffix | 省略时保留的后缀（如展开链接），与 ellipsis / line-clamp 同用 | string | — |
italic | 斜体（<em> 语义） | — | — |
level | 标题级别（1–5） | string | 3 |
line-clamp | 多行省略行数（正整数），超出折叠省略；与 ellipsis-suffix 可组合 | string | — |
mark | 高亮标记（浅黄底，<mark> 语义） | — | — |
numeric | 数字等宽（font-variant-numeric: tabular-nums），表格/统计数字列对齐 | — | — |
size | 三档字号映射 font-size token（medium 缺省回落继承字号） | string | — |
strong | 加粗（font-weight 600，<strong> 语义） | — | — |
tag | 渲染标签：替换默认元素——行内语义（sub/sup/ins/em/strong 等）与内容块形态（blockquote 引用 / ul·ol 列表 / table 内容表 / dl 描述列表及表格部件）均在白名单内；列表与表格块为解包投影（默认插槽直接挂根） | string | — |
type | 文本类型：default / secondary / success / warning / danger / disabled | TextType | default |
underline | 下划线 | — | — |
weight | 字重：regular/medium/semibold/bold（与 strong 布尔兼容） | WeightType | — |
事件
| 事件 | 说明 |
|---|---|
oas-copy | 复制成功，detail: { text } |
oas-copy-error | 复制失败，detail: { text } |
插槽
| 名称 | 说明 |
|---|---|
| 默认 | 文本内容 |
actions | 操作区插槽（复制/编辑等按钮），位置由 actions-position 决定 |
CSS 变量
| CSS 变量 | 默认值 |
|---|---|
--oas-line-clamp | 2 |
--oas-text-mark-bg | var(--oas-color-warning) |
oas-title
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
actions-position | 操作条位置：start（文字前）/ end（默认，文字后），配合 slot="actions" | string | end |
align | 文本对齐：start（默认）/ center / end / justify（start/end 为逻辑值，RTL 安全）；非法值回落默认 | AlignType | — |
code | 行内代码样式（等宽字体 + 浅底） | boolean | — |
copy-text | 自定义复制内容（缺省复制当前文本） | string | — |
copyable | 显示复制按钮，点击复制文本内容 | boolean | — |
delete | 删除线（<del> 语义） | boolean | — |
depth | 文字弱化档位：1 / 2 / 3（主色渐淡）；仅 type="default" 时生效 | string | — |
ellipsis | 超出容器宽度后单行省略（nowrap + ellipsis） | boolean | — |
ellipsis-suffix | 省略时保留的后缀（如展开链接），与 ellipsis / line-clamp 同用 | string | — |
italic | 斜体（<em> 语义） | — | — |
level | 标题级别（1–5） | string | 3 |
line-clamp | 多行省略行数（正整数），超出折叠省略；与 ellipsis-suffix 可组合 | string | — |
mark | 高亮标记（浅黄底，<mark> 语义） | — | — |
numeric | 数字等宽（font-variant-numeric: tabular-nums），表格/统计数字列对齐 | — | — |
strong | 加粗（font-weight 600，<strong> 语义） | — | — |
tag | 渲染标签：替换默认元素——行内语义（sub/sup/ins/em/strong 等）与内容块形态（blockquote 引用 / ul·ol 列表 / table 内容表 / dl 描述列表及表格部件）均在白名单内；列表与表格块为解包投影（默认插槽直接挂根） | string | — |
type | 文本类型：default / secondary / success / warning / danger / disabled | TextType | default |
underline | 下划线 | — | — |
weight | 字重档：regular(400) / medium(500) / semibold(600) / bold(700)；显式档优先于 strong 布尔；非法值回落 | WeightType | — |
事件
| 事件 | 说明 |
|---|---|
oas-copy | 复制成功，detail: { text } |
oas-copy-error | 复制失败，detail: { text } |
插槽
| 名称 | 说明 |
|---|---|
| 默认 | 标题内容 |
actions | 操作区插槽（复制/编辑等按钮），位置由 actions-position 决定 |
CSS 变量
| CSS 变量 | 默认值 |
|---|---|
--oas-line-clamp | 2 |
--oas-text-mark-bg | var(--oas-color-warning) |
oas-paragraph
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
actions-position | 操作条位置：start（文字前）/ end（默认，文字后），配合 slot="actions" | string | end |
align | 文本对齐：start（默认）/ center / end / justify（start/end 为逻辑值，RTL 安全）；非法值回落默认 | AlignType | — |
code | 行内代码样式（等宽字体 + 浅底） | boolean | — |
copy-text | 自定义复制内容（缺省复制当前文本） | string | — |
copyable | 显示复制按钮，点击复制文本内容 | boolean | — |
delete | 删除线（<del> 语义） | boolean | — |
depth | 文字弱化档位：1 / 2 / 3（主色渐淡）；仅 type="default" 时生效 | string | — |
ellipsis | 超出容器宽度后单行省略（nowrap + ellipsis） | boolean | — |
ellipsis-suffix | 省略时保留的后缀（如展开链接），与 ellipsis / line-clamp 同用 | string | — |
italic | 斜体（<em> 语义） | — | — |
level | 标题级别（1–5） | string | 3 |
line-clamp | 多行省略行数（正整数），超出折叠省略；与 ellipsis-suffix 可组合 | string | — |
mark | 高亮标记（浅黄底，<mark> 语义） | — | — |
numeric | 数字等宽（font-variant-numeric: tabular-nums），表格/统计数字列对齐 | — | — |
strong | 加粗（font-weight 600，<strong> 语义） | — | — |
tag | 渲染标签：替换默认元素——行内语义（sub/sup/ins/em/strong 等）与内容块形态（blockquote 引用 / ul·ol 列表 / table 内容表 / dl 描述列表及表格部件）均在白名单内；列表与表格块为解包投影（默认插槽直接挂根） | string | — |
type | 文本类型：default / secondary / success / warning / danger / disabled | TextType | default |
underline | 下划线 | — | — |
weight | 字重档：regular(400) / medium(500) / semibold(600) / bold(700)；显式档优先于 strong 布尔；非法值回落 | WeightType | — |
事件
| 事件 | 说明 |
|---|---|
oas-copy | 复制成功，detail: { text } |
oas-copy-error | 复制失败，detail: { text } |
插槽
| 名称 | 说明 |
|---|---|
| 默认 | 段落内容 |
actions | 操作区插槽（复制/编辑等按钮），位置由 actions-position 决定 |
CSS 变量
| CSS 变量 | 默认值 |
|---|---|
--oas-line-clamp | 2 |
--oas-text-mark-bg | var(--oas-color-warning) |