フレームワークに依存しない
標準ベースのカスタム要素を直接使用するか、React、Vue、Angular、Svelte、Solid 用のセットアップヘルパーを使用できます。
フレームワークに依存しない
標準ベースのカスタム要素を直接使用するか、React、Vue、Angular、Svelte、Solid 用のセットアップヘルパーを使用できます。
Capacitor の準備完了
Webレイヤーから、セーフエリア、キーボードの動き、ネイティブのエッジジェスチャー、WebViewのテーマカラー減光を考慮します。
あらゆるシート形状
ボトムシート、サイドドロワー、トップシート、中央ダイアログ、トースト、デタッチドシート、カード、ページ、ライトボックスを作成できます。
モダンCSS
detentsの作成には、 em, remビューポート単位、 calc()およびCSS変数を使用でき、デフォルトのサイズ設定は em に基づいています。
| プラットフォーム | サポート | 備考 |
|---|---|---|
| iOSと | Webレイヤー | WKWebView 内のカスタム要素 |
| Androidでは | Webレイヤー | Android WebView 内のカスタム要素 |
| Web | はい | Capacitor Web ビルドでも共通のコンポーネント |
@capgo/capacitor-sheets 特定のUIフレームワークを採用せずに、高品質なモバイルオーバーレイを必要とする Capacitor アプリ向けです。カスタム要素として提供されるため、コアパッケージに React、Vue、Angular、Svelte、Solid などのランタイム依存関係はありません。
以下のような場合に最適です:
| ユースケース | Capgo Sheetsパターン |
|---|---|
| 長いシート | cap-sheet コンテンツを自然にスクロール、または cap-scroll |
| デテント付きシート | detents="18em 32em" と stepTo() またはステップトリガー |
| サイドバー | content-placement="left" または content-placement="right" |
| ボトムシート | デフォルト content-placement="bottom" |
| キーボード対応シート | native-focus-scroll-prevention およびビジュアルビューポートのオフセット制御 |
| トースト | inert-outside="false", focus-trap="false", 外側クリックによる非表示なし |
| デタッチドシート | cap-sheet-special-wrapper カスタムマージンと角丸に対応 |
| ボトムアップページ | フルハイトのボトムシートコンテンツ |
| トップシート | content-placement="top" |
| スタッキング対応シート | cap-sheet-stack depth変数付き |
| Depth付きSheet | cap-sheet-outlet progress連動のtransform |
| パララックスページ | cap-sheet-outlet を使用して cap-scroll 進捗 |
| ページ | 画面端から入るビューポート全体のコンテンツ |
| Lightbox | content-placement="center" backdropとメディアコンテンツ付き |
| Detent付きPersistent Sheet | default-presented, swipe-dismissal="false"や inert-outside="false" |
| Card | コンパクトで中央揃えのシートコンテンツ |
<cap-sheet> 表示状態、detents、配置、ジェスチャー、アクセシビリティ、およびイベントを管理します。<cap-sheet-trigger> present、dismiss、toggle、およびdetent-stepのアクションを定義します。<cap-sheet-view> オーバーレイの位置を調整し、セーフエリアとキーボードのオフセットを適用します。<cap-sheet-backdrop> 進捗と同期したバックドロップを描画します。<cap-sheet-content> シートのサーフェスを描画します。<cap-sheet-handle> ドラッグおよびキーボードによるdetentコントロールを提供します。<cap-sheet-stack> スタックされたシートを制御します。<cap-sheet-outlet> シートの進捗を、ページ、深度、およびパララックス効果に公開します。<cap-scroll> と <cap-scroll-content> スクロールの進捗と距離のヘルパーを公開します。setupSheet(element, options?) フレームワークのエフェクトやライフサイクルフックからシートを設定します。デフォルトのシートビューポートは、 env(safe-area-inset-*) および Capacitor スタイルの --safe-area-inset-* フォールバック変数を読み取り、選択したエッジをオーバーレイ周囲のパディングとして適用します。 safe-area="auto" すべてのエッジを保護します。使用するのは safe-area="bottom left right" または safe-area="none" ユースケースで異なる挙動が必要な場合です。
キーボード処理はデフォルトで有効です。シートは次をリッスンします。 visualViewport リサイズやスクロールイベントに対応し、ビューポートにキーボードのオフセットを追加して、コントロールにフォーカスを当てます。 preventScroll これにより、入力フィールドがソフトウェアキーボードに隠れず、常に表示された状態を維持できます。
このパッケージはWebレイヤーで動作します。ネイティブのUIKitやAndroidのボトムシートをレンダリングしないため、Capacitor において重要なWebViewの制約を遵守しつつ、アプリのデザインを完全にコントロールできます。
リポジトリのREADMEには、サポートされているすべてのユースケースに対応したAnimated WebPのデモが含まれています。また、StackBlitzのPlaygroundからも例を確認できます:
| 長いシート | Detents |
|---|---|
![]() | ![]() |
| サイドバー | Lightbox |
|---|---|
![]() | ![]() |
使用している場合 @capgo/capacitor-sheets ネイティブプラグインの作業を計画するには、次と連携してください: Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新に関する実装詳細については、 Ionic Enterprise プラグインの代替案 Ionic Enterprise Plugin Alternatives のプロダクトワークフロー、および Capgo Native Build Capgo Native Builds のプロダクトワークフローについては、