外部サービスの組み込み方の違い(リンク・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埋め込みはエディタ上では表示されないことがある。公開画面で確認する。