1. Odoo列表视图中复选框禁用问题解析
在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的渲染和状态管理流程。
2. 解决方案：定制Odoo List Renderer
为了实现持久化的复选框禁用，我们需要创建一个自定义的List Renderer，并覆盖其关键方法。核心思路是：
响应式优雅大气集团企业网站模板自带内核安装即用，响应式模板，图片文本均已可视化，简单后台易上手。支持多种内容模型，可按需添加。模板特点： 1、安装即用，自带人人站CMS内核及企业站展示功能（产品，新闻，案例展示等），并可根据需要增加表单 搜索等功能（自带模板） 2、支持响应式 3、前端banner轮播图文本均已进行可视化配置 4、伪静态页面生成 5、支持内容模型、多语言、自定义表单、筛选、多条件搜
- 初始禁用： 仍然在_renderRow中根据业务逻辑禁用复选框。
- 持久化禁用： 覆盖_enableRecordSelectors方法，在Odoo尝试启用所有复选框之后，重新应用我们的禁用逻辑，确保满足条件的复选框保持禁用状态。
2.1 定义自定义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文件需要引用
});2.2 在XML视图中应用自定义渲染器
在定义了自定义JavaScript文件后，你需要在Odoo的XML视图文件中引用它。这通常通过在
your.model.tree your.model
请确保将your_module_name替换为你的实际模块名，并将your.model替换为你的模型名称。
3. 注意事项与最佳实践
-
模块依赖： 确保你的Odoo模块的__manifest__.py文件中包含了对web模块的依赖，并且在assets或web.assets_backend中正确加载了你的JavaScript文件。
# __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, } - 性能考量： 对于包含大量记录的列表视图，_enableRecordSelectors中遍历所有记录并操作DOM可能会有轻微的性能开销。然而，对于大多数Odoo应用场景，这种开销通常在可接受范围内。
- Odoo版本兼容性： 本文的解决方案基于Odoo v14的API。在不同版本的Odoo中，ListRenderer或ListView的内部结构和方法签名可能有所不同，因此在升级Odoo版本时，可能需要对代码进行相应的调整。
- 业务逻辑封装： 将禁用复选框的业务逻辑（例如stock
- 调试技巧： 在开发过程中，利用浏览器开发工具（F12）的Console和Debugger功能，可以有效地跟踪JavaScript代码的执行流程，检查DOM元素的状态，帮助定位问题。
4. 总结
通过继承并重写Odoo的ListRenderer，特别是其_renderRow和_enableRecordSelectors方法，我们可以有效地控制列表视图中复选框的禁用状态，使其在用户交互后依然保持一致。这种方法提供了一个健壮的解决方案，确保了Odoo前端界面的业务逻辑准确性和用户体验的连贯性。掌握这种定制Odoo前端行为的能力，对于开发复杂的业务模块至关重要。
