其他技能
mobile-web-check
PCとスマホの両方で使うWebアプリを、iPhoneで実際に崩れない状態まで確かめる手順と、iOS Safari・ホーム画面Webアプリ・アプリ内ブラウザの罠(セーフエリア、上端の色、入力欄の自動ズーム、ホバー、キーボード、縦スクロール)。スマホでも使う画面を作った・直したとき、「スマホで崩れている」「スマホで見ると変」「iPhoneで見てみて」と言われたとき、iOS Simulator で確認するときに読む。
minorun365 · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add minorun365/unslop-ai-app --skill mobile-web-check技能说明
name: mobile-web-check description: PCとスマホの両方で使うWebアプリを、iPhoneで実際に崩れない状態まで確かめる手順と、iOS Safari・ホーム画面Webアプリ・アプリ内ブラウザの罠(セーフエリア、上端の色、入力欄の自動ズーム、ホバー、キーボード、縦スクロール)。スマホでも使う画面を作った・直したとき、「スマホで崩れている」「スマホで見ると変」「iPhoneで見てみて」と言われたとき、iOS Simulator で確認するときに読む。
スマホで崩れないことを確かめる
PCのブラウザを狭めた検証は、iPhone の代わりにならない。セーフエリア、Dynamic Island、ホーム画面から起動したときの挙動、キャッシュの残り方は、どれも Chrome の狭い窓では再現しない。スマホでも使う画面は、iOS Simulator(か実機)で表示して確かめるまで完成と言わない。
利用者は「スマホで見てみて」としか言わない。Simulator の起動から撮影までは自分で進め、結果は撮った画面と「どこが崩れていて、どう直したか」で伝える。Xcode が入っていない Mac では Simulator を使えないので、そのことと、実機で見てもらう場合の開き方(同じネットワークのURL)を伝える。
1. 見る順番
- 画面の全種類を開く。 トップ、子画面、ダイアログ、ログイン画面のそれぞれ
- 直す前にも一度見る。 症状を自分の目で確かめてから原因を探す
- 指摘された所だけを見ない。 1回に1つしか指摘されなくても、同じ画面に写っている他の崩れも直す。最低限この順で見る
- 上端:ステータスバーの帯と本文の色がつながっているか。画面ごとに色が違っていないか
- 浮いている要素:固定のボタンやバッジが、見出しや本文に重なっていないか
- 余白:最初の見出しまでの空きが間延びしていないか。余白を足し算で積むと、元から余裕のある画面だけ広くなる。
max()で下限を保証する形にする - 下端:中身の短い画面で、下に出る地の色。上下に引っ張ったときに見えるのは
htmlの背景色 - 横:
document.documentElement.scrollWidth === clientWidth
- 数字のカードは、文字の矩形がカードに収まっているかを測る。 画面からはみ出していなくても、隣のカードへはみ出すことがある。実際の桁数と、列数が変わる境目の幅で測る。文字を縮めて収めず、同じ種類の数字の大きさはそろえたまま、桁の丸め方やカードの幅を見直す
2. iOS Simulator の使い方
xcrun simctl list devices booted # 起動中があれば、それを使う
xcrun simctl list devices available | grep iPhone
xcrun simctl boot <UDID>
open -a Simulator
xcrun simctl openurl <UDID> "http://127.0.0.1:<port>/<path>?cb=$RANDOM"
xcrun simctl io <UDID> screenshot /tmp/sim.png
xcrun simctl shutdown <UDID> # 終わったら畳む
xcode-selectがコマンドラインツールを指していてsimctlが見つからないときは、DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developerを渡す。xcode-selectを切り替えなくても動く- 手元の
python3 -m http.serverは、Simulator から127.0.0.1でそのまま開ける。 認証の要る本番を開かなくても、ビルド結果を検証できる - 開き直すときは URL に乱数のクエリを付ける。 付けないと前の版が出る
openurlの後は10秒ほど待ってから撮る。 早いと真っ白な画面か、読み込み途中が写る。白い画像が撮れたら、まず待ち時間を延ばして撮り直す- 端末は1台を使い回し、終わったら畳む。 何台も起動したまま放置すると、メモリを食い合って中のプロセスが落ちる
- Mac の画面全体を操作するツールで Simulator をタップしない。 利用者の作業からフォーカスを奪う。
simctlにタップは無いので、次のように別の方法で同じ結論を出す- 引っ張ったときの地の色は、
htmlとbodyのbackground-colorを読んで同じ色かを確かめる - ホーム画面から起動したときの見え方は、セーフエリアを CSS 変数へ通しておき、値を差し込んで再現する
- ホーム画面への追加のように、画面操作でしか届かない状態は、人に一度だけ確認を頼む
- 引っ張ったときの地の色は、
3. セーフエリアと上端
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
<meta name="theme-color" content="#1f3a8a">
- 背景は画面の端まで広げ、文字とボタンだけを安全な領域へ逃がす。
viewport-fit=coverだけでは中身も Dynamic Island の下に入る。逆に帯ごと押し下げると、背景が手前で切れる
.hero { padding-top: calc(3rem + env(safe-area-inset-top, 0px)); }
.hero-inner {
padding-left: max(1rem, env(safe-area-inset-left, 0px));
padding-right: max(1rem, env(safe-area-inset-right, 0px));
}
main { padding-bottom: calc(4rem + env(safe-area-inset-bottom, 0px)); }
- ホーム画面から起動する Web アプリは、Safari のタブとは別物として確かめる。 判定は
display-mode: standaloneに加えてnavigator.standalone === trueも見る。最初の画面だけでなく、遷移する先の全 HTML に同じ meta を付け、値をそろえる。食い違うと、どちらが使われるかが iOS の実装しだいになり、直したのに直らない状態の切り分けができなくなる apple-mobile-web-app-status-bar-styleは、上端の色をつなぐか、ぼかしを避けるかの選択になる。black-translucentは中身をステータスバーの裏まで描くが、iOS 26 以降はそこへ OS がぼかしを重ねる。defaultにすると中身はステータスバーの下から始まり、その帯はtheme-colorで塗られる。両方は取れないので、先にどちらを取るか決める。defaultでもぼかしが出る報告もあり、OS の版によって振る舞いが変わる- Safari のタブで、上端の帯の色を本文の帯とつなぎたいとき は、画面の上端に接する高さ 0.5rem ほどの
position: fixedの面を置き、帯の色で塗る。帯を通り過ぎたら隠す。スクロールに合わせてtheme-colorやbodyの色を差し替えない - 帯の直後の本文の入れ物は
display: flow-rootにする。 最初の子要素の上マージンが外へ抜けると、地の色が細い線として見える
4. スクロール
- 縦のスクロールは
document.scrollingElementの1つだけにする。 画面全体を覆うoverflow-y: autoの入れ物を作らない。iPhone の「画面の上端をタップして先頭へ戻る」が使えなくなる - 長い本文を
iframeの中でスクロールさせない。 スマホでは本文の URL へ直接遷移させる。そのとき、遷移前の画面にあった操作(一覧へ戻る、共有)を消さず、本文の上に小さく重ねる - 横長の表など、横のスクロールは部分的に持ってよい
- 横のはみ出しは原因を直す。
overflow-x: clipは直した後の保険で、代わりにしない。touch-action: pan-yは Safari の戻るジェスチャーに影響するので既定では使わない
5. 入力とタッチ
- 入力欄の
font-sizeは 16px 以上にする。 iOS Safari は 16px 未満の入力欄にフォーカスすると画面を拡大し、ページが横にはみ出したまま戻らない。小さく見せたいならpaddingとheightで詰める。1つ足したら、画面内の全部の入力欄を見る - メニューはホバーではなくタップで開く。 外側のタップで閉じるには
mousedownに加えてtouchstartも拾う - ボタンで入力欄を開くなら、同じイベントの中で
focus()を呼ぶ。 タイマーや次の描画へ回すと、キーボードが出ないことがある - キーボードの有無の判定と、配置の高さを分けて扱う。 アプリ内ブラウザ(WKWebView)では、キーボードが出ると
innerHeightとvisualViewport.heightが両方縮むことがある。入力前の高さとの比較も判定に使う。キーボードが閉じる途中も、しばらく表示領域は縮んだままになる - 送信ボタンは二重送信を検査する。 タッチの終わりで送信する作りなら、ドラッグ、タッチの中断、複数の指を除外し、続いて来るクリックで2回送らないかを確かめる
6. アプリ内ブラウザ
- SNS アプリの中のブラウザは、ページを描いた後で上の余白を足すことがある。 そのとき
resizeもvisualViewportの通知も来ない。読み込み時に測った見出しの高さで配置した要素が、見出しに重なる。見出しをResizeObserverのborder-boxで見張って配置し直す - Safari や検証用の WKWebView で直っても、対象のアプリで直った証拠にはならない。 再現できていない症状は、原因が分かった、直した、と書かない
7. 検証の記録で間違えないこと
- 撮った画像が新しい版のものかを照合する。 開発サーバーがファイルの変更を拾わず、古いコードを配信していることがある。配信中のファイルに修正箇所が入っているかを確かめてから撮る
- ホスティングや CDN が配信時にスクリプトを足す構成なら、配信後の URL で、数秒待ってから測る。 手元のファイルでは正しくても、読み込みの後で書き換えられる