bricks/docs/zh/widget.md

Tooltip

控件功能：用于显示提示信息的浮动文本控件，通常作为鼠标悬停时的工具提示。
类型：普通控件
父类控件：bricks.Text

初始化参数

参数名	类型	说明
otext	String	显示的原始文本内容，支持国际化
rate	Number	字体缩放比例，默认为 0.8
tip	null	固定为 null，防止继承 tooltip 行为

注：Tooltip 在构造时会自动设置 rate=0.8 并添加 modal CSS 类，最小宽度设为 90px。

主要事件

事件名	触发时机	携带参数
无自定义事件	——	——

Tooltip 本身不派发自定义事件，但可通过 show(otext, event) 和 hide() 方法控制显隐。

---

Text

控件功能：基础文本显示控件，支持居中对齐、字体大小响应字符尺寸变化。
类型：普通控件
父类控件：bricks.TextBase

初始化参数

参数名	类型	说明
text	String	要显示的文本内容
otext	String	原始文本，用于国际化支持
i18n	Boolean	是否启用国际化，默认关闭
halign	String	水平对齐方式：left, center, right（默认 center）
valign	String	垂直对齐方式：top, center, bottom（默认 center）
wrap	Boolean	是否允许换行
css	String	自定义 CSS 类名
rate	Number	字体缩放系数，默认为 1

字体大小基于全局 bricks.app.charsize 动态调整，初始 cfontsize = 1。

主要事件

事件名	触发时机	携带参数
无	Text 是静态控件，不触发交互事件	——

---

KeyinText

控件功能：可输入文本控件，通过监听键盘事件动态更新显示内容，适用于简易输入场景。
类型：普通控件
父类控件：bricks.Text

初始化参数

参数名	类型	说明
name	String	数据字段名，默认为 'data'，用于 changed 事件输出键名
其他参数继承自 Text	——	支持所有 Text 的参数

自动绑定全局 keydown 事件，接收字母、数字、回车等单字符输入。

主要事件

事件名	触发时机	携带参数
changed	每当文本发生变化时（包括输入、删除）	对象格式：{ [this.name]: 当前文本 }，例如 { data: "abc" }

---

Title1

控件功能：一级标题控件，字体加粗，字号较大，用于页面主标题展示。
类型：普通控件
父类控件：bricks.TextBase

初始化参数

参数名	类型	说明
text / otext	String	显示文本或国际化原文
i18n	Boolean	是否启用国际化
halign	String	水平对齐方式
valign	String	垂直对齐方式
rate	Number	缩放比例，默认继承

内置样式：fontWeight: bold，cfontsize: 1.96，响应字符尺寸变化。

主要事件

事件名	触发时机	携带参数
无	静态文本控件，无交互事件	——

---

Title2

控件功能：二级标题控件，加粗显示，字号略小于 Title1，用于章节标题。
类型：普通控件
父类控件：bricks.TextBase

初始化参数

同 Title1，支持相同参数。

内置属性：cfontsize: 1.80，其他与 Title1 一致。

主要事件

事件名	触发时机	携带参数
无	静态控件	——

---

Title3

控件功能：三级标题控件，用于子模块或小组块标题。
类型：普通控件
父类控件：bricks.TextBase

初始化参数

同上。

cfontsize: 1.64

主要事件

事件名	触发时机	携带参数
无	——	——

---

Title4

控件功能：四级标题控件，较小的加粗标题，适合细粒度结构划分。
类型：普通控件
父类控件：bricks.TextBase

初始化参数

同上。

cfontsize: 1.48

主要事件

事件名	触发时机	携带参数
无	——	——

---

Title5

控件功能：五级标题控件，轻量级标题样式。
类型：普通控件
父类控件：bricks.TextBase

初始化参数

同上。

cfontsize: 1.32

主要事件

事件名	触发时机	携带参数
无	——	——

---

Title6

控件功能：六级标题控件，最小的一套标题样式，接近正文但加粗。
类型：普通控件
父类控件：bricks.TextBase

初始化参数

同上。

cfontsize: 1.16

主要事件

事件名	触发时机	携带参数
无	——	——