Skip to main content
Version: 3.x

UI 核心库

  • 开始日期：2023-04-02
  • 目标主要版本：3.x
  • 参考问题：无
  • 实现 PR：#277

概括​

将 UI 相关的功能模块整合为独立的子库，不依赖主循环、窗口等系统相关接口，能被单独编译、使用。

基本示例​

#include <ui.h>

void on_btn_click(ui_widget_t *w, ui_event_t *e, void *arg)
{
        // ...
}

int main(void)
{
        ui_widget_t *btn;

        ui_init();
        ui_load_css_string(".button {\
                display: inline-block;\
                border: 1px solid #ddd;\
                background: #fff;\
                padding: 4px 8px;\
                font-size: 14px;\
        }");

        btn = ui_create_widget();
        ui_root_append(btn);

        ui_widget_move(btn, 50, 50);
        ui_widget_set_style_string(btn, "border-color", "#f00");
        ui_widget_on(btn, "click", on_btn_click, NULL, NULL);

        ui_update();
        ui_destroy();
}

动机​

增强 UI 相关功能模块的通用性、可替代性和可维护性。

详细设计​

命名​

子库命名为 ui，所有标识符名称以 ui_ 开头。

将 LCUI_RectF 重命名为 ui_rect_t，相关操作函数移入 ui_rect.c 文件内。

根部件​

根级部件由 ui_root() 函数获取，对根追加新部件可靠 ui_root_append() 函数完成。

属性操作​

将属性操作函数名称中的 attribute 单词简写为 attr，即：

  • ui_widget_set_attr()
  • ui_widget_get_attr()

解除对系统事件的依赖​

移除系统事件监听代码，解除 UI 库对平台库的依赖。

新增 ui_dispatch_event() 函数，用于派发 UI 事件。该函数使得上层代码可以自由监听和处理系统事件，无需与平台库强绑定。只需根据系统事件创建对应的 UI 事件，然后将其传入ui_dispatch_event() 函数即可让 UI 库处理事件。

解除对线程库的依赖​

移除事件系统和部件 id 映射表中的互斥锁操作。

缺点​

无。

备选方案​

无。

采用策略​

这是个破坏性改动，需要对所有用到 UI 功能的代码进行修改。由于主要改动都在命名上，这些文件通常只需要全局替换名称即可。

未解决的问题​

是否应该都用更精简的命名？例如：

  • ui_load_css_string -> ui_load_css_str
  • ui_widget_collect_references -> ui_widget_collect_refs

UI 库可以拆分得更彻底：拆分出布局引擎库，解除对 css 库和 pandagl 库的依赖。

直接用全局变量 ui_root 访问根级部件是不是更好些？