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 请求。