【jQuery】テキストをクリップボードにコピーする方法のあれこれ

クリップボードにコピーする。
簡単かなと思ったけど、とても難しかったです。
ブラウザによって全然挙動が違うことに驚きました。
いろいろ試してみた結果をまとめています。

デザオ
アドレスをコピーできたらいいなとか、たまにですが
デザコト
あ、わかります

【あれこれ①】ボタンをクリックしてIDをクリップボードにコピーする

コードを見る(HTML・CSS・JavaScript)

HTML

<div class="box_area">
  <p>IDは<span id="idNumber">a1234</span>です。</p>
  <button type="button" id="copyBtn">IDをコピーする</button>
</div>

CSS

.box_area {
  border: 2px solid #2b2a27;
  padding: 30px;
}
.box_area p {
  font-size: 18px;
  font-weight: bold;
  margin: 0 0 20px;
}
.box_area p span {
  background: #e8dc6a;
  padding: 0 7px;
}
.box_area button {
  font-size: 14px;
  font-weight: bold;
  text-align: center;
  text-decoration: none;
  color: #2b2a27;
  background: #fff;
  box-sizing: border-box;
  -webkit-appearance: none;
  -webkit-border-radius: 0;
  border-radius: 0;
  transition-duration: 0.2s;
  cursor: pointer;
  border: 2px solid #2b2a27;
  padding: 5px 12px;
}
.box_area button:hover {
  color: #fff;
  background: #2b2a27;
}
@media (prefers-reduced-motion: reduce) {
  * { transition: none !important; animation: none !important; }
}

JavaScript

var button = document.getElementById('copyBtn');
button.addEventListener('click', function () {
  // コピー対象を変数として定義する
  var idNumber = document.getElementById('idNumber');
  var range = document.createRange();
  range.selectNode(idNumber);
  // 前の選択を外してから選ぶ(2 回目からコピーできないことがある)
  var selection = window.getSelection();
  selection.removeAllRanges();
  selection.addRange(range);
  // IDをクリップボードにコピーする
  document.execCommand('copy');
  selection.removeAllRanges();
  // コピー完了をお知らせする
  alert('IDをコピーしました');
});
ブラウザコピーできる?
IE〇
Edge〇
Firefox〇
Chrome〇
Safari〇
iOS Safari〇
Android△(機種によってできたりできなかったり)

【あれこれ②】テキストをクリックしてクリップボードにコピーする

コードを見る(HTML・CSS・JavaScript)

HTML

<div class="txt_copy"><span id="copyText">テキストをコピー</span><button type="button" id="copyButton" class="button" aria-label="テキストをコピー"></button></div>

CSS

.txt_copy {
  color: #2b2a27;
  font-size: 16px;
  font-weight: bold;
  text-align: center;
  text-decoration: none;
  cursor: pointer;
  width: 260px;
  background: #fff;
  border: 2px solid #2b2a27;
  padding: 12px 15px;
  box-sizing: border-box;
  -webkit-appearance: none;
  -webkit-border-radius: 0;
  border-radius: 0;
  position: relative;
}
.txt_copy .button {
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  opacity: 0;
  width: 100%;
  height: 100%;
  background: #fff;
  padding: 0;
  margin: 0;
  border: none;
  cursor: pointer;
}

JavaScript

var button = document.getElementById('copyButton');
button.addEventListener('click', function () {
  var copyText = document.getElementById('copyText');
  var range = document.createRange();
  range.selectNode(copyText);
  // 前の選択を外してから選ぶ(2 回目からコピーできないことがある)
  var selection = window.getSelection();
  selection.removeAllRanges();
  selection.addRange(range);
  document.execCommand('copy');
  selection.removeAllRanges();
  alert('コピーしました');
});
ブラウザコピーできる?
IE〇
Edge複数は×(リロードすればコピーはできるが)
Firefox〇
Chrome〇
Safari〇
iOS Safari〇
Android△(機種によってできたりできなかったり)

