DIV CSS 佈局教程網

jQuery 三大內容讀寫方法完整解析:.html()、.text() 與 .val()
編輯:JQuery特效代碼     

jQuery 提供了很多操作元素內容的方法,但真正需要分清楚的只有三個:.html() 讀寫 HTML 結構、.text() 讀寫純文字、.val() 讀寫表單值。釐清「我到底是想改內容,還是想加一個元素」,是選對方法的前提。

.html():操作元素的 HTML 結構

有三種形式:.html()、.html(htmlString)、.html(function(index, html){...})。

1. 讀取:.html()

$("Element").html();

回傳值是字串。重點:若選擇器命中多個元素,只會讀取第一個,而且此法對 XML 文件無效。

<div class="demo">
  <p>這是一個段落元素,裡面包含了一個 a 鏈接元素<a href="#">W3CPLUS</a></p>
</div>
$(document).ready(function () {
  alert("Div.demo 中的 p 元素的 HTML 結構:" + $("div.demo p").html());
});

結果:

如果 demo 裡有兩個 p 呢?

<div class="demo">
  <p>我是 div.demo 中第一個 P 元素:<a href="#">我在第一個 P 裡面</a></p>
  <p>這是一個段落元素,裡面包含了一個 a 鏈接元素<a href="#">W3CPLUS</a></p>
</div>
$(document).ready(function () {
  alert("Div.demo 中的 p 元素的 HTML 結構:" + $("div.demo p").html());
});

效果:

同樣的程式碼、不同的結果,正好印證:選擇器命中多個元素時,只有第一個的 HTML 內容會被取出。

2. 取代:.html(htmlString)

$("Element").html(htmlString);

回傳 jQuery 物件。它會把匹配元素的原有內容完全換成新的 HTML 片段。

$(document).ready(function () {
  $("div.demo p").html('<h2 class="title">新加的標題</h2><p>我是 div.demo 中第一個 P 元素:<a href="#">我在第一個 P 裡面</a></p>');
});

效果:

注意這裡的行為轉折:讀取時只看第一個,寫入時卻會套用到所有匹配元素,而且每一個都被換成一模一樣的內容。

3. 用回呼函數差異化取代

$("Element").html(function (index, html) {...});

函數會收到兩個參數:目前元素的索引位置(從 0 起算)與它原本的 HTML 內容,回傳值就是新的內容。當你想讓多個元素各自換成不同內容時,這個形式最好用。

<div class="demo">
  <p><a href="#">我在第一個 P 裡面</a></p>
  <p><a href="#">W3CPLUS</a></p>
</div>
$(document).ready(function () {
  $("div.demo p").html(function (index, oldHtml) {
    return "我是段落" + (index + 1) + ":" + oldHtml;
  });
});

效果:

.text():只處理純文字

1. 讀取:.text()

$("Element").text();

它會把匹配元素集合中每一個元素(含後代)的文字串接起來,HTML 標籤一律剝除。與 .html() 不同,.text() 在 XML 文件上也能用。由於各家瀏覽器的 HTML 解析器差異,回傳結果中的換行與空白可能略有不同。

<div class="demo">
  <p><a href="#">W3CPLUS</a></p>
</div>
$(document).ready(function () {
  alert(".text() 讀取的內容:" + $("div.demo p").text());
});

效果:

這裡出現一個關鍵差異:.html() 命中多個只讀第一個,.text() 則會讀取全部並合併。

<div class="demo">
  <p><a href="#">W3CPLUS</a></p>
  <p>我是段落二:<a href="#">W3CPLUS</a></p>
</div>
$(document).ready(function () {
  alert(".text() 方法:" + $("div.demo p").text());
  alert(".html() 方法:" + $("div.demo p").html());
});

效果:

2. 取代:.text(textString)

$("Element").text(textString);

它與 .html(htmlString) 最大的差別在於:html 會把字串當標籤解析,text 則會把 < 與 > 轉成實體,當成純文字顯示。

$(document).ready(function () {
  $("div.demo p").text('<h2 class="title">新加的標題</h2><p>我是 div.demo 中第一個 P 元素</p>');
});

效果:

畫面上會直接看到那串標籤文字。相同之處是:命中多個元素時,一樣會全部換成相同內容。

3. 用回呼函數差異化取代

$("Element").text(function (index, text) {...});
$(document).ready(function () {
  $("div.demo p").text(function (index, oldText) {
    return (index + 1) + "." + oldText;
  });
});

效果:

.val():操作表單值

.html() 與 .text() 都無法作用在 input 上,這時才需要 .val()。

1. 讀取:.val()

$("Element").val();

回傳字串或陣列。作用在 <select multiple="multiple"> 上時,會回傳一個包含所有被選 option 的陣列。

<div id="colorRadio">
  <input type="radio" name="color" id="rd1" value="Red" />Red
  <input type="radio" name="color" id="rd2" value="Yello" />Yello
  <input type="radio" name="color" id="rd3" value="Blue" />Blue
</div>
<div id="sizeCheck">
  <input type="checkbox" name="size" id="ch1" value="10 pt" />10 pt
  <input type="checkbox" name="size" id="ch2" value="12 pt" />12 pt
  <input type="checkbox" name="size" id="ch3" value="14 pt" />14 pt
