CSSが効かないときに原因を調べる
要点
書いたCSSが効かないとき、DevToolsで「ルールがない/負けている/勝っているのに変わらない」の3つに分けて調べる。
使う場面
- CSSを追加・変更したのに見た目が変わらない
- PCでは効くのにスマホだけ効かない(またはその逆)
最初に確認
- キャッシュ(ブラウザ・キャッシュプラグイン・サーバー・Elementorの生成CSS)を消したか、シークレットウィンドウで見ているか(WordPressの変更が反映されない(キャッシュの種類と消し方))
- 見ている要素が本当に対象か(同じクラスが複数ないか)
- どの幅で起きているか(メディアクエリの範囲)
手順
- DevTools で対象の要素を選ぶ(右クリック → 検証)。
- Styles を見て、次の3つのどれかに分ける(CSSが効かない・変更が反映されないときのチェックリスト)。
- A. ルールが出てこない: セレクタの誤り、CSSが読み込まれていない、
}の不足、別の幅のメディアクエリの中 - B. 打ち消し線(負けている): 詳細度、後から読み込まれたテーマ・Elementor、
!important・インライン style(足し方は CSSを追加するときの優先順位(詳細度・読み込み順・テーマとElementorの競合)) - C. 勝っているのに変わらない: 前提不足(
z-indexにposition、インライン要素のwidth)、上に別の要素が重なっている
- A. ルールが出てこない: セレクタの誤り、CSSが読み込まれていない、
- Computed で最終的な値を確認する。
- 直すCSSは最小限・専用クラスの範囲で追加する(既存ルールは書き換えない)。
- PC・390px の両方と、同じCSSを使う別ページで確認する。
Claude / AIへ送る指示
CSSが効かない原因の調査だけしてください。まだ修正しないでください。
対象ページ: 〔URL〕
対象要素: 〔セレクタ/見た目の説明〕
期待: 〔例: 390pxでボタンを1行にしたい〕
追加したCSS: 〔貼る〕
実ブラウザで対象要素の Computed の値と、そのプロパティを決めているルール(ファイル・セレクタ・詳細度)を確認し、
「ルールがない/負けている/勝っているのに変わらない」のどれかと、最小の修正案を報告して止まってください。
コマンド
【読み取り】 要素を選んだ状態で、ブラウザのコンソールで($0 は選択中の要素):
// 最終的な値を確認(プロパティ名は調べたいものに変える)
const s = getComputedStyle($0); [s.display, s.position, s.zIndex, s.width, s.marginTop]
// その位置で一番上にある要素(重なりの確認)
const r = $0.getBoundingClientRect(); document.elementFromPoint(r.left + r.width / 2, r.top + r.height / 2)
// 同じクラスがいくつあるか
document.querySelectorAll('.〔クラス名〕').length
最後の確認
- PC・390px で意図どおり
- 同じCSSを使う別ページ・既存部分に影響がない
- キャッシュを消した状態・シークレットウィンドウでも効いている
注意点
- テストで注入したCSSは読み込み順が本番と違うことがある(本番より先に読まれて負ける → テスト用に注入したCSSが本番CSSより先に読み込まれて効かない)。
!importantを足す前に、なぜ負けているかを確認する。むやみに足すと次の修正がさらに難しくなる。z-indexが効かないときは重なりの仕組みを確認(position・z-index・重なり順(スタッキングコンテキスト)と疑似要素の基本)。