跳转到内容

LVGL Number

lvgl 数字平台从 LVGL 组件创建一个数字组件,并需要已配置 LVGL。

支持的组件有 arc、bar、slider 和 spinbox。单个数字仅支持单个组件;换言之,不可能有多个组件与单个 ESPHome 数字组件关联。

  • widget(必需):LVGL 中已配置的受支持组件的 ID,它将反映数字的状态。
  • animated(可选,boolean):是否以动画方式设置组件的值(如果组件支持)。默认为 true。
  • trigger(可选,string):指定哪些事件将导致数字更新为组件的值。可选 on_change、on_update、on_value、on_release。默认为 on_value。
    • on_change:仅在用户与组件交互时更新。
    • on_update:仅在值通过程序更改时更新(例如,通过 lvgl.*.update 操作)。
    • on_value:在用户交互和程序化更改时均更新。
    • on_release:仅在用户交互后释放组件时更新。
  • update_on_release(可选,boolean):已弃用——请改用 trigger: on_release。
  • restore_value(可选,bool):设备重启时从非易失性存储中恢复数字的值。默认为 false。
  • 数字 的所有其他变量。

示例:

number:
- platform: lvgl
widget: slider_id
name: LVGL Slider
trigger: on_release

NOTE

组件特定操作(lvgl.arc.update、lvgl.bar.update、lvgl.slider.update、lvgl.spinbox.update、lvgl.spinbox.decrement、lvgl.spinbox.increment) 如果 trigger 设置为 on_value(默认)或 on_update,将触发相应的组件更新以发送到 Home Assistant。