在Odoo的列表(Tree)视图中,开发者经常需要根据记录的特定条件来动态禁用某些复选框,以防止用户选择不符合业务逻辑的记录。常见的实现方式是继承web.ListRenderer并重写_renderRow方法,在该方法中根据记录数据设置复选框的disabled属性。
然而,这种方法在Odoo的可编辑列表视图中会遇到一个常见的问题:当用户点击某一行进入编辑模式,或者进行其他与行交互的操作后,原本被禁用的复选框会自动重新启用。这是因为Odoo的ListEditableRenderer(或其父类ListRenderer)内部有一套管理记录选择器(即复选框)状态的机制。具体来说,_disableRecordSelectors和_enableRecordSelectors这两个方法负责在特定场景下统一禁用或启用所有记录选择器。
Odoo的默认实现如下:
_disableRecordSelectors: function () { this.$('.o_list_record_selector input').attr('disabled', 'disabled'); }, _enableRecordSelectors: function () { this.$('.o_list_record_selector input').attr('disabled', false); },
当用户与行交互时,Odoo可能会调用_enableRecordSelectors来确保其他行可被选中,此时,我们通过_renderRow设置的disabled属性就会被覆盖,导致复选框重新启用。要解决这个问题,我们需要更深入地介入Odoo的渲染和状态管理流程。
为了实现持久化的复选框禁用,我们需要创建一个自定义的List Renderer,并覆盖其关键方法。核心思路是:
首先,在你的Odoo模块的static/src/js目录下创建一个JavaScript文件(例如:your_module_name/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 CustomListRenderer = ListRenderer.extend({ /** * @override * 在渲染每一行时应用初始的禁用逻辑。 * 确保在Odoo渲染行时,根据条件禁用复选框。 */ _renderRow: function (record) { // 调用父类的_renderRow方法,完成Odoo默认的行渲染 var $tr = this._super.apply(this, arguments); // 定义需要特殊处理的分类 var categoriesToExclude = ['Maintenance', 'Installation', 'Transport', "Volume d'impression"]; // 判断条件:库存为0且不属于特定分类 var shouldBeDisabled = record.data.stock <= 0 && !categoriesToExclude.includes(record.data.small_category_name_field); // 应用禁用属性到当前行的复选框 $tr.find("input[type='checkbox']").prop('disabled', shouldBeDisabled); return $tr; }, /** * @override * 覆盖_enableRecordSelectors方法,在Odoo尝试启用所有复选框后, * 重新应用我们自定义的禁用逻辑,以确保满足条件的复选框保持禁用。 */ _enableRecordSelectors: function () { // 首先调用父类的_enableRecordSelectors,让Odoo执行其默认的启用操作 this._super.apply(this, arguments); // 重新遍历所有记录,并根据我们的业务逻辑再次禁用相应的复选框 var self = this; var categoriesToExclude = ['Maintenance', 'Installation', 'Transport', "Volume d'impression"]; this.records.forEach(function (record) { // 找到当前记录对应的DOM行元素 var $row = self.$("tr[data-id='" + record.id + "']"); // 判断条件与_renderRow中相同 var shouldBeDisabled = record.data.stock <= 0 && !categoriesToExclude.includes(record.data.small_category_name_field); if (shouldBeDisabled) { // 如果满足禁用条件,则禁用该行的复选框 $row.find("input[type='checkbox']").prop('disabled', true); } }); }, // 如果需要,也可以覆盖 _disableRecordSelectors,但通常情况下, // 只需要关注 _enableRecordSelectors 来解决意外启用问题。 // _disableRecordSelectors: function () { // this._super.apply(this, arguments); // // 如果有特殊需求,可以在这里添加额外的禁用逻辑 // }, }); // 定义一个自定义的ListView,并将其渲染器设置为我们自定义的CustomListRenderer var CustomListView = ListView.extend({ config: _.extend({}, ListView.prototype.config, { Renderer: CustomListRenderer, }), }); // 将自定义视图注册到Odoo的视图注册表中,以便在XML中引用 viewRegistry.add('custom_tree_renderer', CustomListView); return CustomListRenderer; // 导出渲染器,如果其他JS文件需要引用 });
在定义了自定义JavaScript文件后,你需要在Odoo的XML视图文件中引用它。这通常通过在
<record id="your_model_view_tree" model="ir.ui.view"> <field name="name">your.model.tree</field> <field name="model">your.model</field> <field name="arch" type="xml"> <!-- 使用js_class属性指定我们自定义的渲染器 --> <tree js_class="custom_tree_renderer"> <!-- 你的字段定义 --> <field name="display_name"/> <field name="stock"/> <field name="small_category_name_field"/> <!-- ... 其他字段 --> </tree> </field> </record>
请确保将your_module_name替换为你的实际模块名,并将your.model替换为你的模型名称。
# __manifest__.py { 'name': 'Your Module Name', 'version': '1.0', 'depends': ['web', 'base'], # 确保依赖 'web' 'data': [ 'views/your_model_views.xml', ], 'assets': { 'web.assets_backend': [ 'your_module_name/static/src/js/custom_list_renderer.js', 'your_module_name/static/src/xml/custom_list_renderer_templates.xml', // 如果有QWeb模板 ], }, 'installable': True, 'application': False, }
通过继承并重写Odoo的ListRenderer,特别是其_renderRow和_enableRecordSelectors方法,我们可以有效地控制列表视图中复选框的禁用状态,使其在用户交互后依然保持一致。这种方法提供了一个健壮的解决方案,确保了Odoo前端界面的业务逻辑准确性和用户体验的连贯性。掌握这种定制Odoo前端行为的能力,对于开发复杂的业务模块至关重要。
以上就是优化Odoo列表视图:持久化禁用特定复选框的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号