這份筆記把 jQuery 常用 API 依功能分類整理,適合當作開發時的速查表。
| 選擇器 | 範例 | 選取內容 |
|---|---|---|
| * | $("*") | 所有元素 |
| #id | $("#lastname") | id 為 lastname 的元素 |
| .class | $(".intro") | class 為 intro 的元素 |
| element | $("p") | 所有 p 元素 |
| .class.class | $(".intro.demo") | 同時具備 intro 與 demo 的元素 |
| :first / :last | $("p:first") | 第一個/最後一個 p |
| :even / :odd | $("tr:even") | 偶數/奇數索引的 tr |
| :eq / :gt / :lt | $("ul li:gt(3)") | 索引等於/大於/小於指定值 |
| :not(selector) | $("input:not(:empty)") | 排除條件的元素 |
| :header | $(":header") | 所有 h1–h6 |
| :animated | $(":animated") | 正在執行動畫的元素 |
| :contains(text) | $(":contains('W3School')") | 包含指定文字的元素 |
| :empty / :hidden / :visible | $("p:hidden") | 無子節點/隱藏/可見的元素 |
| s1,s2,s3 | $("th,td,.intro") | 符合任一條件的元素 |
| [attribute] | $("[href]") | 帶有 href 屬性的元素 |
| [attribute=value] | $("[href='#']") | href 值等於 # 的元素 |
| [attribute!=value] | $("[href!='#']") | href 值不等於 # 的元素 |
| [attribute$=value] | $("[href$='.jpg']") | href 以 .jpg 結尾的元素 |
| :input | $(":input") | 所有 input、textarea、select、button |
| :text / :password / :radio / :checkbox | $(":checkbox") | 對應 type 的 input |
| :submit / :reset / :button / :image / :file | $(":file") | 對應 type 的 input |
| :enabled / :disabled | $(":disabled") | 啟用/停用的表單元素 |
| :selected / :checked | $(":checked") | 被選取/被勾選的元素 |
animate():套用自訂動畫。clearQueue()/queue()/dequeue()/delay():動畫佇列控制。fadeIn()/fadeOut()/fadeTo():淡入淡出。hide()/show()/toggle():顯示隱藏切換。slideDown()/slideUp()/slideToggle():以高度變化滑動。stop():停止目前執行的動畫。以下方法對 XML 與 HTML 文件都適用,唯一例外是 html()。
addClass()、removeClass()、toggleClass()、hasClass()html()、text()、val()、empty()append()、appendTo()、prepend()、prependTo()、after()、before()、insertAfter()、insertBefore()wrap()、wrapAll()、wrapInner()、unwrap()replaceWith()、replaceAll()、remove()、detach()、clone()attr()、removeAttr()css()、height()、width()、offset()、position()、offsetParent()、scrollTop()、scrollLeft()。
jQuery.ajax()、jQuery.get()、jQuery.post()、jQuery.getJSON()、jQuery.getScript()、.load()、jQuery.param()、.serialize()、.serializeArray()、jQuery.ajaxSetup()。
Ajax 事件則有 .ajaxStart()、.ajaxStop()、.ajaxComplete()、.ajaxSuccess()、.ajaxError()、.ajaxSend()。
.add()、.andSelf()、.children()、.closest()、.contents()、.each()、.end()、.eq()、.filter()、.find()、.first()、.last()、.has()、.is()、.map()、.next()、.nextAll()、.nextUntil()、.not()、.parent()、.parents()、.parentsUntil()、.prev()、.prevAll()、.prevUntil()、.siblings()、.slice()。
.data()、jQuery.data()、.removeData()、jQuery.removeData()、.queue()、jQuery.queue()、.dequeue()、.clearQueue()、jQuery.hasData()。
jQuery() 接受 CSS 選擇器字串並回傳元素集合;jQuery.noConflict() 則把 $ 的控制權讓給其他函式庫,避免衝突。
事件方法可以用來「觸發」事件,也可以用來「綁定」處理函式:
$("button#demo").click(); // 觸發
$("button#demo").click(function(){ $("img").hide() }); // 綁定
常用事件包含 bind()、unbind()、live()、die()、delegate()、undelegate()、one()、trigger()、triggerHandler()、ready()、blur()、focus()、change()、click()、dblclick()、submit()、select()、submit()、scroll()、resize()、load()、unload()、error(),以及 keydown/keypress/keyup、mousedown/mouseup/mousemove/mouseover/mouseout/mouseenter/mouseleave。
事件物件常用屬性:event.target(觸發的元素)、event.type(事件類型)、event.which(按下的鍵或按鈕)、event.pageX/pageY(相對於文件的滑鼠座標)、event.timeStamp、event.result,以及 event.preventDefault() 與 event.isDefaultPrevented()。
提醒:在 jQuery 1.7 之後,bind()/live()/delegate() 已被 on() 與 off() 取代,新專案建議直接採用 on()。