【あれこれ③】テキストをクリックしてクリップボードにコピーする、別パターン

コードを見る(HTML・CSS・JavaScript)

HTML

<input id="copyTarget" type="text" value="テキストをコピー" readonly>

CSS

#copyTarget {
  font-size: 16px;
  font-weight: bold;
  text-align: center;
  text-decoration: none;
  color: #2b2a27;
  background: #fff;
  box-sizing: border-box;
  -webkit-appearance: none;
  -webkit-border-radius: 0;
  border-radius: 0;
  border: 2px solid #2b2a27;
  padding: 12px 15px;
  cursor: pointer;
  transition-duration: 0.2s;
}
#copyTarget:focus-visible {
  outline: 2px solid #e8dc6a;
  outline-offset: 2px;
}

JavaScript

var copyTarget = document.getElementById('copyTarget');
copyTarget.addEventListener('click', function () {
  // コピー対象のテキストを選択する
  copyTarget.select();
  // 選択しているテキストをクリップボードにコピーする
  document.execCommand('copy');
  // コピーをお知らせする
  alert('「' + copyTarget.value + '」をコピーしました');
});
ブラウザコピーできる?
IE〇
Edge〇
Firefox〇
Chrome〇
Safari〇
iOS Safari複数は×(リロードすればコピーはできるが)
Android〇

【あれこれ④】clipboard.jsを使ってIDとパスワードをクリップボードにコピーする

ファイルをダウンロードする場合は、GitHubから「clipboard.min.js」ファイルをダウンロードする。
CDNを使う場合は、こちらを参照。

コードを見る(HTML・CSS・JavaScript)

HTML

<div class="box_area">
  <p>IDは<span class="copyValue" data-clipboard-text="a1234">a1234</span>です。</p>
  <p>パスワードは<span class="copyValue" data-clipboard-text="abcd">abcd</span>です。</p>
</div>

CSS

.box_area {
  border: 3px solid #2b2a27;
  padding: 30px;
}
.box_area p {
  font-size: 18px;
  font-weight: bold;
  margin: 0;
}
.copyValue {
  background: #e8dc6a;
  padding: 0 7px;
  cursor: pointer;
  position: relative;
  transition-duration: 0.2s;
}
.copyValue:hover {
  color: #fff;
  background: #2b2a27;
}
.copied:before {
  content: "";
  width: 0;
  height: 0;
  border-style: solid;
  border-width: 0 6px 14px 6px;
  border-color: transparent transparent #2b2a27 transparent;
  position: absolute;
  left: 50%;
  top: 100%;
  transform: translate(-50%, 0);
  margin-right: 7px;
  animation: animation-copied 1s 2s 1 forwards;
  z-index: +1;
}
.copied:after {
  content: 'Copied!';
  background: #2b2a27;
  display: flex;
  justify-content: center;
  align-items: center;
  width: 50px;
  height: 50px;
  color: #fff;
  border-radius: 50%;
  position: absolute;
  left: 50%;
  top: 100%;
  transform: translate(-50%, 0);
  font-size: .8rem;
  padding: 10px;
  animation: animation-copied 1s 2s 1 forwards;
  z-index: +1;
  margin-top: 10px;
}
@keyframes animation-copied {
  to { opacity: 0; }
}
@media (prefers-reduced-motion: reduce) {
  .copyValue { transition: none; }
}

clipboard.js

<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.11/clipboard.min.js"></script>

JavaScript

const clipboard = new ClipboardJS('.copyValue');
// コピー値の項目をすべて選択
const btns = document.querySelectorAll('.copyValue');
// マウスを外すと.copiedクラスを削除
for (let i = 0; i < btns.length; i++) {
  btns[i].addEventListener('mouseleave', clearTooltip);
}
function clearTooltip(e) {
  e.currentTarget.classList.remove('copied');
}
// クリックしたときに.copiedクラスを追加する
function showTooltip(elem) {
  elem.classList.add('copied');
}
clipboard.on('success', function (e) {
  showTooltip(e.trigger);
});
ブラウザコピーできる?
IE〇
Edge〇
Firefox〇
Chrome〇
Safari〇
iOS Safari〇
Android〇

