CSSのuser-selectで、コードを1クリックで全選択する方法

​​CSS​HTML,Playwright

コードの要素に user-select: all を指定すると、文字の上を1回クリックしただけで、コード全体が選択されます。反対に user-select: none を指定した部分は、ドラッグしても選択に入りません。ブログや技術ドキュメントでコマンド例をコピーしてもらうとき、全体を一度で選べるようにしたり、プロンプトの「$」や行番号がコピーに混ざらないようにしたりできます。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、Chromium 153 です。ページを Playwright で開き、マウスのクリックやドラッグを送ってから、選択された文字は getSelection().toString() で、コピーされた文字は Ctrl+C のあとに navigator.clipboard.readText() で読み取りました。Firefox と Safari、スマートフォンの実機(長押しでの選択)は試していません。各ブラウザの対応バージョンは、互換性データ(@mdn/browser-compat-data 8.1.8)の値です。

上下2つのコマンド例。カーソルが上の「指定なし」のコマンドをクリックすると、下の欄に「選択された文字:(なし)」と出る。次に下の「user-select: all」のコマンドをクリックすると、コマンド全体が青く選択され、「選択された文字:「npm install example-package」」と出る
指定なしのコードと、user-select: all のコードを1回ずつクリックしたところ

クリック1回でコード全体を選択させる

コマンド例の <code> に、user-select の all を指定します。

html
<pre><code class="copy-all">npm install example-package</code></pre>
css
.copy-all {
  -webkit-user-select: all; /* Safari */
  user-select: all;
}

検証環境で、指定なしの <code> の文字の上を1回クリックしても、何も選択されませんでした。ダブルクリックでは example の1語だけ、トリプルクリックでは行全体が選択されました。

user-select: all を指定した <code> では、文字のどこを1回クリックしても npm install example-package 全体が選択され、続けて Ctrl+C を押すと、同じ文字列がコピーされました。

MDN の説明では、all を指定した要素の中身は、ひとまとまりとして選択されます。一部だけを選ぼうとしても、要素全体が選択に入ります。検証環境でも、次のようになりました。

  • コードの中で install の部分だけをドラッグすると、コード全体が選択された
  • コードの上の段落の終わりあたりから、コードの途中までドラッグすると、コードは最後まで選択に入った
  • all の要素の中にある <span> をクリックすると、<span> だけでなく、all を指定した要素全体が選択された

選択された状態で、もう一度クリックすると、選択は消えました。3回目のクリックで、また全体が選択されました。

また、<pre> の中でも、文字のない右側の余白をクリックしたときは、何も選択されませんでした。user-select: all を指定したのは <code> で、余白は <pre> の部分だからです。クリックで選ばれるのは、all を指定した要素の上だけです。

プロンプトの「$」や行番号を、コピーに入れない

コマンド例の先頭の $ や、コードの行番号は、見た目には必要でも、コピーした文字には入れたくありません。この部分を <span> で囲み、user-select: none を指定します。

html
<pre><code><span class="prompt">$ </span>npm install example-package
<span class="prompt">$ </span>npm run build</code></pre>

<pre><code><span class="line-no">1</span>const a = 1;
<span class="line-no">2</span>console.log(a);</code></pre>
css
.prompt,
.line-no {
  -webkit-user-select: none; /* Safari */
  user-select: none;
}
上下2つの画面。上の「プロンプトに user-select: none」では、2行のコマンドのうち「$」以外が青く選択され、コピーされた文字は「npm install example-package」と「npm run build」の2行。下の「指定なし」では、2行目の「$」も青く選択され、コピーされた文字の2行目は「$ npm run build」になっている
1行目の npm の先頭から、2行目の最後までドラッグして Ctrl+C を押したところ。上は「$」に user-select: none を指定、下は指定なし

検証環境で、1行目の npm の先頭から2行目の最後までドラッグし、Ctrl+C でコピーしました。user-select: none があると、コピーされた文字は次のとおりで、2行目の $ が入りませんでした。

text
npm install example-package
npm run build

