企业官网建设流程全解析

LVGL列表项添加与交互——从一次诡异的触摸失效说起

上周调试一块基于ESP32-S3的智能家居面板，LVGL版本8.3.5，列表控件（lv_list）里塞了十几个设备条目。功能跑起来一切正常，直到测试同事反馈：列表滚动到中间位置时，点击某些条目毫无反应，但上下滑动又流畅得很。我第一反应是触摸校准问题，但校准数据读出来完全正常。折腾了两天，最后发现是列表项创建时的一个参数顺序搞反了——lv_list_add_btn的第二个参数传了个空指针，导致事件绑定失效。这种低级错误在文档里根本不会强调，但实际项目中踩一次就长记性。

列表项创建：别被“便捷API”骗了

LVGL的列表控件本质是一个垂直布局的容器，内部由lv_btn和lv_label组合而成。官方提供了lv_list_add_btn(list, icon, text)这个“一键添加”函数，看起来省事，但坑就藏在参数里。

lv_obj_t*btn=lv_list_add_btn(my_list