スクロールバーの色を変えるCSSが効かない原因

公開ツールCSSスクロールバー ジェネレーター

目次
  1. コードを入れたのに、片方のブラウザーでしか変わらない
  2. Chrome用とFirefox用で記法が分かれている理由
  3. つまずきやすいポイント
  4. まとめ
  5. よくある質問

スクロールバーの色を変えるCSSを検索してそのまま貼ったのに画面が変わらない場合、多くはChrome用の書き方とFirefox用の書き方のどちらか一方しか入れていないことが原因です。2つのブラウザーはスクロールバーを別々の記法で処理しているため、この事実を知らないと、コードを何度書き換えても原因が見つかりにくくなります。この記事では、2つの記法がなぜ分かれているのかと、コードを入れても反映されないもう1つのよくある原因について、確認できる事実だけをまとめます。

要約 ① Chrome・Safari・Edgeは ::-webkit-scrollbar 系の擬似要素、Firefoxは scrollbar-color・scrollbar-width という標準プロパティを使います。両者はまったく別の記法です。 ② scrollbar-width はpxで正確に指定することができず、thin・auto・none の中からしか選べません。 ③ CSSは body ではなく、実際に overflow が指定されてスクロールが発生している要素のクラスに指定しないと反映されません。

コードを入れたのに、片方のブラウザーでしか変わらない

サイドメニューやカード一覧のように、内部に overflow-y: auto を指定した領域へブランドカラーのスクロールバーを入れようとすると、よく起こる現象です。検索して見つけたCSSコードを貼ったところ、Chromeでは色が変わったのに、同じページをFirefoxで開くと相変わらずグレーの標準スクロールバーが表示されます。

逆のケースもあります。ほかの記事から持ってきたコードがFirefoxでは効くのに、Chromeでは変わらないという場合です。コード自体が間違っているわけではなく、片方のブラウザーエンジン向けの記法しか書かれていないためです。

Chrome用とFirefox用で記法が分かれている理由

CSSでスクロールバーを装飾する方法は、ブラウザーエンジンによって2通りに分かれます。1つはChrome・Safari・EdgeなどのWebKit・Blink系が使う ::-webkit-scrollbar 擬似要素で、もう1つはFirefoxが実装したCSS Scrollbarsの標準プロパティである scrollbar-color・scrollbar-width です。

Chrome・Safari・Edgeが使う ::-webkit-scrollbar

::-webkit-scrollbar 系はW3Cの標準ではなく、WebKitが先に作った非標準の拡張です。スクロールバーを構成する部分ごとに、別々の擬似要素を使って指定します。

.custom-scrollbar::-webkit-scrollbar {
  width: 10px;
}
.custom-scrollbar::-webkit-scrollbar-track {
  background: #f1f5f9;
}
.custom-scrollbar::-webkit-scrollbar-thumb {
  background: #6366f1;
  border-radius: 5px;
}
.custom-scrollbar::-webkit-scrollbar-thumb:hover {
  background: #6366f1cc;
}

-thumb:hover の色は、つまみの色の後ろに cc という16進数2桁を付けた値です。cc は10進数で204で、204を255で割ると約0.8、つまり不透明度は約80%になります。新しい色を決めるのではなく、元の色に透明度だけを加えた値です。

Firefoxが使う scrollbar-color・scrollbar-width

一方、Firefoxは標準プロパティ2つだけで済みます。

.custom-scrollbar {
  scrollbar-color: #6366f1 #f1f5f9;
  scrollbar-width: thin;
}

scrollbar-color は値を2つ受け取り、1つ目がつまみ(thumb)の色、2つ目がトラック(背景)の色です。順番を入れ替えると、色も入れ替わって表示されます。

scrollbar-width は、CSS Scrollbarsの標準で定められている値が auto・thin・none の3つだけです。ピクセル単位で太さを指定する値は、標準そのものに存在しません。そのため、「10pxのような正確な太さ」をFirefoxでそのまま再現する方法はなく、基準値より細ければ thin、それ以上なら auto というように近似できるだけです。

最近のバージョンのChromium系ブラウザーでは scrollbar-color も認識されるようになりましたが、長い間このプロパティはFirefox専用でした。そのため現在も、両方の記法を入れておく方法が、ブラウザーを問わず適用させるやり方として使われています。

2つの記法を併記しても変わらない場合:セレクターの問題

この2つのブロックを併記してもスクロールバーが変わらない場合、原因は多くの場合セレクターにあります。上のコードは、.custom-scrollbar というクラスが付いた要素にだけ適用されるように書かれています。このクラスは、実際にスクロールが発生している要素、つまり overflow: auto や overflow: scroll が指定された要素に付ける必要があります。

ページ全体のスクロールバーを変えたい場合は body や html にクラスを指定し、カード一覧のように特定の領域の中だけでスクロールが発生する場合は、その領域を包んでいる要素に指定します。body に指定したのに、実際のスクロールは内側の div で起きている構造だと、body 側のスクロールバーは変わっても、画面に見えているスクロールバーはそのままです。

Dynamic Labsの「CSSスクロールバー ジェネレーター」で確認できます。

CSSスクロールバー ジェネレーター

色・太さ・角丸を調整すると、Chrome用とFirefox用のCSSが同時に生成されます。計算はブラウザ内で即座に行われ、サーバーには送信されません。

つまずきやすいポイント