</div>
<input type="button" id="submitBtn" value="Get Value" />
$(document).ready(function () {
  $('#submitBtn').click(function () {
    alert($('#colorRadio input:radio').val());
    alert($('#sizeCheck input:checkbox').val());
  });
});

效果:

問題在這裡:.val() 只回傳集合中的第一個元素的值,跟使用者有沒有勾選完全無關。要拿到真正被選中的那一個,必須加上:checked:

$(document).ready(function () {
  $('#submitBtn').click(function () {
    alert($('input:radio[name=color]:checked').val());
    alert($('input:checkbox[name=size]:checked').val());
  });
});

單選鈕這樣就夠了,但核取方塊可能同時勾好幾個,此時 .val() 依然只給第一個,一個都沒勾時則回傳 undefined。要全部取出,得用 each() 遍歷:

$(document).ready(function () {
  $('#submitBtn').click(function () {
    alert($('input:radio[name=color]:checked').val());
    $('input:checkbox[name=size]:checked').each(function () {
      alert($(this).val());
    });
  });
});

而 select 也有兩種情況:用在單選 select 上回傳選中的值;用在 multiple 的 select 上回傳包含各選項的陣列。

<form action="" method="post">
  <select id="dropdown">
    <option>Red</option>
    <option>Yellow</option>
    <option>Blue</option>
  </select>
  <select id="listbox" multiple="multiple">
    <option>Red</option>
    <option>Yellow</option>
    <option>Blue</option>
  </select>
  <input type="button" id="getSelectValue" value="Get Value" />
</form>
$("#getSelectValue").click(function () {
  alert($("#dropdown").val());
  var colors = $("#listbox").val();
  for (var key in colors) {
    alert(colors[key]);
  }
});

2. 寫入:.val(value)

$("Element").val(value);

value 可以是字串,也可以是字串陣列(用於多選 select)。它會把所有匹配元素的值設成相同內容:

$("input").val("test");   // 把所有 input 的值都改成 test

實務上比較少這樣用,更常見的是搭配 focus 與 blur 做提示文字切換:

<input type="text" id="textBox" value="Hello,jQuery!" />
$("input:text").focus(function () {
  var val = $(this).val();
  if (val == this.defaultValue) {
    $(this).val("");
  }
});
$("input:text").blur(function () {
  var val = $(this).val();
  if (val == "") {
    $(this).val(this.defaultValue);
  }
});

3. 用回呼函數差異化寫入

$("Element").val(function (index, value) {...});
<form action="">
  <div id="colorRadio">
    <input type="radio" name="color" id="rd1" value="Red" /><span>Red</span>
    <input type="radio" name="color" id="rd2" value="Yellow" /><span>Yellow</span>
    <input type="radio" name="color" id="rd3" value="Blue" /><span>Blue</span>
  </div>
  <div id="sizeCheck">
    <input type="checkbox" name="size" id="ch1" value="10 pt" /><span>10 pt</span>
    <input type="checkbox" name="size" id="ch2" value="12 pt" /><span>12 pt</span>
    <input type="checkbox" name="size" id="ch3" value="14 pt" /><span>14 pt</span>
  </div>
  <input type="text" id="txtBox" disabled="disabled" />
  <input type="button" id="setValue" value="Set Value" />
</form>
$(document).ready(function () {
  $("input:radio[name=color]").val(function (index, oldVal) {
    return "color-" + (index + 1) + ":" + oldVal;
  });

  $("input:checkbox[name=size]").val(function (index, oldVal) {
    return "size-" + (index + 1) + ":" + oldVal;
  });

  $("#setValue").click(function () {
    var msg = $("input:radio[name=color]:checked").val() + ",";
    $("input:checkbox[name=size]:checked").each(function () {
      msg += $(this).val() + ",";
    });
    $("#txtBox").val(msg);
  });
});

多選下拉列表則用陣列指定:

$(document).ready(function () {
  $('#dropdown').val('Yellow');
  $('#listbox').val(['Red', 'Blue']);
});

.val() 的適用場合

  1. 讀取與設定 select 的選中項。
  2. 讀取多選 select 的值(會得到 option 陣列,但不能用 .val() 一次設定多值以外的形式)。
  3. 讀取 radio 與 checkbox 的值,或多選時搭配 each() 逐一取出。
  4. 用回呼函數動態改寫多個表單元素的 value。

三者總結與對照

  1. .html():讀寫元素的 HTML 標籤內容。
  2. .text():讀寫元素的純文字內容。
  3. .val():讀寫表單元素的 value。

功能上的差異可以整理成三點:

  1. 三者都能讀取選定元素的內容,但 .html() 含標籤、.text() 只有文字(含後代)、.val() 只對表單有效。.html() 與 .text() 不能用在表單元素上,.val() 也只能用在表單元素上。命中多個元素時,.html() 與 .val() 只讀第一個,.text() 則讀全部。
  2. 三者都能取代內容,且寫入時都會套用到所有匹配元素。
  3. 三者都支援回呼函數,可以依索引或原值做差異化處理。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved