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

從 0.4.3 升級到 1.0.0

mdui.$ 更新

在 0.4.3 中它叫 mdui.JQ,在 1.0.0 中更名為 mdui.$

如此更改後,在 ES6 模組化環境中,你可以使用以下方式導入 mdui.$,使用起來更加方便。

import { $ } from 'mdui';

mdui.$ 中還對多個方法的功能進行了擴充,這裡不再敘述。下面僅列出與 0.4.3 不相容的更新部分。

.width()、.height()、.innerWidth()、.innerHeight() 變更

在 0.4.3 中,是否包含內邊距取決於 box-sizing 屬性的值。

在 1.0.0 中,寬度和高度與 box-sizing 屬性無關。修改後與 jQuery 保持一致。

.offset()、.position() 變更

在 0.4.3 中,回傳值格式為 { top: number, left: number, width: number, height: number }

在 1.0.0 中,回傳值格式改為 { top: number, left: number }。修改後與 jQuery 保持一致。

.children()、.parent()、.parents()、.prev()、.prevAll()、.next()、.nextAll()、.siblings() 變更

在 0.4.3 中,參數可以是 CSS 選取器、DOM 元素、陣列等多種類型。

在 1.0.0 中,參數只能是 CSS 選取器類型。修改後與 jQuery 保持一致。

.has() 變更

在 0.4.3 中,參數可以是 CSS 選取器、DOM 元素、陣列等多種類型。

在 1.0.0 中,參數只能是 CSS 選取器或 DOM 元素。修改後與 jQuery 保持一致。

.ready() 移除

在 0.4.3 中,可以使用 $(document).ready(function () {}) 來呼叫 DOM 載入完畢需要執行的函式。

在 1.0.0 中,請將其替換為 $(function () {})

.ajax() 變更

在 0.4.3 中,.ajax() 方法的回傳值為 XMLHttpRequest 物件。且支援發送 jsonp 請求。

在 1.0.0 中,回傳值改為了 Promise。且該方法不再支援 jsonp 請求。