項目Chrome・Safari・Edge (WebKit系の記法)Firefox (標準プロパティ)
スタイルの指定方法::-webkit-scrollbar 擬似要素scrollbar-color、scrollbar-width
太さの指定px単位で正確に指定できるthin/auto/none から選ぶだけ
ホバー時の色:hover 擬似クラスで個別に指定個別に指定する記法はなく、ブラウザーが独自に処理
標準かどうか非標準(ベンダー拡張)CSS Scrollbarsの標準

最もよくある失敗は、片方の記法だけを入れて、もう一方のブラウザーを考慮しないことです。::-webkit-scrollbar だけではFirefoxでは何も変わらず、scrollbar-color だけでは、これを認識しないブラウザーでは標準のスクロールバーがそのまま表示されます。

2つ目は、太さの誤解です。Chromeで10pxに合わせたからといって、Firefoxでも同じ10pxになると期待するとずれが生じます。Firefoxは thin か auto の2段階でしか反応しないため、2つのブラウザーで太さがピクセル単位まで一致することはありません。

3つ目は、マウスホバー時の色です。Chromeでは :hover 擬似クラスでつまみの色を別に指定できますが、Firefoxの scrollbar-color には、ホバー状態を指定する標準の記法がありません。ホバー時に色が少し変わって見えても、それはブラウザーが独自に処理しているもので、CSSで指定した値ではありません。

まとめ

  • Chrome・Safari・Edgeは ::-webkit-scrollbar 系の擬似要素、Firefoxは scrollbar-color・scrollbar-width という標準プロパティを使います。片方だけ入れると、もう一方のブラウザーは標準のスクロールバーのままです。
  • scrollbar-width はピクセル単位での指定ができず、thin・auto・none の中からしか選べません。
  • CSSは、実際にスクロールが発生している要素(overflowが指定された要素)のクラスに指定する必要があります。body に入れても、実際には別の要素でスクロールが起きている場合は適用されません。
  • マウスホバー時の色は、Chromeでは :hover で直接指定できますが、Firefoxにはそのような記法がありません。
CSSスクロールバー ジェネレーター

色・太さ・角丸を調整すると、Chrome用とFirefox用のCSSが同時に生成されます。計算はブラウザ内で即座に行われ、サーバーには送信されません。

よくある質問

スクロールバーの太さを15pxのように正確な値で指定できますか?

Chrome・Safari・Edgeでは、::-webkit-scrollbar の width に好きなピクセル値をそのまま指定できます。一方、Firefoxの scrollbar-width は、仕様上 auto・thin・none の3つの値しか使えません。そのため15pxのような正確な値は指定できず、thin か auto のうち近いほうで近似するしかありません。

コードを入れたのにChromeでは反映され、Firefoxでは変わりません。なぜですか?

::-webkit-scrollbar の記述だけを入れて、scrollbar-color と scrollbar-width を一緒に入れていない可能性が高いです。この2つの書き方は互いに代わりになるものではないため、両方のブラウザに適用したい場合は、2つのブロックをセットで記述する必要があります。

生成されたCSSはどこに貼り付ければよいですか?

コード内のクラス名(.custom-scrollbar など)を、実際にスクロールが発生している要素、つまり overflow: auto や overflow: scroll が指定されている要素のクラス名に置き換えたうえで、その要素に適用してください。ページ全体のスクロールバーであれば body や html に、特定の領域の中だけでスクロールする構造であれば、その領域の要素に指定すると反映されます。

SafariでもこのCSSは適用されますか?

SafariはWebKitエンジンを採用しているため、::-webkit-scrollbar 系の疑似要素はChromeと同じように適用されます。Firefoxの標準プロパティである scrollbar-color と scrollbar-width は、ブラウザのバージョンによって対応状況が異なる場合があります。そのため、2つの書き方を併記しておくと安心です。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. 秘密テキストをサーバーに残さず共有する方法パスワードなどの秘密テキストをメッセンジャーで送ると、サービス側のサーバーに残ります。ブラウザ内で圧縮・暗号化してURLに載せ、サーバーに保存せず共有する仕組みと、パスワードロックをオンにしないと暗号化されない理由を解説します。
  2. 英語の大文字・小文字変換 4つのケース規則と使い方英文をSentence Case・Title Case・snake_case・kebab-caseに変換する規則と、変換ツールで実際に使えるオプションを整理します。
  3. URLスラッグの作り方|小文字とハイフンに変換する正規表現タイトルや文章をURL用のスラッグに変換する手順と正規表現を、実際のツールの動きとともに解説します。ハングルを残すかどうかで結果が変わる点も比較できます。
  4. スマートクォートをASCII変換|コードの構文エラー解決Wordやメッセンジャーで自動変換されたスマートクォートが構文エラーを起こす原因と、標準ASCIIの引用符・ダッシュへ一括で戻す変換ルールを解説します。
  5. ブラウザで音声入力する方法、Firefoxが対応しない理由Web Speech APIを使えば、インストールなしでブラウザのマイクから音声をリアルタイムに文字起こしできます。Chrome・Edgeで動いてFirefoxで動かない理由と、途中で認識が切れる仕組みを整理します。
  6. 文単位の改行|記号と空白で文を分割する正規表現ルールピリオド・疑問符・感嘆符の後に空白がある位置を文の区切りとして判定し、小数点や英語の略語を誤分割しないための例外ルールを解説します。出力形式と文字数の統計も確認できます。

関連ツール