.addClass()

.addClass( className ) 返回: jQuery

描述: 为每个匹配的元素添加指定的类名

  • version added: 1.0.addClass( className )

    className为每个匹配元素所要增加的一个或多个样式名。

  • version added: 1.4.addClass( function(index, class) )

    function(index, class)这个函数返回一个或更多用空格隔开的要增加的样式名。接收元素的索引位置和元素旧的样式名作为参数。

值得注意的是这个方法不会替换一个样式类名。它只是简单的添加一个样式类名到可能已经指定的元素上。

对所有匹配的元素可以同时添加不只一个的用空格隔开的样式类名, 像这样:

$('p').addClass('myClass yourClass');

这个方法通常和.removeClass()一起使用用来切换元素的样式, 像这样:

$('p').removeClass('myClass noClass').addClass('yourClass');

这里, myClassnoClass 样式名在所有段落上被移除, 然后 yourClass 被添加。

自 jQuery 1.4开始, .addClass() 方法允许我们通过函数传递来设置样式名。

$('ul li:last').addClass(function() {
  return 'item-' + $(this).index();
});

给定一个有5个<li>元素的无序列表,这个例子将在最后一个<li>元素上加上"item-4"样式。

举例:

例子: 在匹配的元素上加上'selected'样式。

<!DOCTYPE html>
<html>
<head>
  <style>

  p { margin: 8px; font-size:16px; }
  .selected { color:blue; }
  .highlight { background:yellow; }
  </style>
  <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script>
</head>
<body>
	<p>Hello</p>
  <p>and</p>
  <p>Goodbye</p>
<script>$("p:last").addClass("selected");</script>
</body>
</html>

Demo:

例子: 在匹配的元素上加上'selected'和 'highlight' 样式。

<!DOCTYPE html>
<html>
<head>
  <style>

  p { margin: 8px; font-size:16px; }
  .selected { color:red; }
  .highlight { background:yellow; }
  </style>
  <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script>
</head>
<body>
	<p>Hello</p>
  <p>and</p>
  <p>Goodbye</p>
<script>$("p:last").addClass("selected highlight");</script>
</body>
</html>

Demo:

jQuery 1.6 API 中文版Clove整理、修订