コンテンツにジャンプ

@capgo/capacitor-シート

シルクスタイルのシート、ドロワー、ダイアログ、トースト、ライトボックス、カード、ページオーバーレイを任意のCapacitorフロントエンドで作成します。

フレームワーク非依存

React、Vue、Angular、Svelte、Solidを含む標準ベースのカスタム要素を直接使用するか、セットアップ ヘルパーを使用してください。

Capacitor ご利用可能

安全なエリア、キーボードの動作、ネイティブのエッジ ゲストゥア、WebView のテーマカラー ダイミングをウェブ層から尊重する

すべてのシートの形状

下部シート、サイド ドロワー、上部シート、センタリング ダイアログ、トースト、分離 シート、カード、ページ、ライト ボックスを組み立てる

モダン CSS

デタントをauthorする em, rem、ビューポート ユニット、 calc()、CSS 変数を使用しながら、デフォルトのサイズは em ベース

@capgo/capacitor-sheets Capacitor アプリケーション向けの高品質モバイルオーバーレイを実現するために、特定のUIフレームワークを採用せずにカスタム要素を使用します。コアパッケージには、React、Vue、Angular、Svelte、Solidのランタイム依存性がありません。

使用するタイミング

  • 1つ以上のデッテントを持つ下部シート
  • 左または右サイドバーと上部シート
  • 中央のダイアログ、ライトボックス、カード、トーストのようなオーバーレイ
  • シートの後ろにアプリケーションを保持してインタラクティブにし続けるシート
  • エッジから入るフルページオーバーレイ
  • シートの進行度でドライブされるスタック、深度、パララックス効果
  • シートの進行度と距離値を公開するスクロールヘルパー
  • Capacitor-セーフレイアウト(ノッチ、ホームインジケーター、Androidカットアウト、ソフトウェアキーボード)

用途カバー範囲

用途カバー範囲
用途Capgo シートパターン
長いシート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 ページから下部
フルハイトの下部シート コンテンツ__CAPGO_KEEP_0__
トップ シートcontent-placement="top"
重ねたシートcap-sheet-stack 深さ変数
深さシートcap-sheet-outlet 進捗に応じた変換
パララックス ページcap-sheet-outlet 進捗 cap-scroll ページ
Pageライトボックス
Lightboxcontent-placement="center" シート
Persistent Sheet with Detentdefault-presented, swipe-dismissal="false", and inert-outside="false"
Cardコンパクトなシートのコンテンツ
  • <cap-sheet> presentation state, detents, placement, gestures, accessibility, and events を管理します。
  • <cap-sheet-trigger> present, dismiss, toggle, and detent-step アクションを宣言します。
  • <cap-sheet-view> overlay の位置を設定し、安全なエリアとキーボード オフセットを適用します。
  • <cap-sheet-backdrop> progress-synced バックグラウンドをレンダリングします。
  • <cap-sheet-content> シート サーフェスをレンダリングします。
  • <cap-sheet-handle> ドラッグとキーボード デンテント コントロールを提供します。
  • <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 ソフトウェアキーボードの上に、入力フィールドが表示されます。

The package runs in the web layer. It does not render native UIKit or Android bottom sheets, so your app keeps full styling control while still respecting the WebView constraints that matter in Capacitor.

「デモとプレイグラウンド」

デモとプレイグラウンド

長いシート

デンテントDetents
アニメーション長シートデモ (@capgo/capacitor-シート)アニメーションシート(デテント)デモ for @capgo/capacitor-sheets
サイドバーライトボックス
@capgo/capacitorのアニメーションサイドバー@capgo/capacitorのアニメーションライトボックス

Capgoを使用している場合 capgo/capacitor-sheets ネイティブプラグインの作業を計画するには、__CAPGO_KEEP_0__ Plugin Directoryと接続する Capgo Plugin Directory内でのCapgo製品フローの Capgo Plugins by __CAPGO_KEEP_1__ Capacitor Plugins by Capgoの実装詳細 Capgoの実装詳細については、Capacitor プラグインによって Capgo で管理されます。 プラグインの追加または更新の実装詳細 Ionic Enterprise Plugin Alternatives Ionic Enterprise Plugin Alternativesの製品フロー Capgoネイティブビルド Capgo Capgo製品のワークフローでCapgoネイティブビルドを使用します。