样式

优质
小牛编辑
122浏览
2023-12-01

每个组件都有自定义样式、已匹配样式、最终样式和已计算样式共四张样式表,其中已计算样式由最终样式计算而来,而最终样式则是已匹配样式与自定义样式合并而来的。

当组件的自定义样式、状态、结构以及样式库有改动的时候会触发样式计算,计算过程是先从样式库中查询与组件匹配的样式表,然后合并为一张样式表作为组件的已匹配样式,之后将已匹配样式与自定义样式合并成一张样式表作为最终样式,最后将最终样式转换为已计算样式,以供布局引擎和渲染引擎使用。

除自定义样式外,其它样式表都是只读的,你不应该修改它们。

已匹配样式

已匹配样式是样式库中所有与组件匹配的样式表的合集,可通过组件的 inherited_style 成员访问它,它的生成过程是先在样式库中找到与组件匹配的选择器,然后再合并该选择器关联的样式表,如果组件有样式哈希值,则已匹配样式还会被缓存起来,以供其它同类组件使用,减少重复的样式匹配过程。

这张样式表仅在样式计算阶段用到,大多数情况下你用不到它。

自定义样式

自定义样式记录了该组件专属的样式,具有比已匹配样式更高的优先级,可通过组件的 custom_style 成员访问它,常见的使用场景是在实现动画、拖拽操作或是自定义布局时动态修改组件的坐标、宽高、透明度等样式。为了节省内存占用,它采用了链表结构来存储样式数据。

自定义样式的操作示例:

Widget_SetStyle(w, key_width, 100, px);
Widget_SetStyleString(w, "width", "100px");
​
if (Widget_CheckStyleValid(w, key_width)) {
    Widget_UnsetStyle(w, key_width);
}

有些常用的样式操作可以改用更精简更具语义的函数代替,示例:

Widget_Move(w, 10, 10);
Widget_Resize(w, 100, 200);
Widget_SetPadding(w, 10, 20, 10, 20);
Widget_SetMargin(w, 5, 5, 5, 5);
Widget_SetBorder(w, 1, SV_SOLID, RGB(200, 200, 200));
Widget_SetBoxShadow(w, 0, 0, 4, ARGB(30, 0, 0, 0));
Widget_Show(w);
Widget_Hide(w);

最终样式

最终样式是已匹配样式与自定义样式合并后的产物,它记录了组件用到的全部 CSS 属性,可通过组件的 style 成员访问它。出于数据的完整性和读写性能的考虑,它采用了内存占用较大的数组来存储样式数据。

最终样式是 LCUI_StyleSheet 类型的,你可以用样式表的辅助方法操作它:

LCUI_Widget w = LCUIWidget_New(NULL);
LCUI_Style style = StyleSheet_GetStyle(w->style, key_width);
​
if (style.is_valid && style.type == LCUI_STYPE_PX) {
    printf("widget width: %fpx\n", style.val_px);
}

已计算样式

已计算样式是最终样式经计算后的产物,它记录了组件用到的全部 CSS 属性的实际值,可通过组件的 computed_style 成员访问它。相比最终样式,在访问它的属性时无需判断属性的有效性和属性值的类型,而且可供布局引擎和渲染引擎直接使用。

常用操作示例:

// 给组件加上淡出动画
void FadeOutAnimation_OnFrame(LCUI_Widget w)
{
    float opacity = w->computed_style.opacity;
    
    if (w->computed_style.visible) {
        if (opacity > 0) {
            opacity -= 0.01;
        }
        if (opacity > 0) {
            Widget_SetOpacity(w, opacity);
        } else {
            Widget_Hide(w);
        }
    }
}
​
...
​
LCUI_SetInterval(5, FadeOutAnimation_OnFrame, w);
​
...

待办事项

重新设计组件样式表的存储方式

由于每个组件都要存储三张样式表,内存占用很大,尤其是组件数量达到上万数量级的时候,我们需要为样式表设计一个内存占用更低的存储方式。

移除组件结构体中的已计算样式

组件结构体中的 computed_style 成员通常只在更新和渲染组件时使用,大小为 328 字节,可以尝试移除它,让它只在更新和渲染组件前临时创建以节省内存占用。

纠正已匹配样式在组件结构体中的命名

已匹配样式在组件结构体中的名称是 inherited_style,但它记录的并不是从父级组件继承的样式,具有误导性,应该纠正为 matched_style