在Odoo v14的列表视图开发中，经常会遇到需要禁用部分行复选框的场景，比如已审核的订单不允许再次勾选操作。但默认情况下，列表视图的复选框状态不会持久化，页面刷新或数据重载后禁用状态就会丢失，需要重新处理逻辑。要解决这个问题，需要从前端状态存储和后端字段关联两个维度入手。
复选框默认行为分析
Odoo v14的列表视图复选框由ListRenderer组件负责渲染，默认的禁用逻辑仅在当前渲染周期内生效，不会将状态同步到后端或者本地存储。当触发数据重新加载、页面刷新、筛选条件变更等操作时，ListRenderer会重新执行渲染逻辑，之前设置的禁用状态就会被重置。
要实现持久化，首先需要明确复选框禁用的判断依据，通常我们会关联模型的一个布尔字段，比如is_disabled，当该字段为True时，对应行的复选框需要保持禁用状态。
后端模型字段配置
首先需要在对应的业务模型中添加用于标记复选框禁用状态的布尔字段，该字段需要存储到数据库中，保证状态不会因为页面操作丢失。
from odoo import models, fields
class SaleOrder(models.Model):
_inherit = 'sale.order'
# 标记复选框是否禁用的字段，默认值为False
is_checkbox_disabled = fields.Boolean(
string='复选框禁用标记',
default=False,
help='当该字段为True时，列表视图中对应行的复选框将被禁用'
)
添加字段后需要执行模块升级，确保字段成功添加到数据库表中。
前端渲染逻辑调整
接下来需要重写ListRenderer的复选框渲染方法，将禁用逻辑和后端字段关联，同时保证状态在渲染周期内和重载后都能生效。
创建前端扩展文件
在模块的static/src/js目录下创建list_renderer_extension.js文件，内容如下：
odoo.define('your_module_name.list_renderer_extension', function (require) {
"use strict";
var ListRenderer = require('web.ListRenderer');
var core = require('web.core');
var _t = core._t;
// 重写ListRenderer的复选框渲染方法
ListRenderer.include({
/**
* 渲染单行复选框的方法
* @param {Object} record 当前行的记录数据
* @returns {jQuery} 复选框的jQuery对象
*/
_renderRowCheckbox: function (record) {
var $checkbox = this._super.apply(this, arguments);
// 从记录数据中获取禁用标记字段的值
var isDisabled = record.data.is_checkbox_disabled;
if (isDisabled) {
// 设置复选框为禁用状态，同时添加视觉标记
$checkbox.prop('disabled', true).addClass('o_checkbox_disabled');
}
return $checkbox;
},
/**
* 数据重新加载后的处理逻辑，保证重载后状态不丢失
* @param {Object} data 重新加载的数据
*/
_onReloadData: function (data) {
this._super.apply(this, arguments);
// 重新渲染后再次校验复选框状态，避免重载后状态重置
var self = this;
_.each(this.records, function (record) {
var $row = self._getRow(record.id);
if ($row.length) {
var $checkbox = $row.find('input[type="checkbox"]');
if (record.data.is_checkbox_disabled) {
$checkbox.prop('disabled', true).addClass('o_checkbox_disabled');
}
}
});
}
});
return ListRenderer;
});
注册前端文件
在模块的__manifest__.py中添加前端文件的引用，确保扩展逻辑生效：
{
'name': '列表视图复选框持久化模块',
'version': '1.0',
'depends': ['web', 'sale'],
'data': [],
'qweb': [],
'assets': {
'web.assets_backend': [
'your_module_name/static/src/js/list_renderer_extension.js',
],
},
}
列表视图配置调整
最后需要在对应的列表视图XML定义中，确保is_checkbox_disabled字段被加载到视图数据中，否则前端无法获取到该字段的值。
<record id="view_sale_order_tree_inherit" model="ir.ui.view">
<field name="name">销售订单列表视图继承</field>
<field name="model">sale.order</field>
<field name="inherit_id" ref="sale.view_order_tree"/>
<field name="arch" type="xml">
<xpath expr="//tree" position="attributes">
<attribute name="editable">bottom</attribute>
</xpath>
<!-- 添加禁用标记字段，确保数据加载到前端 -->
<xpath expr="//field[@name='name']" position="before">
<field name="is_checkbox_disabled" invisible="1"/>
</xpath>
</field>
</record>
效果验证
完成以上配置后，升级模块并进入对应的列表视图：
- 当
is_checkbox_disabled字段为True时，对应行的复选框会显示为禁用状态，无法勾选 - 刷新页面、切换筛选条件、点击分页后，禁用状态依然会保持
- 修改
is_checkbox_disabled字段的值后，复选框状态会同步更新
如果需要在禁用时添加提示信息，可以在前端扩展中给禁用的复选框添加title属性，比如$checkbox.attr('title', _t('该记录已审核，不允许操作'))，提升用户操作的友好度。