1. ヘルプ
  2. 実装(全般)

microCMSと連携したウェブサイト/アプリの表示が崩れています。どうしたら解決しますか?

→ ウェブサイト/アプリの管理者、もしくは開発担当者にご確認をお願いいたします。

microCMSと連携したWebサイトの表示やレイアウトが崩れている場合、まずは対象コンテンツのmicroCMS上のURLと、該当ページのURLをウェブサイトの管理者、または開発担当者に共有し、確認の依頼をお願いいたします。

なお、表示崩れの主な原因は以下の2つです。原因に合わせた対応をお願いいたします。

フロントエンド(HTML / CSS / JS など)が要因となるケース

  • DOM構造やスタイル定義が意図通りでない

  • コンテンツ量や文字数によるUIの崩れ
  • レスポンシブ設計の不具合(画面幅による崩れ)

microCMSのAPIレスポンスが要因となるケース

  • スキーマ変更により、期待していたフィールドが欠損している

  • フィールドの構造(例:配列 → オブジェクト、またはその逆)が変更された

  • 意図せず、下書き中のコンテンツデータを参照している

よくある表示崩れの例

症状 主な原因 対応例
テキストや画像などの要素がレンダリングされない    
  • ページに必要な要素が、管理画面で入力されていない
  • フィールドIDが変更されたがコード側が未更新 
  • microCMSのAPIスキーマ設定で「必須項目」設定をONにして、必ず入力されるようにする
  • APIスキーマ設定を確認し、コードをmicroCMSのフィールドIDに合わせて修正する
要素がはみ出したり、横に伸びる DOM要素に対して適切なスタイルが施されていない HTML/CSSを見直し、適切なスタイリングがされるように修正する
リスト形式の要素が表示されない(複数画像、複数コンテンツ参照) 配列形式となっているレスポンスの処理が不適切 JS等を見直し、配列形式のレスポンスが正しく表示されるように修正する
画像サイズが意図せず変化し、レイアウトが崩れた     画像の縦横比がmicroCMS側で統一されていない    
  • microCMS側で入力サイズの制限を設ける
  • CSSでobject-fit: cover を指定し、視覚的一貫性を保つ

 

上記のいずれにも該当せず、解決しない場合はAPIのレスポンスに何らかの不具合が生じている可能性がございます。その場合は、サポートにお問い合わせください。