CSS 解析器和选择引擎库
- 开始日期:2023-05-01
- 目标主要版本:3.x
- 参考问题:无
- 实现 PR:无
概括
将 CSS 相关的功能模块整合为独立的子库,重新设计部分接口,移除对 UI 库、线程库、字体库的依赖。
基本示例
#include <stdio.h>
#include <css.h>
char css_str[] = "\
* {\
box-sizing: border-box;\
}\
.btn {\
font-size: 14px;\
}\
";
int main(void)
{
css_prop_t *prop;
css_selector_t *selector;
css_style_decl_t *style;
css_init();
css_load_from_string(css_str);
selector = css_selector_create(".btn");
style = css_select_style(selector);
prop = css_style_decl_find(style, css_key_font_size);
if (prop != NULL) {
printf("font-size: %fpx\n", prop->value.unit_value.value);
}
css_selector_destroy(selector);
css_style_decl_destroy(style);
css_destroy();
return 0;
}
动机
- 减少依赖项: 样式数据库操作依赖线程库的互斥锁、font-family 属性解析器依赖字体库、@font-face 规则解析器依赖 UI 库的 TextView 部件。
- 纠正 CSS 相关数据类型的命名: 部分 CSS 相关数据类型命名并不正确,例如:样式表(StyleeSheet)是包含了 CSS 规则集的对象,然而
LCUI_StyleSheet
里面却是 CSS 属性列表,正确的命名是StyleDeclaration
。
详细设计
调整命名
为提升辨识度,所有标识符命名以 css_
开头。
参考 LibCSS 库和 MDN 中的 CSS 对象模型相关的文章,确定 CSS 库中的对象类型名和释义:
对象 | CSSOM 中的名称 | CSS 库中的名称 | 含义 |
样式表 | CSSStyleSheet | css_stylesheet_t | 各种规则的集合 |
样式声明 | CSSStyleDeclaration | css_style_decl_t | CSS 属性键值对的集合 |
规则 | CSSRule | css_rule_t | (字面意思) |
样式规则 | CSSStyleRule | css_style_rule_t | 定义了一组属性和值,以及应用这些属性和值的元素。 |
主要标识符命名改动如下:
LCUI_StyleSheet
->css_style_decl_t
,StyleSheet 保存了所有 CSS 属性,数组下标既是属性编号。为节省内存占用,改用css_style_decl_t
。LCUI_StyleList
->css_style_decl_t
,StyleList 是一个链表,仅存储了使用的 CSS 属性。LCUI_Style
->css_style_value_t
LCUI_Selector
->css_selector_t
LCUI_SelectorNode
->css_selector_node_t
LCUI_LoadCSSFile()
->css_load_from_file()
LCUI_LoadCSSString()
->css_load_from_string()
CSSParser_Begin()
->css_parser_create()
CSSParser_End()
->css_parser_destroy()
LCUI_GetStyleSheet()
->css_select_style()
其它改动是相似的,不再赘述。