jQuery 的核心設計只有一句話:先選中某個網頁元素,再對它做某種操作。這正是它與其他函式庫最根本的差異,整套 API 幾乎都圍繞這個模式展開。
把選擇表達式放進建構子 jQuery()(簡寫為 $),就能取得被選中的元素。
$(document) // 整個文件
$('#myId') // ID 為 myId 的元素
$('div.myClass') // class 為 myClass 的 div
$('input[name=first]') // name 等於 first 的 input
$('a:first') // 第一個 a 元素
$('tr:odd') // 表格奇數行
$('#myForm :input') // 表單中的 input
$('div:visible') // 可見的 div
$('div:gt(2)') // 除了前三個之外的所有 div
$('div:animated') // 正在跑動畫的 div$('div').has('p'); // 含 p 的 div
$('div').not('.myClass'); // class 不為 myClass 的 div
$('div').filter('.myClass'); // class 為 myClass 的 div
$('div').first(); // 第一個 div
$('div').eq(5); // 第六個 div也可以在 DOM 樹上移動到鄰近元素:
$('div').next('p'); // 後面第一個 p
$('div').parent(); // 父元素
$('div').closest('form'); // 最近的 form 祖先
$('div').children(); // 所有子元素
$('div').siblings(); // 所有同層元素因為每個 jQuery 方法都會回傳 jQuery 物件,所以可以串成一條:
$('div').find('h3').eq(2).html('Hello');拆開來看就是:找到 div → 選其中 h3 → 取第三個 → 把內容改成 Hello。若想用 .end() 退回上一步:
$('div')
.find('h3')
.eq(2)
.html('Hello')
.end() // 退回選中所有 h3 的那一步
.eq(0)
.html('World');jQuery 用同一個函式同時處理取值與賦值,差別只在有沒有傳參數:
$('h1').html(); // 取值
$('h1').html('Hello'); // 賦值常用的一組:.html()、.text()、.attr()、.width()、.height()、.val()。要注意:賦值時會作用於結果集中的所有元素;取值時只取第一個(.text() 例外,它會串起全部元素的文字)。
兩種視角,四組方法:
$('div').insertAfter('p'); // 把 div 移到 p 後面,回傳 div
$('p').after('div'); // 在 div 前插入 p,回傳 p
.insertAfter() / .after() 外部、後面插入
.insertBefore() / .before() 外部、前面插入
.appendTo() / .append() 內部、後面插入
.prependTo() / .prepend() 內部、前面插入兩種寫法視覺效果相同,但回傳的元素不同,可以依後續要串什麼来选择。
複製用 .clone();刪除用 .remove() 或 .detach(),前者連事件一起清掉,後者保留事件,適合稍後要重新插入的情況;只清空內容不刪元素則用 .empty()。建立新元素很簡單,直接把 HTML 字串丟進 $() 即可。
這類方法掛在 jQuery 建構子本身(jQuery.method()),不需要先選元素:
$.trim() 去除字串兩端空白
$.each() 遍歷陣列或物件
$.inArray() 回傳值在陣列中的索引,找不到回 -1
$.grep() 篩選符合條件的元素
$.extend() 合併物件
$.makeArray() 轉為陣列
$.type() 判斷型別
$.isArray() 是否為陣列
$.isEmptyObject() 是否為空物件
$.isFunction() 是否為函式
$.isPlainObject() 是否為 {} 或 new Object 建立
$.support() 瀏覽器是否支援某特性$('p').click(function(){ alert('Hello'); });常見事件包含 blur / change / click / dblclick / focus / focusin / focusout / hover / keydown / keypress / keyup / load / mousedown / mouseenter / mouseleave / mousemove / mouseout / mouseover / mouseup / ready / resize / scroll / select / submit / toggle / unload。
這些其實都是 .bind() 的便捷寫法。要一次綁多個事件:
$('input').bind('click change', function(){ alert('Hello'); });只想觸發一次用 .one(),解除綁定用 .unbind():
$("p").one("click", function(){ alert("只跑一次"); });
$('p').unbind('click');事件處理函式會收到一個 event 物件,常用成員有 pageX / pageY(滑鼠位置)、type(事件類型)、which(按下的鍵)、data、target,以及 preventDefault()(取消預設行為)與 stopPropagation()(阻止冒泡)。函式中用 this 可取得該 DOM 元素。要主動觸發事件,直接呼叫事件函式或用 .trigger()。
$('h1').show();淡入淡出與滑動:fadeIn / fadeOut / fadeTo / hide / show / slideDown / slideUp / slideToggle / toggle。除 show/hide 外,預設執行時間為 400ms,可自訂:
$('h1').fadeIn(300); // 300 毫秒淡入
$('h1').fadeOut('slow'); // 緩慢淡出動畫結束後要接續處理,把函式放在後面當回調:
$('p').fadeOut(300, function(){ $(this).remove(); });更複雜的效果用 .animate() 自訂屬性變化:
$('div').animate(
{ left: "+=50", opacity: 0.2 },
300,
function(){ alert('done!'); }
);另外 .stop() 與 .delay() 可以中止或延後動畫,$.fx.off = true 則能全域關閉所有效果——在正式環境中照顧使用者偏好減少動態的設定時很實用。