jQuery 核心函數 $() / jQuery() 接受原生 DOM 元素、NodeList、HTML 字符串、選擇器字符串等,返回 jQuery 實例 (類數組對象),封裝了豐富的 DOM 操作方法。
| 輸入類型 | 代碼示例 | 返回值 | 用途 |
|---|---|---|---|
| 單個 DOM 元素 | $(document.getElementById('myId')) |
jQuery 對象 (length=1) | 獲取特定元素操作 |
| NodeList / HTMLCollection | $(document.getElementsByTagName('a')) |
jQuery 對象 (length=N) | 批量操作同類元素 |
| 元素數組 | $([elem1, elem2, elem3]) |
jQuery 對象 | 合併離散元素操作 |
| this (事件處理器中) | $(this) |
jQuery 對象 | 事件委託中獲取目標元素 |
| window / document | $(window), $(document) |
jQuery 對象 | 綁定全局事件、獲取視口尺寸 |
// 原生獲取
const links = document.getElementsByTagName('a');
// 轉換為 jQuery 對象並遍歷
$(links).each(function() {
// this 是原生 DOM 元素
// $(this) 是 jQuery 對象
if ($(this).text() === 'jquerys') {
$(this).addClass('navTitle').attr('target', '_blank');
}
});
// 等價於直接選擇器 (更推薦)
$('a').each(function() {
if ($(this).text() === 'jquerys') {
$(this).addClass('navTitle').attr('target', '_blank');
}
});
const form = document.getElementById('myForm');
// 獲取所有表單控件
const controls = form.elements; // HTMLFormControlsCollection
// 轉換為 jQuery 對象批量操作
$(controls).filter('input, select, textarea').each(function() {
const $el = $(this);
if ($el.is('[required]')) {
$el.on('blur', validateField);
}
});
// 某插件返回原生元素
const picker = flatpickr('#dateInput')[0]; // 原生 input 元素
// 包裝為 jQuery 使用 jQuery 方法
$(picker).on('change', function() {
$(this).valid(); // 觸發 jQuery Validate
}).addClass('has-datepicker');
const $div = $('#myDiv');
// jQuery -> 原生 DOM (兩種方式)
const div1 = $div[0]; // 索引訪問
const div2 = $div.get(0); // .get() 方法
const allDivs = $div.get(); // 獲取純數組 []
// 原生 -> jQuery
const nativeDiv = document.getElementById('myDiv');
const $native = $(nativeDiv);
// 判斷是否為 jQuery 對象
$div instanceof jQuery; // true
nativeDiv instanceof jQuery; // false
$div.jquery; // "3.6.0" 版本號屬性
$('#id') 比 $(document.getElementById('id')) 更簡潔,內部優化相同const $el = $('#id')$($('.class')) 無意義開銷el.classList.add('x') 比 $(el).addClass('x') 快數倍JQuery<HTMLElement> 提供完整類型提示
// 簡化版 jQuery 構造邏輯
function jQuery(selector, context) {
return new jQuery.fn.init(selector, context);
}
jQuery.fn.init = function(selector, context) {
// 1. 無參數 / 空字符串 / null / undefined -> 空 jQuery 對象
if (!selector) return this;
// 2. DOM 元素 / window / document -> 直接包裝
if (selector.nodeType || selector === window) {
this[0] = selector;
this.length = 1;
return this;
}
// 3. 字符串選擇器 -> Sizzle 引擎查找
if (typeof selector === 'string') {
// ... 複雜選擇器解析邏輯
return this;
}
// 4. 函數 -> DOMReady 綁定
if (typeof selector === 'function') {
return jQuery(document).ready(selector);
}
// 5. 類數組 / 可迭代對象 -> makeArray
return this.constructor(jQuery.makeArray(selector));
};