jQuery UI API – .toggleClass()

优质
小牛编辑
125浏览
2023-12-01

所属类别

特效(Effects) | 特效核心(Effects Core) | 方法重载(Method Overrides)

用法

描述:当动画样式改变时,根据 Class 是否存在以及 switch 参数的值,为匹配的元素集合内的每个元素添加或移除一个或多个 Class。

返回:jQuery

.toggleClass( className [, switch ] [, duration ] [, easing ] [, complete ] )
参数类型描述默认值
ClassNameString为匹配的元素集合中的每个元素要切换的一个或多个 class 名称,多个 class 名称用空格分隔 。
switchBoolean一个布尔值,指定 class 应被添加还是被移除。
durationNumber 或 String一个字符串或一个数字,指定动画将运行多久。400
easingString一个字符串,指示要使用的 easing 函数。swing
completeFunction()一旦动画完成时要调用的函数。

.toggleClass( className [, switch ] [, options ] )
参数类型描述
ClassNameString为匹配的元素集合中的每个元素要切换的一个或多个 class 名称,多个 class 名称用空格分隔 。
switchBoolean一个布尔值,指定 class 应被添加还是被移除。
optionsObject所有的动画设置。所有的属性是可选的。
  • duration(默认值:400
    类型:Number 或 String
    描述:一个字符串或一个数字,指定动画将运行多久。
  • easing(默认值:swing
    类型:String
    描述:一个字符串,指示要使用的 easing 函数。
  • complete
    类型:Function()
    描述:一旦动画完成时要调用的函数。
  • children(默认值:false
    类型:Boolean
    描述:指定动画是否被应用到匹配元素的所有后代。此功能应慎重使用,因为判断元素是否是动画的后代的代价是很大的,会根据后代的数量线性增长。
  • queue(默认值:true
    类型:Boolean 或 String
    描述:一个布尔值,指示是否将动画放在特效队列中。如果是 false,动画将立即开始。自 jQuery 1.7 起,queue 选项也接受一个字符串,在这种情况下,动画添加到由字符串表示的队列中。

与原生的 CSS 过渡相似,jQuery UI 的 class 动画提供了一个平稳的从一个状态转换到另一个状态的过渡,同时确保所有样式变化的细节是通过 CSS 来完成的,而不需要使用 JavaScript。所有的 class 动画方法,包括 .toggleClass(),允许自定义动画持续时间和 easing 函数,在动画完成时也提供了一个回调。

并非所有的样式都可以进行动画添加。例如,对背景图像进行动画化。任何不能动画化的样式都将在动画结束时改变。

该插件扩展自 jQuery 内置的 .toggleClass() 方法。如果 jQuery UI 未加载,调用 .toggleClass() 方法不会直接失败,因为该方法在 jQuery 中存在。但是不会发生预期的行为。

实例

为匹配的元素切换 class "big-blue"。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.toggleClass() 演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <style>
  div {
    width: 100px;
    height: 100px;
    background-color: #ccc;
  }
  .big-blue {
    width: 200px;
    height: 200px;
    background-color: #00f;
  }
  </style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div></div>
 
<script>
$( "div" ).click(function() {
  $( this ).toggleClass( "big-blue", 1000, "easeOutSine" );
});
</script>
 
</body>
</html>

最后更新:

类似资料

  • 本文向大家介绍原生js实现addclass,removeclass,toggleclasss实例,包括了原生js实现addclass,removeclass,toggleclasss实例的使用技巧和注意事项,需要的朋友参考一下 jQuery操作class的方式非常强大,但是目前还有一些人不知道如何使用或者由于项目统一性的原因无法使用jquery. 在此写了一个利用原生js来实现对dom元素clas

  • 本文向大家介绍jQuery使用toggleClass方法动态添加删除Class样式的方法,包括了jQuery使用toggleClass方法动态添加删除Class样式的方法的使用技巧和注意事项,需要的朋友参考一下 本文实例讲述了jQuery使用toggleClass方法动态添加删除Class样式的方法。分享给大家供大家参考。具体分析如下: jQuery通过toggleClass方法动态添加删除Cla

  • 本文向大家介绍jQuery点击改变class并toggle及toggleClass()方法定义用法,包括了jQuery点击改变class并toggle及toggleClass()方法定义用法的使用技巧和注意事项,需要的朋友参考一下 我滴古老风格,废话不多说,贴代码了。 jQuery toggleClass() 方法 实例 对添加和移除所有 <p> 元素的 "main" 类进行切换: 定义和用法 t

  • 目前我的网站上有多个按钮,这些组件正在使用引导。当单击每个按钮时,会出现一个下拉列表,其优先级取决于用户选择的按钮。我试图找到一种方法来更新按钮类,以匹配所选的优先级。 例如,针对引导组件类的优先级: 高优先级是引导类:btn btn-危险btn-sm下拉切换 中等优先级是引导类:btn btn警告btn-sm下拉切换 低优先级是引导类:btn btn-成功btn-sm下拉切换 服务请求优先级为引

  • Selenium WebDriver:2.35。火狐: 25.0 我想将鼠标移到一个div上,这将使隐藏的图像变得可见,然后单击该图像。我读过这里,这里,这里和其他的帖子。一般的答案是采取以下形式: 但是,这在下面的示例中不起作用: html: Javascript/jquery: CSS: C#测试代码: 问题是没有触发click事件。此外,该元素保持可见,因此任何后续鼠标悬停都会将其隐藏。当然

  • 描述 (Description) 如果指定的类不存在,则toggleClass( class )方法添加指定的类,如果存在,则删除指定的类。 语法 (Syntax) 以下是使用此方法的简单语法 - <i>selector</i>.toggleClass( class ) 参数 (Parameters) 以下是此方法使用的所有参数的说明 - class - CSS类的名称。 例子 (Example