user-select: none を外して同じ操作をすると、2行目は $ npm run build になりました。行番号のほうも、指定がないと 2console.log(a); のように行番号がつながってコピーされ、指定すると console.log(a); だけになりました。上の段落からコードの下までまとめてドラッグしたときと、Ctrl+A でページ全体を選んだときも、$ と行番号はコピーに入りませんでした。

ひとつ気をつけたいのは、user-select: none の部分からドラッグを始めたときです。検証環境で、行頭の $ や行番号の上からドラッグを始めると、何も選択されませんでした。CSS の仕様(CSS Basic User Interface Level 4)でも、none の要素の中では選択を始められないと決められています。コマンドを選ぶときは、$ の右にあるコマンドの最初の文字からドラッグを始めます。

ボタン代わりの要素の文字が、選択されないようにする

<span> や <div> で作ったタブやボタンは、素早く何度も押すと、その文字が選択されてしまいます。検証環境で、<span> で作ったタブ「使い方」をダブルクリックすると「使い方」が、トリプルクリックするとタブの並び全体が選択されました。タブに user-select: none を指定すると、どちらも何も選択されませんでした。

html
<div class="tabs no-select">
  <span class="tab" role="tab" tabindex="0">概要</span>
  <span class="tab" role="tab" tabindex="0">使い方</span>
</div>
css
.no-select .tab {
  -webkit-user-select: none; /* Safari */
  user-select: none;
}

一方、<button> 要素は、検証環境の Chromium では、user-select: none を指定してもしなくても、ダブルクリックやトリプルクリックで文字が選択されませんでした。

選択させない範囲の中に、選択できる部分を作る

親の要素に user-select: none を指定すると、子の要素も選択できなくなります。その中の一部だけを選択できるようにしたいときは、子に user-select: text を指定します。

html
<div class="panel">
  <p>設定パネル(ここは選択できない)</p>
  <p class="selectable">API_KEY_EXAMPLE_0000</p>
</div>
css
.panel {
  user-select: none;
}

.panel .selectable {
  user-select: text;
}

検証環境で、1つ目の <p> をダブルクリックしても何も選択されず、.selectable の <p> をダブルクリックすると API_KEY_EXAMPLE_0000 が選択されました。user-select は、仕様では子に受け継がれないプロパティです。それでも子が選択できなくなるのは、初期値の auto が、親の値を見て決まるからです。MDN の user-select のページによると、auto は、親が none なら none、親が all なら all、それ以外なら text として働きます。そのため、.panel の中の要素は、text を指定したものだけが選択できます。

なお、検証環境の Chromium で getComputedStyle() を使って読むと、何も指定していない1つ目の <p> の user-select は auto ではなく none と返りました。仕様では、計算値は指定したとおりの値(ここでは auto)です。MDN の同じページには、Chromium や WebKit 系のブラウザはこのプロパティを受け継ぐ形で実装している、と書かれています。そのため、Chromium の getComputedStyle() では、親の none を受け継いだ値が返ります。

Safari では -webkit- を付けて書く

互換性データでは、Chrome は 54、Edge は 79、Firefox は 69 から、接頭辞なしの user-select に対応しています。Safari で接頭辞なしの user-select に対応しているのは開発版(Technology Preview)だけで、正式版で使えるのは -webkit-user-select です。iOS の Safari も -webkit-user-select だけです。そのため、この記事の CSS では、-webkit-user-select と user-select を並べて書いています。

値ごとに見ると、all は Safari と iOS の Safari が 16 から、Chrome が 53 からです。none、text、auto は、どのブラウザも古くから使えます。

なお、仕様には contain という値も定められていますが、MDN によると、対応しているブラウザはありません。

注意

user-select: none は、文字のコピーを防ぐ仕組みではありません。CSS の仕様には、ブラウザが別の方法で選択できるようにしてよいこと、利用者が自分のスタイルシートで無効にできることが書かれています。また、ページ全体に none を指定して一部だけを選択できるようにすると、空いている所をクリックして選択を解除できなくなるなど、使いにくくなる例も挙げられています。none は、うっかり選択されやすい部分にだけ指定します。

​Posted by 86