Skip to content

CDN 使用

v0.3.11 · Latest stable

生产环境建议固定版本号,不建议使用 @latest。当前 npm 包导出 ESM 入口和样式文件,仓库构建产物中也保留 UMD 文件用于传统页面集成。

jsDelivr(推荐)

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/sodialog.css">

<script type="module">
  import { openModal } from 'https://cdn.jsdelivr.net/npm/[email protected]/dist/sodialog.es.js'

  openModal({
    title: 'Hello',
    content: '<p>Loaded from jsDelivr.</p>',
  })
</script>

UNPKG(备用)

<link rel="stylesheet" href="https://unpkg.com/[email protected]/dist/sodialog.css">

<script type="module">
  import { pushMessage } from 'https://unpkg.com/[email protected]/dist/sodialog.es.js'

  pushMessage('success', 'Loaded from UNPKG.')
</script>

UMD / IIFE

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/sodialog.css">
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/sodialog.umd.js"></script>

文档示例版本

/components/ 下的可运行 HTML 示例使用共享 loader 解析 CDN 版本。默认值集中维护在 /components/sodialog-loader.js,也支持通过 URL 参数临时覆盖:

  • ?sodialogVersion=latest
  • ?sodialogVersion=0.3.10

这个能力用于验证或排查 CDN 版本差异;生产页面仍建议复制上方固定版本地址。

生产建议

  • 固定 patch 版本,避免 @latest 引入不可控变更。
  • 对受控页面可配置 SRI 与长期缓存。
  • CSP 如禁止外部脚本,应下载并自托管构建产物。

Released under the MIT License.