样式操作

0.00

★29次@未来之窗

A:赛忞初雪

上架: 2025-09-17 02:46:00

         收藏
 

四方仙域传送阵         

未来之窗昭和仙君 - cyberwin_fairyalliance_webquery 样式方法

未来之窗昭和仙君 - cyberwin_fairyalliance_webquery 样式操作方法

一、概述

"未来之窗昭和仙君cyberwin_fairyalliance_webquery"(简称$cq库)是一款轻量级JavaScript查询库,支持DOM元素选择、样式操作、事件绑定、表单处理、AJAX请求等功能,同时提供了中文友好的方法命名,兼容多种浏览器,可满足前端日常开发中的常见交互需求。

核心作用:通过选择器直接操作DOM元素的CSS类名,简化样式切换逻辑,支持链式调用。

使用形式:不同于实例化对象,该工具通过全局函数$cq(选择器)直接调用方法,如:
$cq("#demoText").添加样式("active")

二、样式操作方法

1. 添加样式(添加样式)

功能:为选择器匹配的DOM元素批量添加一个或多个CSS类名,实现样式生效。

语法

$cq(选择器).添加样式(classNames);

参数说明

参数 类型 说明 示例
选择器 String DOM选择器(支持ID、类名、标签等标准CSS规范标准选择器语法) "#demoText"、".item"、"div"
classNames String 单个或多个CSS类名,多类名用空格分隔 "active"、"demo-red demo-bg-blue"

返回值:返回选择器对应的查询对象,支持链式调用

示例

// 为ID为"btn"的元素添加"active"类 $cq("#btn").添加样式("active"); // 为类名为"item"的元素添加"demo-red"和"demo-bg-blue"类 $cq(".item").添加样式("demo-red demo-bg-blue");

2. 删除样式(删除样式)

功能:为选择器匹配的DOM元素批量删除一个或多个CSS类名,实现样式失效。

语法

$cq(选择器).删除样式(classNames);

参数说明:与「添加样式」方法的参数完全一致。

返回值:返回选择器对应的查询对象,支持链式调用

示例

// 为ID为"btn"的元素删除"active"类 $cq("#btn").删除样式("active"); // 为类名为"item"的元素删除"demo-red"和"demo-bg-blue"类 $cq(".item").删除样式("demo-red demo-bg-blue");

三、Demo示例

场景:按钮点击切换文本样式

通过$cq(选择器)直接调用样式方法,实现点击按钮后文本样式的切换。

未来之窗昭和仙君 - 样式演示文本

1. 核心代码

// 按钮点击事件 $cq("#styleBtn").on("click", function() { // 切换状态标记 const isActive = false; if (!isActive) { // 添加样式:红色文字+蓝色背景+高亮边框 $cq("#demoText") .添加样式("demo-red demo-bg-blue active") .删除样式("demo-hidden"); // 更改按钮文字 $cq(this).text("恢复默认样式"); } else { // 删除样式 $cq("#demoText") .删除样式("demo-red demo-bg-blue active"); // 恢复按钮文字 $cq(this).text("点击切换样式"); } });

2. 演示说明

  • 点击按钮时,通过$cq("#demoText")直接选择文本元素并调用样式方法;
  • 初始状态下,文本无特殊样式,点击后添加demo-red(红色粗体)、demo-bg-blue(蓝色背景)和active(橙色边框)三类样式;
  • 再次点击按钮,通过删除样式方法移除上述类,恢复默认状态;
  • 代码中$cq(this)表示当前点击的按钮元素,直接对其操作(修改文字)。

四、注意事项

  • 选择器语法$cq(选择器)支持标准CSS选择器语法(ID选择器#、类选择器.、标签选择器等);
  • 链式调用:支持连续调用多个方法,如:
    $cq(".box").添加样式("active").删除样式("hidden").text("内容")
  • 多元素处理:若选择器匹配多个元素,样式方法会对所有匹配元素生效;
  • 重复添加:同一类名重复添加不会产生副作用(底层会自动忽略已存在的类名);
  • this关键字:在事件回调中,$cq(this)可直接操作当前触发事件的元素(如示例中的按钮)。

硬件app