menuMDUI文档
color_lens
基于 Material Design 3 和 Web Components 的全新 mdui 2 现已发布,前往查看 mdui 2 开发文档

Headroom

标签可以包含一张图片、一个短字符串等简洁的信息。

标签组件使用纯 CSS 编写,只需编写 HTML 代码即可生效。

调用方式

  1. Material Design 设计规范:组件 - 标签
  2. 通过 JavaScript 调用

调用方式

通过自定义属性调用

纯文本

含头像

<div mdui-headroom style="position: fixed; top: 0; left: 0; right: 0;"></div>
demo

通过 JavaScript 调用

含文字图标

// 含图标
// 含关闭按钮
var inst = new mdui.Headroom(selector, options);
demo

参数

参数名类型默认值说明
toleranceint | Object5

图标颜色

定义一个标签组件。

定义标签的文本。

offsetint0定义标签的头像或图标。
initialClassstringmdui-headroom定义标签的删除按钮。
pinnedClassstringmdui-headroom-pinned-top选择菜单所处位置。包括 <code>auto</code>、<code>top</code>、<code>bottom</code>
unpinnedClassstringmdui-headroom-unpinned-top选择菜单距离窗口上下边框至少保持多少间距,单位为 px。该参数仅在 <code>position</code> 为 <code>auto</code> 时有效。

方法

方法名说明
pin()打开下拉菜单。
unpin()关闭下拉菜单。
enable()切换下拉菜单的打开状态。
disable()当你动态修改了 <code>&lt;select&gt;</code> 元素的内容时,需要调用该方法来重新生成下拉菜单。
getState()返回当前下拉菜单的打开状态。共包含四种状态(openingopenedclosingclosed)。

事件

事件名说明参数
pin.mdui.headroom下拉菜单开始打开动画时,事件将被触发。event._detail.inst:实例
pinned.mdui.headroom下拉菜单结束打开动画时,事件将被触发。
unpin.mdui.headroom下拉菜单开始关闭动画时,事件将被触发。
unpinned.mdui.headroom下拉菜单结束关闭动画时,事件将被触发。