讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

Odoo v14中持久化列表视图复选框禁用状态的专业指南

大磊君_5046

大磊君_5046

发布时间:2025-07-12 14:10:01

|

522人浏览过

|

来源于php中文网

原创

odoo v14中持久化列表视图复选框禁用状态的专业指南

本文旨在解决Odoo v14中列表视图(List View)复选框动态禁用状态在行编辑后失效的问题。我们将深入探讨Odoo列表渲染机制,特别是其对记录选择器的管理,并提供一种创建自定义渲染器(Custom ListRenderer)的解决方案。通过重写关键方法并利用js_class属性,确保特定条件下(如库存为零)的复选框在用户交互后依然保持禁用状态,从而提升Odoo前端功能的稳定性和用户体验。

1. 问题背景与Odoo列表视图渲染机制

在Odoo的列表视图中,开发者经常需要根据特定业务逻辑动态地禁用某些行的复选框。例如,当一个产品的库存量为零时,可能需要禁用其对应的选择框,以防止用户对其进行操作。通常,这可以通过扩展ListRenderer并重写其_renderRow方法来实现,在行渲染时根据数据条件设置复选框的disabled属性。

然而,一个常见的问题是,当用户点击或修改列表视图中的任何一行时,之前被禁用的复选框会自动重新启用。这使得前端的禁用逻辑失效,需要刷新页面才能恢复。其根本原因在于Odoo的列表视图,特别是可编辑列表视图(ListEditableRenderer),在处理行编辑模式时,会通过其内部机制统一管理记录选择器的状态。具体来说,Odoo在进入编辑模式时可能会调用_disableRecordSelectors来禁用所有选择器,而在退出编辑模式或更新行后,会调用_enableRecordSelectors来重新启用它们。这些内部方法会覆盖我们在_renderRow中设置的disabled属性。

Odoo内部ListEditableRenderer中控制选择器的方法大致如下:

// Odoo 14.0/addons/web/static/src/js/views/list/list_editable_renderer.js
_disableRecordSelectors: function () {
    this.$('.o_list_record_selector input').attr('disabled', 'disabled');
},

_enableRecordSelectors: function () {
    this.$('.o_list_record_selector input').attr('disabled', false);
},

这些方法会直接操作DOM,将所有.o_list_record_selector input元素的disabled属性设置为true或false,从而导致我们自定义的禁用逻辑被覆盖。

2. 解决方案:创建自定义列表渲染器

为了解决上述问题,我们需要创建一个自定义的列表渲染器,并不仅仅是重写_renderRow,更重要的是要介入Odoo对选择器启用/禁用过程的控制。核心思想是:在Odoo尝试重新启用所有选择器之后,我们再次根据业务逻辑判断并禁用那些应该保持禁用的复选框。

CDP浏览器大师
CDP浏览器大师

CDP浏览器大师:通过Chrome DevTools Protocol驱动已登录浏览器实现自动化任务,解决反爬封号、选择器失效、SPA路由难导航、固定sleep不准四大痛点。核心能力包括UA伪装、WebGL/Canvas指纹混淆、智能等待、动态选择器以及可视化调试。

下载

2.1 定义自定义ListRenderer

我们将创建一个新的JavaScript文件(例如:static/src/js/custom_list_renderer.js)来定义我们的自定义渲染器。

odoo.define('your_module_name.CustomListRenderer', function (require) {
    "use strict";

    var ListRenderer = require('web.ListRenderer');
    var ListView = require('web.ListView');
    var viewRegistry = require('web.view_registry');

    // 定义需要保持禁用状态的类别
    var CATEGORIES_TO_EXCLUDE = ['Maintenance', 'Installation', 'Transport', "Volume d'impression"];

    var CustomListRenderer = ListRenderer.extend({
        /**
         * 扩展 _renderRow 方法,在初始渲染时禁用符合条件的复选框。
         * 这是首次加载视图时应用禁用逻辑的地方。
         */
        _renderRow: function (record) {
            var tr = this._super.apply(this, arguments); // 调用父类的_renderRow方法获取原始行元素
            // 根据库存和类别条件禁用复选框
            var shouldBeDisabled = record.data.stock <= 0 && !CATEGORIES_TO_EXCLUDE.includes(record.data.small_category_name_field);
            tr.find(".o_list_record_selector input[type='checkbox']").prop('disabled', shouldBeDisabled);
            return tr;
        },

        /**
         * 重写 _enableRecordSelectors 方法,确保在Odoo尝试启用所有选择器后,
         * 仍然能够保持特定复选框的禁用状态。
         */
        _enableRecordSelectors: function () {
            this._super.apply(this, arguments); // 首先,调用父类方法,让Odoo启用所有选择器
            var self = this;

            // 遍历当前渲染的所有记录,重新应用禁用逻辑
            this.records.forEach(function(record) {
                // 查找当前记录对应的DOM行元素
                var tr = self.$el.find('tr[data-id="' + record.id + '"]');
                if (tr.length) {
                    var shouldBeDisabled = record.data.stock <= 0 && !CATEGORIES_TO_EXCLUDE.includes(record.data.small_category_name_field);
                    tr.find(".o_list_record_selector input[type='checkbox']").prop('disabled', shouldBeDisabled);
                }
            });
        },

        /**
         * _disableRecordSelectors 方法通常可以保持不变,因为它只是全局禁用。
         * 如果有特殊需求,也可以在此处添加逻辑。
         */
        // _disableRecordSelectors: function () {
        //     this._super.apply(this, arguments);
        // },
    });

    // 定义自定义ListView,并配置使用CustomListRenderer
    var CustomListView = ListView.extend({
        config: _.extend({}, ListView.prototype.config, {
            Renderer: CustomListRenderer,
        }),
    });

    // 将自定义视图注册到视图注册表中,以便在XML中通过js_class引用
    viewRegistry.add('custom_tree_renderer', CustomListView);

    return {
        CustomListRenderer: CustomListRenderer,
        CustomListView: CustomListView,
    };
});

