@github/clipboard-copy-element

中文文档
1.3.2发布于 2026/06/17MITTypeScriptES Module零依赖近 30 天下载 16.4万

Copy element text content or input values to the clipboard.

原始使用文档
文档目录13 节
  1. Installation
  2. Usage
  3. Script
  4. Markup
  5. Data sources
  6. Attribute
  7. Element content
  8. Form input
  9. Hyperlink href
  10. Events
  11. Browser support
  12. Development
  13. License

<clipboard-copy> element

Copy element text content or input values to the clipboard.

Installation

$ npm install --save @github/clipboard-copy-element

Usage

Script

Import as ES modules:

import '@github/clipboard-copy-element'

With a script tag:

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

Markup

<clipboard-copy for="blob-path" class="btn btn-sm BtnGroup-item">
  Copy path
</clipboard-copy>
<div id="blob-path">src/index.js</div>

Data sources

Attribute

<clipboard-copy value="src/index.js">Copy</clipboard-copy>

Element content

<clipboard-copy for="blob-path">Copy</clipboard-copy>
<div id="blob-path">src/index.js</div>

Form input

<clipboard-copy for="blob-path">Copy</clipboard-copy>
<input id="blob-path" value="src/index.js">
<clipboard-copy for="blob-path">Copy full URL</clipboard-copy>
<a id="blob-path" href="/path/to#my-blob">Link text will not be copied</a>

Events

After copying to the clipboard, a clipboard-copy event is dispatched from the <clipboard-copy> element:

document.addEventListener('clipboard-copy', function(event) {
  const button = event.target
  button.classList.add('highlight')
})

Browser support

Browsers without native custom element support require a polyfill.

  • Chrome
  • Firefox
  • Safari
  • Microsoft Edge

Development

npm install
npm test

License

Distributed under the MIT license. See LICENSE for details.

版本与发布记录

@github/clipboard-copy-element 共发布 14 个版本,首次发布于 2019/05/23;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.3.2latest2026/06/174 个月前
1.3.12026/06/165 个月前
1.3.02023/09/293 年前
1.2.12023/06/083 年前
1.1.22020/01/216 年前
1.1.12019/11/077 年前

关于 @github/clipboard-copy-element 的常见问题

@github/clipboard-copy-element 是什么?

Copy element text content or input values to the clipboard.

如何安装 @github/clipboard-copy-element?

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

@github/clipboard-copy-element 支持 TypeScript 吗?

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

@github/clipboard-copy-element 支持 ESM 还是 CommonJS?

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

@github/clipboard-copy-element 可以商用吗?

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

@github/clipboard-copy-element 的下载量有多少?

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

@github/clipboard-copy-element 还在维护吗?

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