@duskmoon-dev/el-dialog

中文文档
1.10.3发布于 2026/11/11TypeScriptESM + CJS构建来源已验证近 30 天下载 2516

基于本地 HTML 的模式对话框自定义元素 <dialog> 元素,样式为 @duskmoon-dev/core. HTML Invoker 命令被转发到内部本地对话框.

中文使用文档
文档目录16 节
  1. 安装
  2. 使用量
  3. 自动注册
  4. 手工登记
  5. 大小
  6. 属性
  7. 方法
  8. 槽数
  9. CSS 组件
  10. 活动
  11. 实例
  12. 基本对话框
  13. 大小
  14. 不可开除
  15. 程序控制
  16. 许可证

@duskmoon-dev/el-dialog (日语)

基于本地 HTML 的模式对话框自定义元素 <dialog> 元素,样式为 @duskmoon-dev/core. HTML Invoker 命令被转发到内部本地对话框.

安装

bun add @duskmoon-dev/el-dialog

使用量

自动注册

import '@duskmoon-dev/el-dialog/register';
<button command="show-modal" commandfor="myDialog">Open Dialog</button>

<el-dm-dialog id="myDialog">
  <span slot="header">Dialog Title</span>
  <p>Dialog content goes here.</p>
  <div slot="footer">
    <el-dm-button variant="ghost">Cancel</el-dm-button>
    <el-dm-button variant="primary">Confirm</el-dm-button>
  </div>
</el-dm-dialog>

手工登记

import { ElDmDialog, register } from '@duskmoon-dev/el-dialog';

// Register with default tag name
register();

// Or register with custom tag name
customElements.define('my-dialog', ElDmDialog);

大小

大小说明
sm小对话框
md介质对话框( 默认)
lg大对话框
xl额外的大对话框
full全屏对话框

属性

属性类型默认说明
openbooleanfalse对话框是否打开
sizestring'md'大小 : sm, (中文(简体) ), md, (中文(简体) ), lg, (中文(简体) ), xl, (中文(简体) ), full
dismissiblebooleantrue允许通过背景/逃逸结束
no-dismissbooleanfalse防止因背景或逃逸而关闭
no-backdropbooleanfalse以非方式打开( O)show() 改为 showModal()(中文(简体) )

方法

方法说明
show()打开对话框作为模式
showModal()别名 show()
close()关闭对话框
toggle()切换对话框状态

槽数

槽说明
(默认)对话框内容
header对话框头/标题
footer包含动作的对话框页脚

CSS 组件

编说明
dialog当地人 <dialog> 元素
box内部 dialog-box 集装箱
header标题部分
title标题包
body机构部分
footer脚下部分
close关闭按钮

这个背景是本地人 ::backdrop 伪相. 给它 --color-scrim。 。 。 .

活动

活动细节说明
open- 说吧对话框打开时已开火
close- 说吧关闭对话框时已开火

实例

基本对话框

<el-dm-button onclick="document.querySelector('#dialog').show()">
  Open Dialog
</el-dm-button>

<el-dm-dialog id="dialog">
  <span slot="header">Confirmation</span>
  <p>Are you sure you want to proceed?</p>
  <div slot="footer">
    <el-dm-button variant="ghost" onclick="this.closest('el-dm-dialog').close()">
      Cancel
    </el-dm-button>
    <el-dm-button variant="primary">
      Confirm
    </el-dm-button>
  </div>
</el-dm-dialog>

大小

<el-dm-dialog size="sm">Small dialog</el-dm-dialog>
<el-dm-dialog size="md">Medium dialog</el-dm-dialog>
<el-dm-dialog size="lg">Large dialog</el-dm-dialog>
<el-dm-dialog size="xl">Extra large dialog</el-dm-dialog>
<el-dm-dialog size="full">Full-screen dialog</el-dm-dialog>

不可开除

<el-dm-dialog no-dismiss>
  <span slot="header">Required Action</span>
  <p>You must complete this action.</p>
  <div slot="footer">
    <el-dm-button variant="primary">Continue</el-dm-button>
  </div>
</el-dm-dialog>

程序控制

const dialog = document.querySelector('el-dm-dialog');

dialog.show();
dialog.close();

dialog.addEventListener('close', () => {
  console.log('Dialog closed');
});

许可证

麻省理工学院

版本与发布记录

@duskmoon-dev/el-dialog 共发布 51 个版本,首次发布于 2026/01/13;过去 12 个月发布了 51 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.10.3latest2026/11/112 天前
1.10.22026/10/2222 天前
1.10.12026/10/1627 天前
1.10.02026/10/1628 天前
1.9.32026/10/131 个月前
1.9.22026/10/131 个月前

关于 @duskmoon-dev/el-dialog 的常见问题

@duskmoon-dev/el-dialog 是什么?

基于本地 HTML 的模式对话框自定义元素 <dialog> 元素,样式为 @duskmoon-dev/core. HTML Invoker 命令被转发到内部本地对话框.

如何安装 @duskmoon-dev/el-dialog?

在项目目录运行 npm install @duskmoon-dev/el-dialog,或使用 pnpm add / yarn add / bun add。

@duskmoon-dev/el-dialog 支持 TypeScript 吗?

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

@duskmoon-dev/el-dialog 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@duskmoon-dev/el-dialog 可以商用吗?

@duskmoon-dev/el-dialog 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@duskmoon-dev/el-dialog 的下载量有多少?

根据 npm 官方下载统计,@duskmoon-dev/el-dialog 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,516 次,日均约 84 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@duskmoon-dev/el-dialog 还在维护吗?

最新版本 1.10.3 发布于 2026/11/11(2 天前);至今共发布 51 个版本,其中过去 12 个月发布了 51 个;首次发布于 2026/01/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。