CSSが効かない・変更が反映されないときのチェックリスト
要点
DevToolsで対象要素にルールが出ているかを最初に見る。出ていなければセレクタ・読み込み・キャッシュ、出ていて打ち消し線なら詳細度・読み込み順、出ていて効かないならメディアクエリ・display等の前提条件を疑う。
DevTools で対象要素を選び、Styles を見て3つに分ける(DevToolsでCSSを調べる流れ(要素特定→Styles→Computed→その場で試す))。
A. ルール自体が出てこない
- セレクタの誤り(クラス名のつづり、
.の付け忘れ、親子関係の違い)。 - CSSが読み込まれていない(ファイルの404、
<style>の閉じ忘れ、前の行の}不足で以降が無効)。 - キャッシュ: ブラウザ、キャッシュプラグイン、サーバーキャッシュ、Elementor の生成CSS(WordPressの変更が反映されない(キャッシュの種類と消し方))。
- 別の端末用のメディアクエリの中に書いている。
B. ルールはあるが打ち消し線(負けている)
- 詳細度が低い → 親クラスを足して詳細度を上げる。
- 同じ詳細度で、後から読み込まれたCSS(テーマ・Elementor)に負けている。
- 相手が
!importantやインライン style。 - テストで注入したCSSが本番より先に読み込まれている(テスト用に注入したCSSが本番CSSより先に読み込まれて効かない)。
→ 足し方は CSSを追加するときの優先順位(詳細度・読み込み順・テーマとElementorの競合)。
C. 勝っているのに見た目が変わらない
- 前提条件が足りない:
z-indexにはposition、widthはインライン要素に効かない(displayを確認)、gapは flex/grid の中だけ。 - 子要素や疑似要素が上に重なって見えていない。
- 値の単位抜け(
margin:20など)。 - 別の要素を見ている(同じクラスが複数ある)。
確認
直したら、PCとスマホ(390px)の両方で確認し、別のページに影響していないかも見る。