跳到主要内容

Odoo 16.0 Web 模块导出类与函数全量扫描报告 (按详细目录归类)

备注

本文由AI生成+人工校正。

扫描范围: odoo-16.0/addons/web/static/src

日期: 2026-01-20

本报告对 src 目录下每一个子文件夹进行了深层次扫描，并按物理路径罗列了所有导出的类、函数和核心常量。

1. 根目录 (src/)​

  • env.js: makeEnv(), startServices(env), SERVICES_METADATA
  • session.js: session (会话信息常量)
  • start.js: startWebClient(Webclient)
  • boot.js: (底层模块系统，无 ES6 导出)
  • main.js: (入口脚本，无导出)

2. 核心架构 (src/core/)​

2.1 浏览器与系统服务​

  • browser/: 提供对浏览器原生 API（如 localStorage, sessionStorage, location）的包装，便于单元测试和跨浏览器兼容。
  • feature_detection.js: 运行环境特性检测，如是否为移动端、触摸屏（hasTouch）、特定浏览器或操作系统。
  • router_service.js: 管理 URL 哈希路由，负责解析当前 URL 状态、生成新 URL 以及监听路由变化。
  • cookie_service.js: 提供标准化的接口用于读写和管理浏览器的 Cookie。
  • title_service.js: 动态管理网页标签页标题的显示。
  • network/: 核心网络层，包含 rpcService (处理 Odoo 传统的 JSON-RPC) 和 httpService (标准 HTTP 请求)。
  • download.js: 处理文件下载逻辑，支持 Blob 下载和传统的 XHR 附件下载。
  • orm_service.js: 客户端 ORM 接口，封装了与后端模型交互的高级方法（如 searchRead, create, unlink 等）。
  • registry.js: Odoo 的核心扩展点机制，通过命名空间管理全局注册的组件、服务、动作和视图模板。
  • user_service.js: 提供当前登录用户的上下文信息，包括用户 ID、权限组、语言偏好设置及时区。
  • l10n/: 本地化与国际化服务，负责加载翻译词库（translation.js）及处理多语言日期/数字格式化（dates.js）。
  • main_components_container.js: 全局主组件容器，负责在页面顶层挂载对话框、通知和加载指示器等公共 UI 元素。

2.2 通用 UI 组件与 Hook​

  • autocomplete/: 自动完成输入组件，支持远程搜索和下拉建议。
  • checkbox/: 标准化复选框组件，解决了跨浏览器的样式统一和三态显示问题。
  • colorlist/: 预设颜色调色板组件，常用于标签或分类的颜色选择。
  • commands/: 全局命令面板服务，支持通过快捷键（如 Ctrl+K）唤起命令搜索并执行特定动作。
  • confirmation_dialog/: 基础确认与警告对话框，封装了常用的“确定/取消”逻辑。
  • datepicker/: 核心日期/时间选择插件，支持多种格式解析和 Luxon 库集成。
  • dialog/: 底层对话框框架，支持模态窗口、多级嵌套弹窗及其生命周期管理。
  • dropdown/: 高度可定制的下拉菜单组件，支持键盘导航和自动定位。
  • effects/: 提供 UI 交互特效，如操作成功时屏幕飞出的“彩虹人”（RainbowMan）动画。
  • file_input/: 隐藏的原生文件上传输入框的 UI 包装。
  • file_upload/: 完整的文件上传流程管理器，包含进度监控、错误处理和多文件支持。
  • hotkeys/: 全局快捷键注册与分发系统，支持热键冲突检测和作用域限制。
  • notebook/: 选项卡（Tabs）布局容器，用于组织复杂的表单或详情页面。
  • notifications/: 页面右上角的非侵入式悬浮通知系统。
  • pager/: 经典的“上一页/下一页”分页导航，显示记录总数和当前范围。
  • popover/: 基于 Popper.js 的气泡弹出层，用于显示详细上下文或辅助信息。
  • signature/: 电子签名板，支持手写签名采集及基 64 位编码输出。
  • tooltip/: 声明式工具提示钩子，自动处理鼠标悬停的显示与隐藏。
  • ui/: 核心 UI 状态控制，包括全屏阻塞（BlockUI）、焦点捕获（FocusTrap）和活动元素跟踪。

