Parser 是 EasyUI 的底層引擎。當你把 class="easyui-panel" 這類標記寫進 HTML 時,真正負責讀取標籤屬性、建立元件實例並套用樣式的,就是這個解析器。理解它的運作方式,有助於釐清「為什麼元件沒有被初始化」這類常見問題。
$.parser.parse(); // 解析整個頁面
$.parser.parse('#cc'); // 只解析指定的節點
第二種寫法特別實用:當你以 Ajax 動態插入一段 HTML 片段,而該片段包含 easyui 元件時,只需對插入後的容器呼叫一次 parse,就能讓新元件正常運作。
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| $.parser.auto | boolean | 定義是否在 DOM 就緒後自動解析 easyui 元件。設為 false 時,必須手動呼叫 parse 方法。 | true |
在混用多個 JavaScript 框架、或希望完全掌控初始化時序的專案中,把 auto 關掉改為手動觸發,往往是更可控的做法。
| 名稱 | 參數 | 說明 |
|---|---|---|
| $.parser.onComplete | context | 解析作業全部完成後觸發,參數為被解析的上下文節點。 |
| 名稱 | 參數 | 說明 |
|---|---|---|
| $.parser.parse | context | 解析 context 範圍內的 easyui 元件;不傳參數時預設解析整個文件。 |