代码解析:

  1. odoo.define(...): Odoo模块定义标准语法。
  2. require(...): 导入所需的Odoo Web模块,如ListRenderer、ListView和viewRegistry。
  3. CATEGORIES_TO_EXCLUDE: 定义一个常量数组,用于存放不需要禁用复选框的类别名称,增加代码可读性和可维护性。
  4. CustomListRenderer = ListRenderer.extend(...): 继承Odoo的ListRenderer。
    • _renderRow(record): 这个方法在每一行数据被渲染时调用。我们首先调用this._super()来执行父类的渲染逻辑,然后根据record.data.stock和record.data.small_category_name_field的值来判断是否禁用该行的复选框。
    • _enableRecordSelectors(): 这是解决核心问题的关键。当Odoo尝试重新启用所有记录选择器时,此方法会被调用。我们首先调用this._super()让Odoo执行其默认的启用操作。紧接着,我们遍历当前渲染器中的所有records,找到对应的DOM行元素,并重新应用我们的禁用逻辑。这样,即使Odoo尝试启用,我们也能立即根据条件再次禁用。
  5. CustomListView = ListView.extend(...): 继承Odoo的ListView,并配置其Renderer属性为我们自定义的CustomListRenderer。这是将自定义渲染器与视图关联起来的桥梁。
  6. viewRegistry.add('custom_tree_renderer', CustomListView): 将我们自定义的CustomListView注册到Odoo的视图注册表中,并为其指定一个唯一的名称custom_tree_renderer。这个名称将在XML视图中用到。

2.2 在Odoo XML视图中应用自定义渲染器

在你的Odoo模块的XML视图文件中,找到你想要应用此自定义逻辑的tree视图定义,并添加js_class属性,值为你在viewRegistry.add中注册的名称。

<record id="view_your_model_tree" model="ir.ui.view">
    <field name="name">your.model.tree</field>
    <field name="model">your.model</field>
    <field name="arch" type="xml">
        <tree js_class="custom_tree_renderer">
            <!-- 你的字段定义 -->
            <field name="name"/>
            <field name="stock"/>
            <field name="small_category_name_field"/>
            <!-- ... 其他字段 ... -->
        </tree>
    </field>
</record>

重要提示:

  • 确保你的JavaScript文件被正确加载。你需要在模块的__manifest__.py文件中,将JavaScript文件添加到assets配置中,例如:
    'assets': {
        'web.assets_backend': [
            'your_module_name/static/src/js/custom_list_renderer.js',
        ],
    },
  • 在每次修改JavaScript或XML文件后,务必升级你的Odoo模块,以确保更改生效。

3. 注意事项与最佳实践

  • 选择器精度:在_renderRow和_enableRecordSelectors中,使用tr.find(".o_list_record_selector input[type='checkbox']")来精确选择目标复选框,避免影响其他元素。
  • 性能考量:_enableRecordSelectors会在每次Odoo尝试启用选择器时遍历所有记录。对于包含大量记录的视图,确保你的禁用逻辑尽可能高效,避免复杂的计算。
  • Odoo版本兼容性:Odoo的内部API(如ListRenderer的方法和DOM结构)在不同版本之间可能会有变化。本教程基于Odoo v14,在升级到新版本时,请注意检查相关方法的行为是否一致。
  • 模块化:将自定义逻辑封装在独立的JS文件中,并使用odoo.define进行模块化管理,有助于代码的组织和维护。
  • 调试:在开发过程中,利用浏览器开发工具(F12)的console.log()来输出变量值,追踪代码执行流程,是定位问题的有效方法。

4. 总结

通过扩展Odoo的ListRenderer并重写_renderRow和_enableRecordSelectors方法,我们可以有效地控制列表视图中复选框的禁用状态,使其在用户交互后依然保持稳定。这种方法深入理解了Odoo前端渲染机制,提供了一种健壮且可维护的解决方案,确保了自定义UI逻辑的持久性,从而显著提升了Odoo应用的可用性和用户体验。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6424

2023.10.24

typedef和define区别
typedef和define区别

typedef和define区别在类型检查、作用范围、可读性、错误处理和内存占用等。本专题为大家提供typedef和define相关的文章、下载、课程内容,供大家免费下载体验。

313

2023.09.26

define的用法
define的用法

define用法:1、定义常量;2、定义函数宏:3、定义条件编译;4、定义多行宏。更多关于define的用法的内容,大家可以阅读本专题下的文章。

619

2023.10.11

require的用法
require的用法

require的用法有引入模块、导入类或方法、执行特定任务。想了解更多require的相关内容,可以阅读本专题下面的文章。

1975

2023.11.27

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5204

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

6757

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2662

2024.11.28

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

5056

2023.06.20

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MDN CSS 文档与布局指南
MDN CSS 文档与布局指南

共0课时 | 0人学习

Postman安装指南
Postman安装指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn