チャット・地図・外部スクリプトが動かないとき

外部の地図やチャットが表示されないとき、ページ・通信・相手の制限を順に切り分けます。

目次

地図やチャットが出ないときは、問題が起きるページのURLと状態を控え、制作担当者に確認を依頼します。 制作担当者は、埋め込みコード、ブラウザーの制限、提供元の設定を順に調べます。

最初は制作担当者が、新しく足した部品を一つだけにして検証用ページで調べます。管理画面のプレビューと読者向けページでは、セキュリティの条件が違う場合もあります。

編集担当者は、部品を貼ったページのURLと「地図が白い」「送信を押しても進まない」などの状態を控えます。利用者が見ている公開ページでも起きるかを確認してから制作担当者へ渡すと、調べる場所を絞れます。

まず、誰の画面で起きるかを見る

同じURLを、通常のブラウザー、広告ブロッカーなどの追加機能を入れていない確認用プロファイル(保存情報を分けた利用環境)、別の端末で開きます。同意前後でも結果が変わるかを見ます。

広告ブロッカーを使う人にも必要な問い合わせができるかは、別の確認事項です。「ブロッカーを切れば動く」で調査を終えず、代替の連絡先なども用意します。

開発者ツールで、止まった理由を探す

制作担当者はブラウザーの開発者ツールで Console(エラーなどの記録)と Network(通信の一覧)を見ます。担当者へ渡すときは、URL、時刻、エラー文を残し、個人情報や、外部サービスへ接続するための秘密の鍵は隠します。

見つかったこと確認先
外部ファイルが404(見つからない)埋め込みコードとファイルのURL
許可されたドメインではない外部サービスの設定
CSPで拒否自分のサイトの読み込み許可
frame(別ページを表示する枠)への表示を拒否埋め込まれる側の方針
ページ移動後だけ出ない部品を表示できる状態に準備する処理が、移動後も動くか

CSPと埋め込み拒否を混同しない

CSPは、どこからプログラムや画像などを読み込めるかを制限する仕組みです。自分のページの frame-src と、相手が「どのサイトに埋め込まれてよいか」を決める frame-ancestors は役割が違います。MDNのCSPの説明(別タブで開く)

自分側の許可を増やしても、相手の埋め込み拒否を解除できるわけではありません。相手が正式に提供する埋め込み方法や、別ページへ移動する方法を選びます。

制作担当者が、必要な通信先とその理由を確認し、その通信だけを許可します。CSP全体を無効にしたり、すべての接続先を許可したりしないでください。

二つの部品が干渉する場合

単独では動く部品を二つ置くと止まるなら、制作担当者が、共通のプログラム部品(ライブラリー)の重複、読み込み順、同じ名前の設定、見た目を指定するCSSの影響を調べます。部品を一つずつ戻して、どの組み合わせで起きるかを記録します。

iframeは別のページを枠の中へ表示する仕組みです。その枠で分かれた画面と、自分のページへ直接入るスクリプト(動作させるプログラム)では、互いに影響する範囲が違います。EmDashのHTMLブロックにも表示方式による違いがあるため、公式の本文編集(別タブで開く)と、採用したテーマの出力を確認します。

調査を引き継げる結果を残す

「予約部品だけなら表示。チャット追加後はConsoleにこのエラー。Chromeの通常表示で発生」のように書きます。制作会社と外部サービス会社のどちらが、次に何を調べるか決め、窓口を一つにします。

表示が直ったら、入力・送信・完了まで試します。見た目だけの確認で終えないために、フォームの受付確認へ進みます。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。