#术语表

这一页用于统一 Flor 文档里的称呼。遇到中英文或 API 命名不完全一致的地方，以这里为准。

#Flor

Flor 是一个控件式 GUI 框架。

中文文档中可以直接使用 Flor 这个名字。它的中文译名是“花”。

当描述 Flor 的类型时，称作“框架”。它不是只提供零散工具函数的库，而是一套包含控件系统、信号系统、事件循环、窗口管理、渲染入口等内容的完整的 GUI 框架本身。

#控件 / View

中文文档中，一律称作“控件”。

英文语境和 Rust API 中，统一写作 View。这里的 View 命名参考了 Floem 的命名习惯；名字写进 API 后就保留下来了。因此：

• 中文说明里写“控件”
• 类型、trait、方法名里保留 View
• 不额外混用“组件”作为主称呼

例如：

use flor::view::View;

fn mount(view: impl View) {
    // view 在中文文档中通常称为“控件”。
}

#信号 / Signal

中文文档中称作“信号”，英文和 API 中写作 Signal。

信号是 Flor 的响应式状态容器。值变化后，依赖它的 effect、updater 或控件绑定会被重新调度。

#读取器 / 写入器 / 读写器

这三个称呼是对一类信号结构体的统称，依据是它们实现了哪些读写 trait。语义核心在 trait，而不是结构体名字本身。

• 实现 Read<T> 的信号结构体，可以称作读取器
• 实现 Write<T> 的信号结构体，可以称作写入器
• 同时实现 Read<T> 和 Write<T> 的信号结构体，可以称作读写器或读写信号

常见类型包括：

• ReadSignal<T>：读取器
• WriteSignal<T>：写入器
• RwSignal<T>：读写器或读写信号

读写拆分主要用于表达业务访问边界：只读的地方传读取器，只写的地方传写入器，需要两者时传读写器。

#Builder

API 中保留 Builder，中文文档中通常称作“链式构建 API”或“构建器”。

例如 ClassBuilder、StyleBuilder、LayoutBuilder 都属于给控件追加样式、布局或行为的链式 API。

#原子类

Flor 文档里的“原子类”专指 .class(...) builder 带来的能力，也就是通过空格分隔的 class 字符串快速配置控件。

原子类不是一个独立控件类型，也不是泛指所有样式系统。它是 ClassBuilder 提供的可选功能：启用 class feature 后，控件可以用 .class("...") 写 layout class 和控件样式 class。

#Resolver

API 中保留 Resolver，中文文档中通常称作“解析器”。

Resolver 负责把 class、样式、状态等描述转换成控件实际使用的样式或布局数据。