让 UI 和应用数据自动对齐——滑块一动，文字就跟着变
核心方法论：第一性原理，从"为什么"出发
「一个界面永远在回答同一个问题：'当前数据是多少？'。不绑定时，这个问题的答案散落在一堆手动 lv_label_set_text、lv_slider_set_value 里，数据一变就要满世界找漏网之鱼。Observer 的思路很简单：把'数据'本身变成一个可观察的容器，让控件自己订阅它。想通'数据才是源头、界面只是投影'，你就能理解这一整章的每个 API。」
先把问题还原到第一性原理。假设界面上有一个温度计：滑块显示范围，label 显示数值。数据从传感器来，每一次读数变化，你都要"手动搬运"——lv_slider_set_value(slider, temp, LV_ANIM_ON) 更新滑杆，再 lv_label_set_text_fmt(label, "%d °C", temp) 更新文字。一个控件还好，一旦三五个控件都反映同一个数据（滑杆、进度条、数字、颜色、图标），每处变化就要写一堆同步代码，漏改一处就出现"数据变了界面没动"的灵异事件。
/* 手动方式：数据每次变化都要自己同步所有控件 */
int32_t temp = read_sensor();
lv_slider_set_value(slider, temp, LV_ANIM_ON);
lv_label_set_text_fmt(label, "%d °C", temp);
lv_bar_set_value(bar, temp, LV_ANIM_ON);绑定的思路是反转方向：把"数据"变成界面和业务逻辑之间的唯一事实来源（single source of truth）。数据被放进一个可观察的容器（subject），控件声明"我订阅它"；此后只有一件事要做——改数据。数据一变，所有订阅者自动刷新，谁都不漏。README「Features」把 Data bindings 与控件、样式、布局并列为核心特性，原话是"to easily connect the UI with the application"（轻松地把界面与应用连接起来）。实现这套机制的模块，在 9.6.0-dev 里位于 src/core/lv_observer.c（公共头文件是 include/lvgl/core/lv_observer.h），由配置宏 LV_USE_OBSERVER 控制，默认开启。
/* 绑定方式：控件自动跟随 subject 的当前值 */
lv_slider_bind_value(slider, &temp_subject);
lv_label_bind_text(label, &temp_subject, "%d °C");
/* 此后业务只改数据，界面自动同步： */
lv_subject_set_int(&temp_subject, read_sensor());这是个标准的观察者模式：subject 是被观察者，每个控件背后的 observer 是观察者。你不需要记住"谁在看我"，subject 内部用一张订阅者链表（subs_ll）自己管着。理解这一点，后面的 API 全部能推导出来。
lv_subject_t 是整套机制的核心。它的结构（struct _lv_subject_t，在 src/core/lv_observer_private.h）保存着当前值、上一个值（供比较和动画）、min/max 边界，以及一张订阅者链表 subs_ll。每个 subject 有固定类型 LV_SUBJECT_TYPE_*——int、float、pointer、color、group、string 之一，创建后不可改类型。核心字段如下：
struct _lv_subject_t {
lv_ll_t subs_ll; /* 订阅者（observer）链表 */
lv_subject_value_t value; /* 当前值 */
lv_subject_value_t prev_value; /* 上一个值，供比较 / 动画起始值 */
lv_subject_value_t min_value; /* 最小值边界（int / float 型） */
lv_subject_value_t max_value; /* 最大值边界 */
void * user_data; /* 自由使用 */
uint32_t type : 4; /* LV_SUBJECT_TYPE_* 之一 */
/* ... */
};使用分三步：声明 → 初始化 → 读写。声明就是在文件作用域放一个 static lv_subject_t（或嵌入某个结构体）；初始化调用 lv_subject_init_int(&s, 28)；写值 lv_subject_set_int(&s, 31) 会立即通知所有订阅者；读值 lv_subject_get_int(&s)。字符串型特殊一点：lv_subject_init_string() 要求你自备两块缓冲区（当前值与上一个值各一），因为字符串要拷贝保存。
static lv_subject_t temp_subject;
lv_subject_init_int(&temp_subject, 28);
lv_subject_set_int(&temp_subject, 31); /* 值变化，触发所有订阅者回调 */
int32_t v = lv_subject_get_int(&temp_subject);
/* 字符串型需要自备缓冲区 */
char cur[32], prev[32];
lv_subject_init_string(&s_text, cur, prev, sizeof(cur), "Hello");| subject 类型 | 初始化函数 | 读写 API |
|---|---|---|
整数 LV_SUBJECT_TYPE_INT | lv_subject_init_int() | lv_subject_set_int / get_int |
浮点 LV_SUBJECT_TYPE_FLOAT | lv_subject_init_float() | lv_subject_set_float |
指针 LV_SUBJECT_TYPE_POINTER | lv_subject_init_pointer() | lv_subject_set_pointer / get_pointer |
颜色 LV_SUBJECT_TYPE_COLOR | lv_subject_init_color() | lv_subject_set_color / get_color |
字符串 LV_SUBJECT_TYPE_STRING | lv_subject_init_string() | 自备双缓冲区 |
分组 LV_SUBJECT_TYPE_GROUP | lv_subject_init_group() | 一组 subject 的聚合 |
每个"有值"的控件都提供了现成的绑定函数。官方示例 examples/others/observer/lv_example_observer_1.c 就是"滑块值绑定到 label 文本"的教科书写法：一个 temperature_subject 初始化成 28，居中的滑块 lv_slider_bind_value，下方 30 px 的 label 用 lv_label_bind_text 带上格式串 "%d °C"。拖动滑块，新值被写回 subject，label 文本自动重排——这就是本章核心例子，全部代码也就这么几行。
static lv_subject_t temperature_subject;
void lv_example_observer_1(void)
{
lv_subject_init_int(&temperature_subject, 28);
/* 滑块：显示并写入 subject */
lv_obj_t * slider = lv_slider_create(lv_screen_active());
lv_obj_center(slider);
lv_slider_bind_value(slider, &temperature_subject);
/* label：跟随 subject 并以 "%d °C" 格式渲染 */
lv_obj_t * label = lv_label_create(lv_screen_active());
lv_obj_align(label, LV_ALIGN_CENTER, 0, 30);
lv_label_bind_text(label, &temperature_subject, "%d °C");
}绑定系列遵循统一形态 lv_<控件>_bind_<属性>(obj, subject)，返回 lv_observer_t*。数值型控件绑 bind_value：lv_bar_bind_value、lv_arc_bind_value、lv_dropdown_bind_value、lv_roller_bind_value、lv_spinbox_bind_value；文本型绑 bind_text（label，带 printf 格式串）与 lv_spangroup_bind_span_text；图像有 lv_image_bind_src——给 subject 换成不同的图像描述符，同一个控件就能在几张图标之间自动切换。这一串函数分别定义在各控件的头文件里（如 lv_slider.h、lv_label.h）。
lv_bar_bind_value(bar, &sub); /* 进度条跟随 */
lv_arc_bind_value(arc, &sub); /* 弧形表盘 */
lv_dropdown_bind_value(dd, &sub); /* 下拉框选中项 */
lv_image_bind_src(img, &img_subject); /* 多张图标轮换 */针对"属性是否成立"的绑定，通用对象还提供条件族：lv_obj_bind_checked() 把 subject 的 int 值映射到控件的 LV_STATE_CHECKED；lv_obj_bind_flag_if_eq() 系列（还有 not_eq/gt/ge/lt/le）在值满足条件时给对象挂标志（如 LV_OBJ_FLAG_HIDDEN）；lv_obj_bind_state_if_gt() 系列则在越界时给对象换状态——官方示例 lv_example_slider_bind_state.c 就用 LV_STATE_DISABLED 让值超过 80 时按钮被禁用。这类绑定让"数据驱动界面外观"几乎不用写任何回调。
/* 条件族绑定：值等于 0 时隐藏按钮，超过 80 时进度条禁用 */
lv_obj_bind_checked(chk, &sub);
lv_obj_bind_flag_if_eq(btn, &sub, LV_OBJ_FLAG_HIDDEN, 0);
lv_obj_bind_state_if_gt(bar, &sub, LV_STATE_DISABLED, 80);| 绑定函数 | 作用 |
|---|---|
lv_slider_bind_value / lv_bar_bind_value | 数值控件跟随 subject（双向） |
lv_label_bind_text | label 文本，支持 "%d" 格式串 |
lv_image_bind_src | 图像源跟随 subject |
lv_dropdown_bind_value / lv_roller_bind_value | 选中项跟随 subject |
lv_obj_bind_checked | int 值 → LV_STATE_CHECKED |
lv_obj_bind_flag_if_* | 条件成立 → 对象标志 |
lv_obj_bind_state_if_* | 条件成立 → 对象状态 |
内置绑定覆盖不了时，就自己注册观察者回调。lv_subject_add_observer(&sub, cb, user_data) 把回调挂到 subject 上，签名是 typedef void (*lv_observer_cb_t)(lv_observer_t * observer, lv_subject_t * subject)。数据一变，回调被调用，你可以在里面做任何事——发消息给别的模块、驱动状态机、甚至再改另一个 subject（注意避免循环）。官方示例 lv_example_observer_4.c 就是用几个手动回调切换页签、控制按钮检查态。
static void on_temp_change(lv_observer_t * observer,
lv_subject_t * subject)
{
/* subject 是触发来源，从中读当前值 */
if(lv_subject_get_int(subject) > 100) {
lv_obj_remove_flag(alarm, LV_OBJ_FLAG_HIDDEN); /* 亮起报警 */
}
}
/* 订阅：回调注册到 subject 上 */
lv_subject_add_observer(&temp_subject, on_temp_change, NULL);observer 本身是个描述"订阅关系"的对象（struct _lv_observer_t）：记着它订阅的 subject、回调 cb、目标 target（可以是任意指针，若是控件则用 lv_subject_add_observer_obj 登记，方便自动清理）与 user_data。配套生命周期 API：lv_observer_remove(obs) 取消订阅、lv_obj_remove_from_subject(obj, subject) 移除某个控件与 subject 的全部关联、lv_subject_notify(subject) 手动触发一次"当前值即变化"的通知。还有一个便捷函数 lv_obj_add_subject_increment_event()：给一个控件挂上"事件发生时把 subject 加减 step"的行为，比如按钮每点一次加 5。
/* 按钮每点击一次，subject 加 5（可在 0..100 之间回绕/夹取） */
lv_obj_add_subject_increment_event(btn_plus, &temp_subject,
LV_EVENT_CLICKED, 5);
/* 取消订阅与手动通知 */
lv_observer_remove(obs);
lv_subject_notify(&temp_subject);在 observer 回调里再次 lv_subject_set_* 同一个 subject 会触发重入。LVGL 在 subject 里留了一个 notify_restart_query 位来处理"通知过程中订阅者被删除"的情形，但最佳实践仍是：回调里只读值、触发外部动作，不要在回调里改同一个 subject 形成无限循环。多模块联动时，宁可用一个中介状态，也不要 A↔B 互相订阅。
在 LVGL Pro 的 XML 工作流里，全局数据声明集中在 examples/xml_project/globals.xml 的 <subjects> 块。每个标签就是用 XML 声明一个 subject：<int> 标签对应 int 型，属性 name（变量名）、value（初值）、min_value/max_value（边界）。官方文件里有一段专门给数据绑定示例复用的全局 subject，注释还强调"用户不必为每个示例发明新名字"。
<!-- globals.xml 的 <subjects> 块（真实源码，节选） -->
<subjects>
<int name="subject_value" value="50" min_value="0" max_value="100"/>
<int name="subject_value2" value="20" min_value="0" max_value="100"/>
<int name="subject_opa" value="128" min_value="0" max_value="255"/>
<int name="subject_index" value="0"/>
<int name="subject_flag" value="0"/>
<string name="subject_text" value="Hello"/>
</subjects>lved generate（第 12 章详讲）会把这段 XML 映射成 C 代码：为每个 <subject> 生成一个 lv_subject_t 变量，并用 value 属性调用对应的 lv_subject_init_*() 完成初始化；界面上任何引用该 subject 的控件属性，则被生成成 lv_slider_bind_value()、lv_label_bind_text() 等绑定调用。同理，<images> 块里的 <data>（如 name="img_example_lvgl_logo" src_path="images/img_example_lvgl_logo.png" color_format="argb8888"）映射到图像描述符，<fonts> 块里的 <bin>（TTF 转二进制字体）映射到字体资源——名字与第 10 章的转换产物一一对应。
/* globals.xml <int name="subject_value" value="50"
min_value="0" max_value="100"/> 的 C 端等价 */
lv_subject_t subject_value;
lv_subject_init_int(&subject_value, 50);
/* 界面上引用它的滑块/文本，生成： */
lv_slider_bind_value(slider, &subject_value);
lv_label_bind_text(label, &subject_value, "%d");XML 里的 value="50" 和 C 里的 lv_subject_init_int(&s, 50) 是同一件事的两种写法，一个给设计师、一个给嵌入式工程师。理解了 subject 的"声明 + 初值 + 边界"三要素，你在 XML 和 C 之间来回切换就不会迷路——它们只是同一种数据模型的两副面孔。
仿照 lv_example_observer_1.c，让一个 temperature_subject（int，初值 28）同时驱动：一个滑块、一个 lv_bar 进度条、一个显示 "%d °C" 的 label。拖动滑块后，验证三者是否同步变化。说出：三个控件分别用了哪个绑定函数？
滑块用 lv_slider_bind_value，进度条用 lv_bar_bind_value，文本用 lv_label_bind_text——三者订阅同一个 subject。
lv_slider_bind_value(slider, &temperature_subject)、lv_bar_bind_value(bar, &temperature_subject)、lv_label_bind_text(label, &temperature_subject, "%d °C")。拖动滑块会先把值写回 subject，再广播给包括它自己在内的所有订阅者，因此三者总是同步。要点：业务逻辑里只需要 lv_subject_set_int(&temperature_subject, v) 一处改数据。
用 lv_subject_add_observer() 注册一个手动回调：当 subject 值超过 80 时，把一个 label 的文本设为 "超限!" 并切到自定义状态 LV_STATE_USER_1（配合一条自定义样式显示警示色），否则恢复 "正常" 并移除该状态。写全代码，并解释：相比在事件回调里逐处判断，手动 observer 为什么更不容易漏改？
回调签名是 void cb(lv_observer_t * observer, lv_subject_t * subject)；用 lv_subject_get_int(subject) 读值；改状态用 lv_obj_add_state/lv_obj_remove_state 或 lv_obj_set_style_text_color。
核心代码：static void warn_cb(lv_observer_t * o, lv_subject_t * s){ if(lv_subject_get_int(s) > 80){ lv_label_set_text(label, "超限!"); lv_obj_add_state(label, LV_STATE_USER_1); } else { lv_label_set_text(label, "正常"); lv_obj_remove_state(label, LV_STATE_USER_1); } }，再 lv_subject_add_observer(&temp_subject, warn_cb, NULL)。注意 LVGL 9 没有内置"警示"状态，自定义状态用 LV_STATE_USER_1（还有 USER_2..4），再配一条 LV_STATE_USER_1 下的样式（如红色文字）让它显示成报警色。安全性：无论数据从哪条路径改（传感器、滑块、按钮加/减），所有入口最终都汇聚到 lv_subject_set_*，回调只会被触发一次、逻辑只写一处；而手动在 N 个入口各写一遍判断，任何一处漏写就是 bug。这就是"数据是唯一事实来源"的价值。
参考 examples/xml_project/globals.xml，在 <subjects> 里新增一个音量 subject：<int name="subject_volume" value="30" min_value="0" max_value="100"/>。写出该标签在 C 端对应的初始化代码，以及界面上一组"音量滑块 + 音量百分比文本"的绑定调用。说明 min_value/max_value 在 C 端体现在哪里。
lv_subject_init_int(&subject_volume, 30) 初值来自 value；min_value/max_value 会写入 subject 的 min/max 字段，供 lv_slider_bind_value 之类的绑定在内部夹取使用。
XML：<int name="subject_volume" value="30" min_value="0" max_value="100"/>。C 端：lv_subject_t subject_volume; lv_subject_init_int(&subject_volume, 30);——初值即 value="30"，min_value/max_value 写入 subject 的 min_value/max_value 字段，绑定后的滑块在范围内拖动、增/减事件在边界处夹取或回绕。绑定：lv_slider_bind_value(slider, &subject_volume)、lv_label_bind_text(label, &subject_volume, "%d%%")。要点：XML 与 C 是同一种数据模型，lved generate 负责机械地翻译。
lv_slider_bind_value() 表面上一行代码，内部却实现了"双向"同步：拖动滑块会更新 subject，代码里改 subject 滑块也会动。请打开 src/widgets/slider/lv_slider.c 找到该函数的实现，用第一性原理说明：它靠哪两个机制分别实现"控件→数据"与"数据→控件"？为什么这里不必担心无限循环？
源码里它做了两件事：lv_obj_add_event_cb(obj, ..., LV_EVENT_VALUE_CHANGED, subject) 与 lv_subject_add_observer_obj(subject, ..., obj, NULL)。前者负责滑块被拖动时写回 subject，后者负责 subject 变化时更新滑块。
① 控件→数据：lv_obj_add_event_cb(obj, slider_value_changed_event_cb, LV_EVENT_VALUE_CHANGED, subject)——用户拖动滑块触发 LV_EVENT_VALUE_CHANGED，事件回调把滑块当前值 lv_subject_set_int(subject, value) 写回；② 数据→控件：lv_subject_add_observer_obj(subject, slider_value_observer_cb, obj, NULL)——subject 变化时观察者回调把新值 lv_slider_set_value 写回滑块。为什么不会无限循环：observer 回调写滑块、事件回调写 subject 确实构成"循环"，但 LVGL 的 observer 只在"值真正变化"时才通知（内部比较 value 与 prev_value），且写回同一数值不会再次产生变化事件，循环自然收敛。这也是 prev_value 字段存在的意义——去重是防抖的基础。