content: keyboard page needs on-screen keyboard layout guidance, and lifecycle samples read the wrong property
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 86/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
調査の方向性
docs/developing/keyboard.mdx から始め、Keyboard Lifecycle Events の付近にある versioned_docs/version-v8/developing/keyboard.mdx の対応するバージョンと比較してください。#26702 をコンテキストとして使用し、ビジュアルビューポートとレイアウトビューポートの動作、interactive-widget=resizes-content、100dvh、Capacitor のリサイズモードについてのガイダンスを追加してください。両方のバージョンで動作と代替手段が正確に説明されていれば完了です。
索引モデルが issue の本文から書いたものです。
説明
URL
https://ionicframework.com/docs/developing/keyboard
Issue Description
The page covers inputmode, enterkeyhint, dark mode, the accessory bar and lifecycle events, but never says what the keyboard does to the viewport. In a mobile browser or PWA, Chrome and current Firefox shrink the visual viewport and leave the layout viewport at full height, so anything anchored to the bottom of the page stays where it was and the keyboard is drawn over it. This affects ion-fab, ion-footer and ion-tab-bar.
That is intended behavior, and refer to #26702 for the reasoning on why we do not resize the layout viewport by default. The problem is that the page never tells developers this is the model, nor how to opt into the alternative, so it keeps getting refiled: #7013 (2016), #26702 (2023), #29765 (2024). Three reports over eight years for behavior that one documented meta key configures.
Suggested addition, as a section near Keyboard Lifecycle Events:
- The keyboard shrinks the visual viewport, not the layout viewport, in browsers and PWAs, so bottom-anchored elements do not move.
- Apps that want the layout to move can add
interactive-widget=resizes-contentto the viewport meta tag, with the caveat that footers and tab bars then move above the keyboard too. Verified on Chrome 133 and Firefox 155. 100dvhdoes not account for the on-screen keyboard and is not an alternative. Worth saying outright, because it is the first thing people reach for.- Capacitor apps should use the Keyboard plugin's resize modes rather than the meta tag.
Files
docs/developing/keyboard.mdx(v9)versioned_docs/version-v8/developing/keyboard.mdx
- 主要言語
- MDX
- スター
- 621
- フォーク
- 3.2k
- 平均マージ
- 1日 6時間
- マージ済み PR（30日）
- 65
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
ionic-team/ionic-docs のほかの issue
-
content: sheet modal docs should explain how to keep interactive content from dragging the sheetオープンcontent
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
ionic-team/ionic-docs#4765 ·
メンテナーはふだん 1 日以内に返信
-
content package: angular
難易度 2/5 半日 初心者へのやさしさ 78/100
ionic-team/ionic-docs#4702 ·
メンテナーはふだん 1 日以内に返信
-
triage
難易度 1/5 1時間未満 初心者へのやさしさ 80/100
ionic-team/ionic-docs#4546 ·
メンテナーはふだん 1 日以内に返信
-
content: broken linkオープンcontent
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
ionic-team/ionic-docs#4381 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
triage
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
ionic-team/ionic-docs#3639 ·
メンテナーはふだん 1 日以内に返信
ionic-team/ionic-docs の issue をすべて見る
似ている issue
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
MystenLabs/MemWal#1085 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
Add: Docker Agentオープンnew-entry
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
prime-radiant-inc/alltheagents.org#43 ·
メンテナーはふだん 1 日以内に返信
-
📕documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
db-ux-design-system/core-web#8343 ·
メンテナーはふだん 1 日以内に返信
-
enhancement triage/needs-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
heygen-com/hyperframes#4944 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
521xueweihan/HelloGitHub#3846 ·