最稳的方式是在列配置的templet函数中通过判断返回对应文字,不依赖dom且不影响排序分页;需根据d.status等字段值映射为字符串,注意字段名、嵌套路径、数据类型及样式拼接。
直接在列配置的 templet 函数里做判断,返回对应文字即可——这是最稳、不依赖 dom、不干扰排序和分页的方式。
templet 函数里怎么写状态映射逻辑
核心是用函数返回字符串,不是写死文本。参数 d 是当前行完整数据对象,可安全读取 d.status 或 d.code 等字段。
- 简单两三种状态:用三元或 if 判断,比如
return d.status === 1 ? '已启用' : '已禁用'; - 状态多(如 5 种以上):提前定义映射对象,避免嵌套过深,例如:
const statusText = {0: '待提交', 1: '审核中', 2: '已通过', 3: '已驳回', 4: '已取消'};return statusText[d.status] || '未知'; - 后端字段名不一致?常见错误是
d.status为undefined,检查接口返回的实际字段名(比如是status_code还是state),field配置必须完全匹配 - 嵌套字段(如
{info: {status: 1}})不能直接写d.info.status——field不支持点号路径,需在templet里手动取:d.info?.status,或在parseData中扁平化
数字状态码转文字时类型容易出错
后端常返回数字(1)、字符串数字("1")或布尔值(true),混用 === 会失效。
- 统一转字符串再比:
String(d.status) === '1' - 或统一转数字:
Number(d.status) === 1—— 比parseInt更安全,对null、""返回0,对undefined返回NaN - 务必处理
isNaN():const val = Number(d.status); return isNaN(val) ? '未知' : statusText[val] || '未知'; - 别信按钮上显示的文字去反推状态——点击事件里要读
data.status,不是$(this).text()
想加颜色或 badge 样式怎么办
直接拼 HTML 字符串,用内联 style 最可靠。Layui 不解析 class 名,也不推荐在 cellStyle 里传 class 字符串。
- 返回带样式的 span:
return '<span style="color:#FF5722;">' + (d.status === 0 ? '失败' : '成功') + '</span>'; - 多个样式合并写:
style="color:#5FB878; font-weight:bold;" - 用映射对象管理样式更清晰:
const statusColor = {0: '#FF5722', 1: '#5FB878', 2: '#999'};return `<span style="color:${statusColor[d.status] || '#666'}">${statusText[d.status] || '-'}</span>`; - 注意引号嵌套:整个模板用单引号,内部 style 用双引号,否则渲染失败
为什么不用 done 回调遍历 DOM 替换
看似简单,但实际踩坑多:分页切换后新数据不会自动执行;开启 height 后虚拟滚动节点漏处理;排序/搜索后 DOM 结构重排导致替换失效;还可能因截断、单位符号(如 "100%")干扰文本匹配。
-
templet是声明式渲染,每次重新生成内容,天然适配所有交互场景 - 调试时可在
templet开头加console.log(d),确认字段结构和值类型 - 若多个列共用同一套映射(如
type、status、level),建议抽成全局函数:window.statusText = v => ({0:'关闭',1:'开启'}[v] || '-');,列里直接写templet: d => statusText(d.status)
真正容易被忽略的是字段名大小写和嵌套层级——接口字段改个命名,前端不报错但始终显示空白,得靠 console.log(d) 实锤。映射逻辑本身很简单,卡住的永远是那一个字母。










