layui table怎么给某一行添加自定义class类名

冬辰大大_8228

冬辰大大_8228

2026-11-14

178人浏览

原创

rowClassName 是唯一稳定生效的行样式配置方式,必须在 table.render() 初始参数中定义,接收 {data, index, tr} 并同步返回空格分隔的类名字符串,仅对初始渲染和 table.reload() 生效,不覆盖默认类,且支持外部 DOM 查询。

layui table怎么给某一行添加自定义class类名

直接用 rowClassName 函数,别碰 DOM 操作或 done 回调加 class——它会在分页、排序、重载时自动失效。

rowClassName 是唯一稳定生效的方式

这个配置项必须写在 table.render() 的初始参数里,函数接收 {data, index, tr},返回字符串类名(空格分隔),Layui 会把它追加到 的 class 属性中,且不覆盖默认类(如 layui-table-hover)。

  • 只对「初始渲染」和 table.reload() 生效;手动改 table.cache 或调用 updateCell() 不会触发它
  • 返回空字符串或 undefined,该行不加额外类
  • data 就是当前行原始数据对象,比如后端返回了 status: "error",直接取 data.status 判断即可
  • 别在函数里做异步请求(如 fetch),必须同步返回;否则类名永远加不上

常见错误:在 done 回调里用 jQuery 找 tr 加 class

这种写法看似能跑通,但实际埋了三个雷:

  • 开启 height(虚拟滚动)后,done 只处理可视区域的行,滚动后新出现的行不会自动加类
  • 每次分页、排序、搜索都会触发 done,若没先 removeClass(),类名越积越多
  • 用 eq(2) 定位列容易错位——列顺序一变,eq(2) 就指向了别的字段;应改用 data-field="status" 属性定位

rowClassName 示例:按 status 字段区分行样式

假设后端返回的数据有 status 字段,值为 "success"、"error" 或 "pending":

rowClassName: function(obj) {
  if (obj.data.status === 'error') return 'row-error';
  if (obj.data.status === 'success') return 'row-success';
  if (obj.data.status === 'pending') return 'row-pending';
  return '';
}

对应 CSS 需自己定义,例如:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
.row-error { background-color: #ffebee !important; }
.row-success { background-color: #e8f5e9 !important; }

注意加 !important——因为 Layui 行内样式(如 hover 背景)权重高,不强制覆盖可能无效。

为什么 rowStyle 不适合加 class?

rowStyle 返回的是驼峰式 CSS 对象(如 {backgroundColor: '#fff'}),它不能添加 class 名,只能设内联样式。如果你要复用已有 CSS 类、配合媒体查询、或用 JS 动态切换(比如点击切换 row-expanded),rowClassName 是唯一选择。

另外,rowStyle 在表格重绘时会重新执行,但它不操作 class 属性;而 rowClassName 的返回值会直接写入 DOM 的 class,后续用 document.querySelector('.row-error') 也能精准命中——这点在需要外部脚本联动时很关键。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui表格 layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
css3教程
css3教程

php中文网为大家提供css3教程合集,CSS3的语法是建立在CSS原先版本基础上的,它允许使用者在标签中指定特定的HTML元素而不必使用多余的class、ID或JavaScript。php中文网还为大家带来css3的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2200

10

有哪些css3渐变属性
有哪些css3渐变属性

css3中渐变属性有linear-gradient、radial-gradient、conic-gradient、repeating-linear-gradient、repeating-radial-gradient等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.01

3626

5

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

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

2026.11.12

20

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

20

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

120

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

100

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

100

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

80

12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 13.2万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.5万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习