Skip to content

Typography 排版

文本、标题、段落排版组件。

Text 文本

文本类型

默认文本次要文本成功文本警告文本危险文本禁用文本

修饰样式

加粗标记代码下划线删除线斜体

自定义标记色(mark + CSS 变量)

默认标记色
自定义标记色(--oas-text-mark-bg)

字重档(weight)

regular 常规medium 中等semibold 半粗bold 粗体
strong(等价 semibold 字重)

数字等宽(numeric)

默认数字:1 2 3 4 5 6 7 8 9 0tabular-nums:1 2 3 4 5 6 7 8 9 0
默认:12,345.67等宽:12,345.67等宽:1,234.56

文本对齐(align)

start:左对齐(默认起点)center:居中对齐(标题居中高频场景)end:右对齐justify:两端对齐,适用于段落排版,通过拉伸词间距让左右边缘对齐。

文字深度(depth)

一档弱化(说明文字)二档弱化(次要说明)三档弱化(最次要)

换标签(tag)

下标上标插入标记粗体标签

省略

文本省略

这是一段很长的文本,超出宽度后将以省略号截断显示,不再换行。

多行省略(line-clamp)

这是一段更长的文本,line-clamp 属性限制最多显示两行,超出后以省略号截断。多行省略不需要测量,纯 CSS 实现,适合卡片摘要、列表简介等轻截断场景。

省略保留后缀(ellipsis-suffix)

To be, or not to be, that is the question: Whether 'tis nobler in the mind to suffer the slings and arrows of outrageous fortune

可复制

可复制文本

可复制的文本内容

自定义复制内容(copy-text)

安装命令:点复制按钮复制 `npm i @oas-ui/ui`

操作条(actions)

操作条位置

复制按钮在文本后(默认)
复制按钮在文本前
自定义操作内容

Title 标题

标题级别

标题一标题二标题三

Paragraph 段落

段落

段落文本一段落文本二

API

组件标签属性
Textoas-texttypeellipsiscopyable
Titleoas-titlelevel(1-5)、typeellipsis
Paragraphoas-paragraphtypeellipsis

type 取值:default / secondary / success / warning / danger / disabled

oas-text

属性说明类型默认值
actions-position操作条位置:start(文字前)/ end(默认,文字后),配合 slot="actions"stringend
align文本对齐:start/center/end/justifyAlignType
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)string3
line-clamp多行省略行数(正整数),超出折叠省略;与 ellipsis-suffix 可组合string
mark高亮标记(浅黄底,<mark> 语义)
numeric数字等宽(font-variant-numeric: tabular-nums),表格/统计数字列对齐
strong加粗(font-weight 600,<strong> 语义)
tag渲染标签:替换默认元素(如 sub / sup / ins / em / strong 等)string
type文本类型:default / secondary / success / warning / danger / disabledTextTypedefault
underline下划线
weight字重:regular/medium/semibold/bold(与 strong 布尔兼容)WeightType
事件说明
oas-copy复制成功,detail: { text }
oas-copy-error复制失败,detail: { text }
名称说明
默认
actions操作区插槽(复制/编辑等按钮),位置由 actions-position 决定

oas-title

属性说明类型默认值
actions-position操作条位置:start(文字前)/ end(默认,文字后),配合 slot="actions"stringend
alignAlignType
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)string3
line-clamp多行省略行数(正整数),超出折叠省略;与 ellipsis-suffix 可组合string
mark高亮标记(浅黄底,<mark> 语义)
numeric
strong加粗(font-weight 600,<strong> 语义)
tag渲染标签:替换默认元素(如 sub / sup / ins / em / strong 等)string
type文本类型:default / secondary / success / warning / danger / disabledTextTypedefault
underline下划线
weightWeightType
事件说明
oas-copy复制成功,detail: { text }
oas-copy-error复制失败,detail: { text }
名称说明
默认
actions操作区插槽(复制/编辑等按钮),位置由 actions-position 决定

oas-paragraph

属性说明类型默认值
actions-position操作条位置:start(文字前)/ end(默认,文字后),配合 slot="actions"stringend
alignAlignType
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)string3
line-clamp多行省略行数(正整数),超出折叠省略;与 ellipsis-suffix 可组合string
mark高亮标记(浅黄底,<mark> 语义)
numeric
strong加粗(font-weight 600,<strong> 语义)
tag渲染标签:替换默认元素(如 sub / sup / ins / em / strong 等)string
type文本类型:default / secondary / success / warning / danger / disabledTextTypedefault
underline下划线
weightWeightType
事件说明
oas-copy复制成功,detail: { text }
oas-copy-error复制失败,detail: { text }
名称说明
默认
actions操作区插槽(复制/编辑等按钮),位置由 actions-position 决定

同 oas-text 属性(修饰布尔/depth/tag/line-clamp/copy-text/ellipsis-suffix/actions-position 同样生效),level 1–5 驱动标签。

同 oas-text 属性。

基于 MIT OR Apache-2.0 双许可发布