いまの書き方

この記事を書いたあと、クリップボードに書きこむしくみがブラウザに入りました。『navigator.clipboard.writeText()』を使うと、テキストを選ばなくても、ライブラリなしでコピーできます。上の①〜③で使っている『document.execCommand(‘copy’)』は、いまは非推奨(これからは使わないでね、という扱い)です。
IE はサポートが終わり、Edge も Chrome と同じしくみになったので、上の表のようなブラウザごとのちがいも、いまはほとんどありません。

コードを見る(HTML・CSS・JavaScript)

HTML

<div class="box_area">
  <p>IDは<span id="idNow">a1234</span>です。</p>
  <p>パスワードは<span id="passNow">abcd</span>です。</p>
  <div class="copy_buttons">
    <button type="button" class="copy_now" data-target="idNow">IDをコピー</button>
    <button type="button" class="copy_now" data-target="passNow">パスワードをコピー</button>
  </div>
  <p class="copy_status" role="status"></p>
</div>

CSS

.box_area {
  border: 2px solid #2b2a27;
  padding: 30px;
}
.box_area p {
  font-size: 18px;
  font-weight: bold;
  margin: 0 0 10px;
}
.box_area p span {
  background: #e8dc6a;
  padding: 0 7px;
}
.copy_buttons {
  display: flex;
  flex-wrap: wrap;
  gap: 10px;
  margin: 20px 0 0;
}
.copy_now {
  font-size: 14px;
  font-weight: bold;
  color: #2b2a27;
  background: #fff;
  border: 2px solid #2b2a27;
  border-radius: 0;
  padding: 5px 12px;
  cursor: pointer;
  transition-duration: 0.2s;
}
.copy_now:hover {
  color: #fff;
  background: #2b2a27;
}
.box_area .copy_status {
  min-height: 1.8em;
  font-size: 14px;
  color: #6b675f;
  margin: 12px 0 0;
}
@media (prefers-reduced-motion: reduce) {
  .copy_now { transition: none; }
}

JavaScript

document.querySelectorAll('.copy_now').forEach(function (button) {
  button.addEventListener('click', async function () {
    var text = document.getElementById(button.dataset.target).textContent;
    var status = button.closest('.box_area').querySelector('.copy_status');
    try {
      // クリップボードに書きこむ(https のページで、クリックしたときに動きます)
      await navigator.clipboard.writeText(text);
      status.textContent = '「' + text + '」をコピーしました';
    } catch (e) {
      status.textContent = 'コピーできませんでした';
    }
  });
});

どれを使う?

  • いま作るなら → navigator.clipboard.writeText()(ライブラリはいらない)
  • すでに clipboard.js を使っている → そのままでも動きます(中では execCommand を使っています)

navigator.clipboard は、https のページで、クリックなどの操作をしたときに動きます(http のページでは使えません)。コピーしたことは alert ではなく、role=”status” を付けた文字で知らせると、画面の読み上げにも伝わります。

どれがいいのか

【あれこれ④】を使うのがいい。古いバージョンだと厳しかったりもすると思いますが。
個人的には、PCではわざわざ使う必要はないのかなと。スマートフォンで問題なく使えればいいのかなと。

(追記)いまなら、上の「いまの書き方」の navigator.clipboard がいちばんです。ライブラリもいりません。

さいごに

デザオ
かわいいのがいいですね
デザコト
パンおいしそうですね

ふたりの小言

ほかの見本は、みほんちょうに。

デザコトauthor

あ、いいな、と思うWebデザインを紹介しています。デザインの参考に。やさしいデザインが多いです。Webデザインギャラリー『デザインのこと - Web design gallery』を運営しています。