mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-08 15:04:05 +08:00
224 lines
20 KiB
HTML
224 lines
20 KiB
HTML
<article class="" id="post-">
|
|
<header class="entry-header">
|
|
<h1 class="entry-title">.addClass()</h1>
|
|
<div class="entry-meta">
|
|
所属分类:<span class="category"><a href="/category/attributes/">DOM 属性</a></span><span class="category-divider"> | </span><span class="category"><a href="/category/manipulation/">DOM 操作</a> > <a href="/category/manipulation/class-attribute/">class 属性</a></span><span class="category-divider"> | </span><span class="category"><a href="/category/css/">CSS</a></span>
|
|
<span class="pull-right">英文文档:<a href="https://api.jquery123.com/addClass/" target="_blank">.addClass()</a></span>
|
|
</div><!-- .entry-meta -->
|
|
</header><!-- .entry-header -->
|
|
<!-- .entry-header -->
|
|
<div class="entry-content">
|
|
<article class="entry method" id="addClass1"><h2 class="section-title">
|
|
<span class="name">.addClass( className )</span><span class="returns">返回: <a href="/Types/#jQuery">jQuery</a></span>
|
|
</h2>
|
|
<div class="entry-wrapper">
|
|
<p class="desc"><strong>描述: </strong>为每个匹配的元素添加指定的样式类名</p>
|
|
<ul class="signatures">
|
|
<li class="signature" id="addClass-className">
|
|
<h4 class="name">
|
|
<span class="version-details">添加的版本: <a href="/category/version/1.0/">1.0</a></span>.addClass( className )</h4>
|
|
<ul><li>
|
|
<div><strong>className</strong></div>
|
|
<div>类型: <a href="/Types/#String">String</a>
|
|
</div>
|
|
<div>为每个匹配元素所要增加的一个或多个样式名。</div>
|
|
</li></ul>
|
|
</li>
|
|
<li class="signature" id="addClass-functionindex--currentClass">
|
|
<h4 class="name">
|
|
<span class="version-details">添加的版本: <a href="/category/version/1.4/">1.4</a></span>.addClass( function(index, currentClass) )</h4>
|
|
<ul><li>
|
|
<div><strong>function(index, currentClass)</strong></div>
|
|
<div>类型: <a href="/Types/#Function">Function</a>()</div>
|
|
<div>
|
|
这个函数返回一个或更多用空格隔开的要增加的样式名。接收index 参数表示元素在匹配集合中的索引位置和html 参数表示元素上原来的 HTML 内容。在函数中<code>this</code>指向匹配元素集合中的当前元素。</div>
|
|
</li></ul>
|
|
</li>
|
|
</ul>
|
|
<div class="longdesc" id="entry-longdesc">
|
|
<p>
|
|
值得注意的是这个方法不会替换一个样式类名。它只是简单的添加一个样式类名到元素上。</p>
|
|
<p>对所有匹配的元素可以一次添加多个用空格隔开的样式类名, 像这样:</p>
|
|
<div class="syntaxhighlighter javascript nogutter">
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="gutter">
|
|
<div class="line n1">1</div>
|
|
</td>
|
|
<td class="code">
|
|
<pre><div class="container"><div class="line"><code>$(<span class="string">"p"</span>).addClass(<span class="string">"myClass yourClass"</span>);</code></div></div></pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>这个方法通常和<code>.removeClass()</code>一起使用,用来切换元素的样式, 像这样:</p>
|
|
<div class="syntaxhighlighter javascript nogutter">
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="gutter">
|
|
<div class="line n1">1</div>
|
|
</td>
|
|
<td class="code">
|
|
<pre><div class="container"><div class="line"><code>$(<span class="string">"p"</span>).removeClass(<span class="string">"myClass noClass"</span>).addClass(<span class="string">"yourClass"</span>);</code></div></div></pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>这里, <code>myClass</code> 和 <code>noClass</code> 样式名在所有段落上被移除, 然后 <code>yourClass</code> 被添加。</p>
|
|
<p>自 jQuery 1.4开始, <code>.addClass()</code> 方法允许我们通过传递一个用来设置样式类名的函数。</p>
|
|
<div class="syntaxhighlighter javascript nogutter">
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="gutter">
|
|
<div class="line n1">1</div>
|
|
<div class="line n2">2</div>
|
|
<div class="line n3">3</div>
|
|
</td>
|
|
<td class="code">
|
|
<pre><div class="container"><div class="line"><code>$(<span class="string">"ul li:last"</span>).addClass(<span class="keyword">function</span>(index) {</code></div></div><div class="container"><div class="line"><code> <span class="keyword">return</span> <span class="string">"item-"</span> + index;</code></div></div><div class="container"><div class="line"><code>});</code></div></div></pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>给定一个有2个<code><li></code>元素的无序列表,这个例子将在最后一个<code><li></code>元素上加上"item-1"样式。</p>
|
|
</div>
|
|
<section class="entry-examples" id="entry-examples"><header><h2 class="underline">例子:</h2></header><div class="entry-example" id="example-0">
|
|
<h4>Example: <span class="desc">在匹配的元素上加上'selected'样式。</span>
|
|
</h4>
|
|
<div class="syntaxhighlighter xml ">
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="gutter">
|
|
<div class="line n1">1</div>
|
|
<div class="line n2">2</div>
|
|
<div class="line n3">3</div>
|
|
<div class="line n4">4</div>
|
|
<div class="line n5">5</div>
|
|
<div class="line n6">6</div>
|
|
<div class="line n7">7</div>
|
|
<div class="line n8">8</div>
|
|
<div class="line n9">9</div>
|
|
<div class="line n10">10</div>
|
|
<div class="line n11">11</div>
|
|
<div class="line n12">12</div>
|
|
<div class="line n13">13</div>
|
|
<div class="line n14">14</div>
|
|
<div class="line n15">15</div>
|
|
<div class="line n16">16</div>
|
|
<div class="line n17">17</div>
|
|
<div class="line n18">18</div>
|
|
<div class="line n19">19</div>
|
|
<div class="line n20">20</div>
|
|
<div class="line n21">21</div>
|
|
<div class="line n22">22</div>
|
|
</td>
|
|
<td class="code">
|
|
<pre><div class="container"><div class="line"><code><span class="doctype"><!DOCTYPE html></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">html</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">style</span>></span><span class="css"></span></code></div></div><div class="container"><div class="line"><code> <span class="tag">p</span> <span class="rules">{ <span class="rule"><span class="attribute">margin</span>:<span class="value"> <span class="number">8</span>px;</span></span> <span class="rule"><span class="attribute">font-size</span>:<span class="value"><span class="number">16</span>px;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="class">.selected</span> <span class="rules">{ <span class="rule"><span class="attribute">color</span>:<span class="value">blue;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="class">.highlight</span> <span class="rules">{ <span class="rule"><span class="attribute">background</span>:<span class="value">yellow;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"></<span class="title">style</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">script</span> <span class="attribute">src</span>=<span class="value">"https://code.jquery.com/jquery-latest.js"</span>></span><span class="javascript"></span><span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">p</span>></span>Hello<span class="tag"></<span class="title">p</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">p</span>></span>and<span class="tag"></<span class="title">p</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">p</span>></span>Goodbye<span class="tag"></<span class="title">p</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">script</span>></span><span class="javascript"></span></code></div></div><div class="container"><div class="line"><code> $(<span class="string">"p"</span>).last().addClass(<span class="string">"selected"</span>);</code></div></div><div class="container"><div class="line"><code> <span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">html</span>></span></code></div></div></pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<h4>Demo:</h4>
|
|
<div class="demo code-demo"></div>
|
|
</div>
|
|
<div class="entry-example" id="example-1">
|
|
<h4>Example: <span class="desc">在匹配的元素上加上'selected'和 'highlight' 样式。</span>
|
|
</h4>
|
|
<div class="syntaxhighlighter xml ">
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="gutter">
|
|
<div class="line n1">1</div>
|
|
<div class="line n2">2</div>
|
|
<div class="line n3">3</div>
|
|
<div class="line n4">4</div>
|
|
<div class="line n5">5</div>
|
|
<div class="line n6">6</div>
|
|
<div class="line n7">7</div>
|
|
<div class="line n8">8</div>
|
|
<div class="line n9">9</div>
|
|
<div class="line n10">10</div>
|
|
<div class="line n11">11</div>
|
|
<div class="line n12">12</div>
|
|
<div class="line n13">13</div>
|
|
<div class="line n14">14</div>
|
|
<div class="line n15">15</div>
|
|
<div class="line n16">16</div>
|
|
<div class="line n17">17</div>
|
|
<div class="line n18">18</div>
|
|
<div class="line n19">19</div>
|
|
<div class="line n20">20</div>
|
|
</td>
|
|
<td class="code">
|
|
<pre><div class="container"><div class="line"><code><span class="doctype"><!DOCTYPE html></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">html</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">style</span>></span><span class="css"></span></code></div></div><div class="container"><div class="line"><code> <span class="tag">p</span> <span class="rules">{ <span class="rule"><span class="attribute">margin</span>:<span class="value"> <span class="number">8</span>px;</span></span> <span class="rule"><span class="attribute">font-size</span>:<span class="value"><span class="number">16</span>px;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="class">.selected</span> <span class="rules">{ <span class="rule"><span class="attribute">color</span>:<span class="value">red;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="class">.highlight</span> <span class="rules">{ <span class="rule"><span class="attribute">background</span>:<span class="value">yellow;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"></<span class="title">style</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">script</span> <span class="attribute">src</span>=<span class="value">"https://code.jquery.com/jquery-latest.js"</span>></span><span class="javascript"></span><span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">p</span>></span>Hello<span class="tag"></<span class="title">p</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">p</span>></span>and<span class="tag"></<span class="title">p</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">p</span>></span>Goodbye<span class="tag"></<span class="title">p</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">script</span>></span><span class="javascript"></span></code></div></div><div class="container"><div class="line"><code> $(<span class="string">"p:last"</span>).addClass(<span class="string">"selected highlight"</span>);</code></div></div><div class="container"><div class="line"><code> <span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">html</span>></span></code></div></div></pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<h4>Demo:</h4>
|
|
<div class="demo code-demo"></div>
|
|
</div>
|
|
<div class="entry-example" id="example-2">
|
|
<h4>Example: <span class="desc">Pass in a function to <code>.addClass()</code> to add the "green" class to a div that already has a "red" class.</span>
|
|
</h4>
|
|
<div class="syntaxhighlighter xml ">
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td class="gutter">
|
|
<div class="line n1">1</div>
|
|
<div class="line n2">2</div>
|
|
<div class="line n3">3</div>
|
|
<div class="line n4">4</div>
|
|
<div class="line n5">5</div>
|
|
<div class="line n6">6</div>
|
|
<div class="line n7">7</div>
|
|
<div class="line n8">8</div>
|
|
<div class="line n9">9</div>
|
|
<div class="line n10">10</div>
|
|
<div class="line n11">11</div>
|
|
<div class="line n12">12</div>
|
|
<div class="line n13">13</div>
|
|
<div class="line n14">14</div>
|
|
<div class="line n15">15</div>
|
|
<div class="line n16">16</div>
|
|
<div class="line n17">17</div>
|
|
<div class="line n18">18</div>
|
|
<div class="line n19">19</div>
|
|
<div class="line n20">20</div>
|
|
<div class="line n21">21</div>
|
|
<div class="line n22">22</div>
|
|
<div class="line n23">23</div>
|
|
<div class="line n24">24</div>
|
|
<div class="line n25">25</div>
|
|
<div class="line n26">26</div>
|
|
<div class="line n27">27</div>
|
|
<div class="line n28">28</div>
|
|
<div class="line n29">29</div>
|
|
<div class="line n30">30</div>
|
|
<div class="line n31">31</div>
|
|
<div class="line n32">32</div>
|
|
<div class="line n33">33</div>
|
|
</td>
|
|
<td class="code">
|
|
<pre><div class="container"><div class="line"><code><span class="doctype"><!DOCTYPE html></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">html</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">style</span>></span><span class="css"></span></code></div></div><div class="container"><div class="line"><code> <span class="tag">div</span> <span class="rules">{ <span class="rule"><span class="attribute">background</span>:<span class="value"> white;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="class">.red</span> <span class="rules">{ <span class="rule"><span class="attribute">background</span>:<span class="value"> red;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="class">.red</span><span class="class">.green</span> <span class="rules">{ <span class="rule"><span class="attribute">background</span>:<span class="value"> green;</span></span> <span class="rule">}</span></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"></<span class="title">style</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">script</span> <span class="attribute">src</span>=<span class="value">"https://code.jquery.com/jquery-latest.js"</span>></span><span class="javascript"></span><span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">head</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">div</span>></span>This div should be white<span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">div</span> <span class="attribute">class</span>=<span class="value">"red"</span>></span>This div will be green because it now has the "green" and "red" classes.</code></div></div><div class="container"><div class="line"><code> It would be red if the addClass function failed.<span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">div</span>></span>This div should be white<span class="tag"></<span class="title">div</span>></span></code></div></div><div class="container"><div class="line"><code> <span class="tag"><<span class="title">p</span>></span>There are zero green divs<span class="tag"></<span class="title">p</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"><<span class="title">script</span>></span><span class="javascript"></span></code></div></div><div class="container"><div class="line"><code> $(<span class="string">"div"</span>).addClass(<span class="keyword">function</span>(index, currentClass) {</code></div></div><div class="container"><div class="line"><code> <span class="keyword">var</span> addedClass;</code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code> <span class="keyword">if</span> ( currentClass === <span class="string">"red"</span> ) {</code></div></div><div class="container"><div class="line"><code> addedClass = <span class="string">"green"</span>;</code></div></div><div class="container"><div class="line"><code> $(<span class="string">"p"</span>).text(<span class="string">"There is one green div"</span>);</code></div></div><div class="container"><div class="line"><code> }</code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code> <span class="keyword">return</span> addedClass;</code></div></div><div class="container"><div class="line"><code> });</code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">script</span>></span></code></div></div><div class="container"><div class="line"><code> </code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">body</span>></span></code></div></div><div class="container"><div class="line"><code><span class="tag"></<span class="title">html</span>></span></code></div></div></pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<h4>Demo:</h4>
|
|
<div class="demo code-demo"></div>
|
|
</div></section>
|
|
</div></article> </div>
|
|
</article> |