2.3 调试与底层解析​

  • debug/: 开发者模式专用工具，包含调试菜单、性能监控看板（Profiling）和视图架构实时检视。
  • py_js/: 纯 JS 实现的 Python 表达式引擎，用于在前端安全地评估 Domain、Context 和动态可见性规则。
  • domain.js: Odoo 域语法（Domain）的底层模型，支持逻辑运算（AND/OR/NOT）的解析与合并。
  • domain_selector/: 可视化 Domain 编辑器，允许用户通过 UI 树形结构构建复杂的过滤条件。
  • model_field_selector/: 字段链选择器，支持通过点号（.）跨模型选择关联字段。
  • model_selector/: 模型（res.model）搜索与选择组件。
  • macro.js: 宏录制与执行引擎，常用于自动化测试或演示流程重放。

2.4 工具类 (core/utils/)​

  • arrays.js: 增强型数组操作，如 groupBy (按键分组)、sortBy (多级排序) 和 unique (去重)。
  • concurrency.js: 并发控制原语，提供 Mutex (互斥锁) 和 KeepLast (丢弃过时请求) 以优化网络性能。
  • xml.js: 强健的 XML 解析与生成工具，负责处理 Odoo 的 Arch 架构文档。
  • strings.js: 字符串处理库，包含 sprintf、中文拼音模糊搜索支持、不区分音符的 unaccent 等。
  • timing.js: 提供 debounce (防抖) 和 throttle (节流) 函数，优化高频事件处理。
  • objects.js: 对象深度克隆、属性过滤（omit/pick）和浅层比较工具。
  • patch.js: Odoo 独特的“猴子补丁”系统，允许在运行时动态修改任何类或对象的行为。
  • render.js: Owl 模板的高级渲染封装。
  • urls.js: 处理 URL 参数的编码转换、源（Origin）获取及路由重构。
  • ui.js: 辅助定位 DOM 元素、检测可见性以及管理 Tab 键切换序列。
  • draggable.js / sortable.js: 拖拽排队和元素移动的底层逻辑封装。
  • hooks.js: 各种常用 Owl Hook（如 useBus, useClickOutside）的集合。
  • search.js: 提供 fuzzyLookup (模糊匹配) 算法。
  • numbers.js: 负责数字的格式化（千分位、货币符号）及高精度数值计算。

3. 视图系统 (src/views/)​

3.1 视图核心​

  • view.js: 视图层的根组件 (View)，负责协调 Controller、Model 和 Renderer，是所有具体视图（如 Form、List）的通用外壳。
  • model.js: 视图数据模型的基类 (Model)，采用基于事件的通信机制，负责管理视图的内部状态、数据加载及与服务器的同步。
  • relational_model.js: 专为 Odoo 关系型数据（x2many, many2one）设计的模型实现，支持多层级数据处理、记录变更跟踪和并发保存请求管理。
  • view_compiler.js: 视图架构（Arch）编译器，将后端的 XML 描述解析并转换为前端可执行的 Owl 模板代码，处理各种指令（t-if, t-foreach）及 Odoo 特有属性。
  • view_service.js: 全局视图服务，负责从服务器加载视图定义（loadViews），并缓存处理后的视图描述以提高性能。
  • view_hook.js: 提供 useView 等 Hook，简化了在非标准视图环境（如自定义动作）中初始化和使用 Odoo 视图逻辑的过程。

3.2 字段组件 (views/fields/)​

该目录定义了所有表单和列表中使用的数据输入与显示组件。

  • 各类字段子文件夹:
    • boolean/, char/, integer/, float/, monetary/: 基础数据类型字段。
    • date/, datetime/: 集成了日期选择器的日期时间字段。
    • many2one/, many2many_tags/, x2many/: 处理模型间关系的复杂字段，包含面包屑跳转、快速搜索及弹窗选择逻辑。
    • image/, binary/: 附件上传、预览及图片缩略图处理。
    • pdf_viewer/, html/, ace/: 高级内容展示与编辑器（如 PDF 预览、富文本及代码编辑器）。
  • 通用导出:
    • field.js: 字段组件的基类定义。
    • standard_field_props.js: 定义了字段组件接收的标准 Props 结构（如 record, name, readonly）。
    • formatters.js: 将后端原始值转换为用户友好字符串的格式化器集合。
    • parsers.js: 将用户输入字符串解析为后端可接受数值的反向处理器。

3.3 各类视图实现​

遵循 Controller (逻辑控制)、Renderer (界面渲染)、Model (数据管理) 和 ArchParser (架构解析) 的解耦模式。

  • form/: 经典的表单视图，支持记录创建、编辑、状态机控制及按钮动作执行。
  • list/: 列表/树形视图，支持批量操作、实时行编辑、聚合统计及多重分组显示。
  • kanban/: 看板视图，支持拖拽排序、阶段流转、卡片自定义布局及快速状态标记。
  • calendar/: 日历视图，支持日程管理、拖拽调整时间及多维度过滤显示。
  • pivot/: 透视表视图，提供强大的数据立方体分析、行列动态透视及 Excel 式的汇总体验。
  • graph/: 图表视图，支持条形图、饼图、折线图等多种统计图表的交互式展示。

