李涛自留地
回到顶部
首页 > jQuery学习 > jquery动态设置class怎么做?三种入口与顺序

jquery动态设置class怎么做?三种入口与顺序

文章目录

手上有一套跑了六七年的专题页模板,jQuery 停在 1.12。主机那边 PHP 5.6 到期不续,只能迁到 PHP 8。模板里jquery动态设置class有四五种写法,同一个显隐效果被写成 addClass、attr、toggleClass 混着用;升级时 jQuery 跳到 3.7,.live() 一调就抛错。二十几个页面月底前要交,编辑同事隔一天问一次进度,得先把三条入口的分工和先后定下来,再逐页替换。

三种入口各自改的是哪一层

顺序不难定:初始化时用一次 attr('class', ...) 铺底,跑起来以后只用 addClass 和 removeClass 做增减,需要跟着状态翻转的交给 toggleClass,收尾不要再回头用 attr 覆盖。

左侧元素向右分出三条并列写入分支

这里说的jquery动态设置class,落到代码上是三条粒度不同的写入口,写的都是同一个 class 属性。addClass 读出现有的属性字符串,把新类名追加到末尾,原有的类一个不动;attr('class', ...) 是整串替换,没写进去的类全部消失;toggleClass 也按类名逐个处理,但它先判断这个类在不在,在就删、不在就加。

顺序上有两个约束。attr 只建议放初始化,它一执行就把前面的结果整串抹平,跑起来以后别再用;toggleClass 要排在 addClass 之前,先加后切,刚加上的类会被 toggle 当成已存在删掉。顺序错掉的代价不是样式难看,是状态和类对不上:后面用 hasClass 判断分支的代码会走进另一条路,改起来比重写那段还费时间。

旧模板里的写法正好反过来:先 toggleClass('open'),再 attr('class', 'panel open'),后者把前者算出来的结果整串覆盖,面板点几次都是打开状态,toggle 等于没写。

addClass与attr的区别

差别落在其他类还在不在。给 class="panel item" 的元素跑 addClass('active'),属性变成 panel item active,item 上挂的样式照旧;换成 attr('class', 'active'),item 直接没了,挂在它上面的边距和边框跟着一起消失。

读的方向也有坑。元素从来没有 class 属性时,attr('class') 返回 undefined,不是空字符串。写成 $(el).attr('class').split(' ') 就会在控制台抛 Uncaught TypeError: Cannot read properties of undefined (reading 'split'),而且只在没类的元素上抛,有类的元素一切正常。

两块面板各写一套写法,互不相连

另一个是点号。addClass('.active') 不报错,写进属性的是 ".active" 这个字面量,$('.active') 选不到它,$('.active').length 返回 0。要看它到底写成了什么,用 document.querySelectorAll('[class*=".active"]') 数一下,长度大于 0 就说明参数里多了个点。

这套页面里jquery动态设置class的调用点有四十多处,逐个看不如先按入口归类。元素上已经有一批功能类时用 addClass;attr('class', ...) 只留给初始化,而且要把基础类一起拼上,比如 attr('class', 'panel ' + theme)。

toggleClass的切换时机

toggleClass 的判断依据是类名在不在,先读当前类名,有则删、无则加,同一个元素点两次必然回到调用前的状态。

回到的状态是有哪些类,不是 class 字符串长什么样。下面这段在控制台跑,打印三次属性值就能看出来。

var $box = $('<div class="b a"></div>').appendTo('body');
console.log($box.attr('class'));  // b a
$box.toggleClass('b');
console.log($box.attr('class'));  // a
$box.toggleClass('b');
console.log($box.attr('class'));  // a b

三行依次是 b a、a、a b。写回属性时 b 被追加到末尾,顺序变了。视觉上没区别,但拿 attr('class') 和固定字符串做比较的代码会失效,改成 hasClass('b') 才稳。

真正需要看时机的是第二个参数。toggleClass('open', state) 里 state 为 true 就强制加、false 就强制删,和「反过来」不是一回事。状态来自一个明确的布尔值(折叠面板的 data-open、复选框的 checked)时用它,一处赋值就够;状态由多个地方各改一次时不要用无参版本,连调两次会互相抵消,带第二个参数时则是最后一次生效,前面那次等于白调。面板上同时维护 data-open 和 open 类的写法最容易出问题,某次只改了 data 没改类,展开状态和样式就对不上,页面上变成两个面板都开着。

两条并列分支各写一次,再汇到同一处

和 addClass 混用时,先加后切等于白加。addClass('open') 之后紧跟 toggleClass('open'),元素上的 open 会被删掉,页面上看到的是类加了又没了,这一点排错时最容易被当成 CSS 没加载。

类加上去没生效,症状分三种

这三种情况在控制台里长得完全不一样,按下面的顺序一条条排除,前一条不成立再看下一条。

第一种,DOM 里根本没有这个类。跑 $('#panel').attr('class'),返回 undefined 说明属性都没建起来;返回的串里带着 .active,说明点号被写进了参数,两种都跟样式无关。

第二种,类在,样式不生效。$('#panel').hasClass('active') 是 true,颜色没变,多半是选择器权重:.wrap .item.active 比 .active 高一级,后加的类不改变权重。用 getComputedStyle($('#panel')[0]).backgroundColor 读计算值,别只看审查元素里被划掉的那条规则。

第三种,类加上了又消失。$._data($('#panel')[0], 'events').click.length 数一下挂了几次,大于 1 就是重复绑定。迁的时候把 .live() 换成 .on() 写在 each 里面,一个按钮会挂三次,toggle 连调三次等于一次,表现就是有时灵有时不灵。$._data 是内部接口,只拿来排查,别写进业务代码。

类有没有进 DOM,是排查的第一个分岔点。跳过这一步直接查权重,会在一个压根没有类的元素上比对半天样式。

先在一个页面上核这四行

改模板之前,挑一个出问题的页面,在控制台把下面四行跑一遍。它同时读原生属性和 jQuery 的读法,两边不一致就说明取错了对象。

var el = document.querySelector('#panel');
console.log(el.getAttribute('class'));  // 期望 base active
console.log($(el).attr('class'));       // 与上一行一致
console.log($(el).hasClass('active'));  // 期望 true
console.log($(el).data('open'));        // 示例页为 false

四行的结果应该是 base active、base active、true、false。第一行打出 null,问题在模板输出,不在脚本;四行都对但样式没变,回到权重那一段。

今天能做的动作只有一件:在还没迁完的页面里挑一个,把这四行贴进控制台,把输出抄到提交说明里。改完第二页再跑一次,两次一致,说明jquery动态设置class的入口和顺序在这一页定住了,其余页面可以照着替换。

若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。