# 格式化
大多数的格式化接口,都有格式化参数类型约束(白名单)。具体参见 格式化参数类型。
对于颜色,为了更好地适配暗黑模式,采用了预定义颜色名,而非直接使用 #RGB
的形式。具体参见 颜色对照表。
# 标题 header
- 功能
设置标题层级或取消设置标题。
- 定义
format(key: 'header', value: HeaderValue, source: Source = 'api'): Delta
参数
$value
: 设置为对应层级的标题。false
: 设置为正文。
返回
格式化产生的变更 Delta
数据。
# 引用 blockquote
- 功能
设置或取消段落的样式为引用块。
- 定义
format(key: 'blockquote', value: boolean, source: Source = 'api'): Delta
参数
true
: 设置为引用块。false
: 设置引用块。
返回
格式化产生的变更 Delta
数据。
# 字体 font
- 功能
设置字体或恢复默认字体。
- 定义
format(key: 'font', value: FontValue, source: Source = 'api'): Delta
参数
$value
: 设置为对应名称的字体。false
: 恢复为默认字体。
返回
格式化产生的变更 Delta
数据。
# 字号 size
- 功能
设置字号或恢复默认字号。
- 定义
format(key: 'size', value: SizeValue, source: Source = 'api'): Delta
参数
$value
: 设置为对应的字号。false
: 恢复为默认字号。
返回
格式化产生的变更 Delta
数据。
# 加粗 bold
- 功能
设置或取消文字加粗。
- 定义
format(key: 'bold', vlaue: boolean, source: Source = 'api'): Delta
参数
true
: 设置加粗。false
: 取消加粗。
返回
格式化产生的变更 Delta
数据。
# 倾斜 italic
- 功能
设置或取消文字倾斜。
- 定义
format(key: 'italic', value: boolean, source: Source = 'api'): Delta
参数
true
: 设置倾斜。false
: 取消倾斜。
返回
格式化产生的变更 Delta
数据。
# 删除线 strike
- 功能
设置或取消文字删除线。
- 定义
format(key: 'strike', value: boolean, source: Source = 'api'): Delta
参数
true
: 设置删除线。false
: 取消删除线。
返回
格式化产生的变更 Delta
数据。
# 下划线 underline
- 功能
设置或取消文字下划线。
- 定义
format(key: 'underline', value: boolean, source: Source = 'api'): Delta
参数
true
: 设置下划线。false
: 取消下划线。
返回
格式化产生的变更 Delta
数据。
# 标注 script
- 功能
设置或取消文字的上标、下标。
- 定义
format(key: 'script', value: ScriptValue, source: Source = 'api'): Delta
参数
"sup"
: 设置为上标。"sub"
: 设置为下标。false
: 取消上标或下标。
返回
格式化产生的变更 Delta
数据。
# 行内代码 code
- 功能
设置或取消文字的行内代码样式。
- 定义
format(key: 'code', value: boolean, source: Source = 'api'): Delta
参数
true
: 设置为行内代码。false
: 取消行内代码。
返回
格式化产生的变更 Delta
数据。
# 颜色 color
- 功能
设置或取消文字的颜色。
- 定义
format(key: 'color', value: string, source: Source = 'api'): Delta
参数
$value
: 设置为指定的颜色。false
: 恢复为默认颜色。
返回
格式化产生的变更 Delta
数据。
# 背景色 background
- 功能
设置或取消背景色。
- 定义
format(key: 'background', value: string, source: Source = 'api'): Delta
参数
$value
: 设置为指定的背景色。false
: 恢复为默认背景色。
返回
格式化产生的变更 Delta
数据。
# 列表 list
- 功能
设置或取消列表样式,支持有序列表、无序列表(项目符号)、待(已)办事项。
- 定义
format(key: 'list', value: ListValue, source: Source = 'api'): Delta
参数
"ordered"
: 设置为有序列表。"bullet"
: 设置为无序列表(项目符号)。"unchecked"
: 设置为待办事项。"checked"
: 设置为已办事项。false
: 取消列表样式。
返回
格式化产生的变更 Delta
数据。
# 缩进 indent
- 功能
设置或取消段落的缩进层级。
- 定义
format(key: 'indent', value: IndentValue, source: Source = 'api'): Delta
参数
"+1"
: 增加缩进层级。"-1"
: 减少缩进层级。false
: 取消缩进。
返回
格式化产生的变更 Delta
数据。
# 对齐 align
- 功能
设置或取消段落的对齐方式。
- 定义
format(key: 'align', value: AlignValue, source: Source = 'api'): Delta
参数
"center"
: 设置为居中对齐。"right"
: 设置为右对齐。"justify"
: 取消为两端对齐。false
: 取消对齐,恢复为默认的左对齐。
返回
格式化产生的变更 Delta
数据。
# 行距 line-height
- 功能
设置或取消行距。
- 定义
format(
key: 'line-height',
value: LineHeightValue,
source: Source = 'api'
): Delta
参数
$value
: 设置为指定的行距。false
: 取消行距,恢复默认。
返回
格式化产生的变更 Delta
数据。