3.4 视图辅助与组件​

  • view_dialogs/: 视图专用对话框，如 SelectCreateDialog (用于在关系字段中选择记录) 和 ExportDataDialog (数据导出向导)。
  • widgets/: 非字段类型的通用视图小部件，如 SignatureWidget (签名采集)、WeekDays (工作日选择) 及 AttachDocumentWidget (文档关联)。
  • view_button/: 统一处理视图中的按钮点击逻辑，包括按钮权限检查、加载状态显示及确认弹窗触发。
  • sample_server.js: 客户端 Mock 服务器，当模型中没有数据时，负责生成符合 Arch 结构的“样例数据”（Sample Data）用于界面演示。

4. 搜索与过滤 (src/search/)​

  • control_panel/: 页面顶部的控制面板组件，负责整合面包屑导航（Breadcrumbs）、动作按钮、视图切换器以及搜索功能区域。
  • search_bar/: 搜索栏核心组件，支持展示和交互搜索分面（Facets）、自动完成建议以及复杂的过滤项标签。
  • search_model.js: 搜索系统的状态管理中心，负责维护当前的过滤条件、分组设置、搜索域（Domain）以及上下文（Context），并协调各菜单间的状态同步。
  • filter_menu/, group_by_menu/, favorite_menu/: 预设与自定义的下拉菜单，允许用户快速应用业务过滤规则、数据分组策略或保存常用的搜索组合。
  • action_menus/: 视图上方常见的“打印”和“动作”下拉按钮组，支持根据选中记录动态显示可执行的操作。
  • search_panel/: 位于视图左侧的分类过滤面板，常用于根据分类模型或预设维度进行快速筛选。
  • layout.js: 视图系统的通用布局组件，封装了控制面板与视图内容的垂直堆叠逻辑。
  • utils/: 搜索辅助工具，如 dates.js 负责处理搜索框中的相对日期（如“本月”、“去年”）计算，group_by.js 处理分组描述符。

5. Web 客户端 (src/webclient/)​

  • webclient.js: 整个 Odoo 单页应用（SPA）的根组件，负责管理全局布局、通知挂载点及顶层错误捕获。
  • navbar/: 顶部全局导航栏，包含应用切换器（App Switcher）、侧边栏触发器以及系统托盘区域。
  • user_menu/: 用户中心菜单，提供个人资料编辑、文档链接、支持窗口及注销操作入口。
  • burger_menu/: 专为移动端设计的“汉堡”菜单，在小屏幕设备上整合应用导航和用户信息。
  • actions/: 动作调度系统（Action Service），是 Odoo 的核心导航引擎，负责解析并执行所有的 ir.actions，如打开视图、触发报表或执行客户端代码。
  • menus/: 菜单数据服务，负责请求、解析并缓存后端的菜单树结构，并处理多级菜单的显示逻辑。
  • loading_indicator/: 全局加载指示器，监听 RPC 请求状态，在长耗时操作中为用户提供进度反馈。
  • switch_company_menu/: 多公司切换组件，允许用户在多个已授权的公司间切换环境，并支持勾选多个公司以查看聚合数据。
  • company_service.js: 公司上下文服务，维护当前激活的公司信息及其关联的配置。
  • settings_form_view/: 专门用于系统设置界面的视图实现，支持带搜索高亮的设置项、APP 分类导航及即时保存机制。

6. 兼容性与公共模块​

  • legacy/: 遗留代码兼容层，提供了一套复杂的适配器（Adapter）和环境转换工具，允许 Odoo 16.0 仍然能够运行基于旧版 Widget 架构开发的模块和视图。
  • owl2_compatibility/: OWL 2 底层补丁，针对 Odoo 特定的业务场景（如模板共享、翻译处理）对 Owl 框架进行的微调与增强。
  • public/: 公共/未授权页面逻辑，如数据库管理器（Database Manager）、登录页面相关的 JS 交互及错误提示。
  • libs/: 第三方静态资源库（如 FontAwesome 图标字体、PDF.js 等），作为底层基础设施支撑 UI 展示。

报告总结: 本次扫描涵盖了 src 目录下所有的 9 个顶级子目录及其多级子文件夹。Odoo 16.0 采用了高度结构化的组织方式，大部分导出集中在 core/ (底层) 和 views/ (表现层)。所有的导出均符合 ES6 规范，且绝大多数 UI 组件均基于 OWL 框架实现。通过此全量报告，您可以准确定位任何核心类或函数所在的物理位置。