menuMDUI文件
color_lens
基於 Material Design 3 與 Web Components 的全新 mdui 2 現已發佈,前往查看 mdui 2 開發文件

JavaScript 全域方法

mdui.mutation()

在 mdui 中,部分元件需要在 DOM 載入完成後初始化。因此,動態產生的元件無法自動初始化。為此,mdui 提供了 mdui.mutation() 方法。

mdui.mutation()

呼叫此方法,將初始化頁面中所有尚未初始化的元件。

var html =
  '<select class="mdui-select" mdui-select>' +
  '  <option value="1">State 1</option>' +
  '  <option value="2">State 2</option>' +
  '  <option value="3">State 3</option>' +
  '</select>';

// 動態加入了一個 Select 元件,但由於是透過自訂屬性呼叫的,該元件無法自動初始化
$('body').append(html);

// 呼叫此方法,以初始化頁面中所有尚未初始化的元件
mdui.mutation();

mdui.mutation(selector, apiInit)

如果為 mdui.mutation() 方法傳入了兩個參數,則可用於初始化你自行編寫的元件。第一個參數為 CSS 選取器,第二個參數是初始化函式。

呼叫 mdui.mutation(selector, apiInit) 時,會將 CSS 選取器和初始化函式綁定,並執行 $(selector).each(apiInit) 來呼叫初始化函式。

等到下次呼叫 mdui.mutation() 時,若 CSS 選取器對應的元件尚未初始化,則會自動呼叫初始化函式。

$(selector).mutation()

如果需要初始化指定元素內的元件,可以呼叫 $(selector).mutation(),該方法會初始化 selector 及其子元素中尚未初始化的元件。