外部サービスの組み込み方の違い(リンク・iframe・script埋め込み・ウィジェット・API)と自サイトCSSが効かない理由

要点

外部サービスはリンク・iframe・script埋め込み・ウィジェット・APIの順に手軽→自由度高。iframeの中身は別サイトなので自サイトのCSSでは変えられない(枠の大きさだけ)。埋め込みは速度・Cookie・停止時の表示・高さ変化に注意。

5つの方法

方法仕組み手軽さデザインの自由度外部依存・速度への影響
リンク遷移ボタン・リンクで相手のサイトへ移動◎自サイト側は自由(相手の画面は変えられない)ほぼなし
iframe相手のページを枠の中に表示○枠の大きさ・位置だけ相手の読み込み分だけ重くなる
script埋め込み相手のJSが自ページ内に要素を作る○一部だけ(相手の用意した設定・クラス次第)外部JSを読むので重くなりやすい
ウィジェットサービスが用意した部品(iframeかscriptのどちらか)○管理画面の設定項目の範囲同上
API連携データだけ受け取り自サイトで表示を作る△(開発・保守が必要)◎APIの仕様変更・制限・料金・キーの管理が必要

重要: 埋め込んだ外部サービスは自サイトのCSSで自由に変えられるとは限らない

  • iframe の中は別のページ。ブラウザの同一オリジンポリシー(別ドメインのページには干渉できない仕組み)により、自サイトのCSS・JSは中身に届かない。変えられるのは iframe 要素自体(幅・高さ・枠線・角丸・余白)だけ。
  • script埋め込みは自ページ内に要素が作られるが、インラインstyle・Shadow DOM・相手の後読みCSSで上書きされることが多い。無理に !important で上書きしても、相手のHTML構造が変わると崩れる。
  • 色・文字などを合わせたいときは、サービス側の設定項目で変える。それでも足りなければ API で自作するか、リンク遷移にする。
  • 「ここだけ直して」と頼まれた場合も、変えられる範囲(枠・周りの余白・前後の説明文)を先に説明する。

埋め込み共通の注意

項目内容
速度外部のJS・画像・フォントを読み込む。1ページに複数置くほど重い(ページが遅くなる主な原因と「調べてから直す」考え方(ページ速度の基本))
Cookie・プライバシー表示しただけで外部サービスがCookie等を使うことがある。プライバシーポリシーに外部サービスの利用を書く
停止・仕様変更相手の障害・仕様変更・サービス終了で空白やエラーになる。近くにリンクも置く(埋め込みが消えても行き先が残る)
高さ読み込み後に高さが変わり、下の要素がずれる(CLS)。枠に min-height や aspect-ratio を指定して場所を確保
スマホ横幅固定(width="600")のままだと横スクロールになる。width:100%; max-width:100%(スマホで横スクロールが出る(はみ出し要素の探し方と直し方))
埋め込み拒否相手が X-Frame-Options / CSP で iframe表示を禁止していると「接続が拒否されました」。リンクにする
アクセシビリティiframe には title 属性(例: title="〇〇の地図")
ログイン必須化SNS等は、閲覧にログインが必要になる・表示件数が減るなどの変更がある。最新の公式仕様を確認

基本のレスポンシブ枠

<div class="embed"><iframe src="..." title="〇〇" loading="lazy"></iframe></div>
.embed{ aspect-ratio:16 / 9; }          /* 地図などは高さ固定でもよい */
.embed iframe{ width:100%; height:100%; border:0; display:block; }

選び方

  • 迷ったらリンク遷移が最も壊れにくい。埋め込みは「ページ内で見せる価値がある」ときだけ。
  • WordPress(Elementor のHTMLウィジェット等)に貼る場合、script埋め込みはエディタ上では表示されないことがある。公開画面で確認する。