@github/details-menu-element

中文文档
1.0.13发布于 2022/10/26MITTypeScriptES Module零依赖近 30 天下载 18.3万

打开菜单

按钮.

中文使用文档
文档目录9 节
  1. 安装
  2. 使用量
  3. 脚本
  4. 标记
  5. 活动
  6. 推迟装载
  7. 浏览器支持
  8. 发展
  9. 许可证

< 细节- 菜单> 元素

菜单打开时带有"细节"按钮.

安装

$ npm install @github/details-menu-element

使用量

脚本

导入为模块 :

import '@github/details-menu-element'

带有脚本标签 :

<script type="module" src="./node_modules/@github/details-menu-element/dist/index.js">

标记

<details>
  <summary>Robots</summary>
  <details-menu role="menu">
    <button type="button" role="menuitem">Hubot</button>
    <button type="button" role="menuitem">Bender</button>
    <button type="button" role="menuitem">BB-8</button>
  </details-menu>
</details>

使用 data-menu-button 财务报告和审定财务报表 data-menu-button-text 以更新菜单项目激活时的按钮文本.

<details>
  <summary>Preferred robot: <span data-menu-button>None</span></summary>
  <details-menu role="menu">
    <button type="button" role="menuitem" data-menu-button-text>Hubot</button>
    <button type="button" role="menuitem" data-menu-button-text>Bender</button>
    <button type="button" role="menuitem" data-menu-button-text>BB-8</button>
  </details-menu>
</details>

使用 data-menu-button 财务报告和审定财务报表 data-menu-button-contents 在菜单项激活时更新按钮的 HTML 内容.

<details>
  <summary>Preferred robot: <span data-menu-button>None</span></summary>
  <details-menu role="menu">
    <button type="button" role="menuitem" data-menu-button-contents><img src="hubot.png"> Hubot</button>
    <button type="button" role="menuitem" data-menu-button-contents><img src="bender.png"> Bender</button>
    <button type="button" role="menuitem" data-menu-button-contents><img src="bb8.png"> BB-8</button>
  </details-menu>
</details>

使用 label[tabindex="0"][role=menuitemradio/menuitemcheckbox] 当处理收音机和复选框输入菜单项时。 检查输入元素的状态和标签会同步.

<details>
  <summary>Preferred robot</summary>
  <details-menu role="menu">
    <label tabindex="0" role="menuitemradio">
      <input type="radio" name="robot" value="Hubot"> Hubot
    </label>
    <label tabindex="0" role="menuitemradio">
      <input type="radio" name="robot" value="Bender"> Bender
    </label>
    <label tabindex="0" role="menuitemradio">
      <input type="radio" name="robot" value="BB-8"> BB-8
    </label>
  </details-menu>
</details>

活动

  • details-menu-select (可撤销) - 开火 <details-menu> 与 event.detail.relatedTarget 为要选择的项目.
  • details-menu-selected - 开火了 <details-menu> 与 event.detail.relatedTarget 中,在更新标签并关闭菜单后.

推迟装载

菜单内容可以通过嵌入从服务器中加载 <include-fragment> 键.

<details>
  <summary>Robots</summary>
  <details-menu src="/robots" preload>
    <include-fragment>Loading…</include-fragment>
  </details-menu>
</details>

这个 src 属性值被复制到 <include-fragment> 首个 时间 <details> 按钮是切换打开的,它开始服务器取取.

如果 preload 属性存在, 服务器抓取会从鼠标开始 徘徊在那边 <details> 按钮,因此内容可能在时间前加载 打开菜单.

浏览器支持

浏览器, 不本地 自定义元素支持 需要一个 多边填充。 。 。 .

  • 颜色
  • 火花
  • 萨法里
  • 微软边缘

发展

npm install
npm test

许可证

以麻省理工学院许可证分发。 详情见LICENSE.

版本与发布记录

@github/details-menu-element 共发布 33 个版本,首次发布于 2018/06/29;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.13latest2022/10/264 年前
1.0.122021/08/235 年前
1.0.112021/08/125 年前
1.0.102021/07/215 年前
1.0.92020/06/046 年前
1.0.82020/01/306 年前

关于 @github/details-menu-element 的常见问题

@github/details-menu-element 是什么?

打开菜单 按钮.

如何安装 @github/details-menu-element?

在项目目录运行 npm install @github/details-menu-element,或使用 pnpm add / yarn add / bun add。

@github/details-menu-element 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@github/details-menu-element 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@github/details-menu-element 可以商用吗?

@github/details-menu-element 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@github/details-menu-element 的下载量有多少?

根据 npm 官方下载统计,@github/details-menu-element 在 2026/10/17 – 2026/11/15 这 30 天内被下载 183,129 次,日均约 6,104 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@github/details-menu-element 还在维护吗?

最新版本 1.0.13 发布于 2022/10/26(4 年前);至今共发布 33 个版本,其中过去 12 个月发布了 0 个;首次发布于 2018/06/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。