登録設定
まず基本的な初期化を確認してください。以下は同じ登録に対する設定です。コンポーネントに必要なものだけを追加します。
任意の動作
任意とはデフォルト値があるという意味であり、UIが変化する場合に通知を省略できるという意味ではありません。たとえば、タブバーの位置が変わらなくてもタブの選択は外観を変えるため、選択成功の通知をreceiveListeners.updateに含めます。
| 入力 | 省略時 | 設定する場面と理由 |
|---|---|---|
receiveListeners |
プラグインイベントを購読しません。初期の表示意図はネイティブビューの可視性から決まり、内部のDOM・スクロール処理は動作します。 | タブ選択で強調項目が変わる場合、updateで画像とバインド値を更新し、projectionで表示を変更し、matchでサーフェスごとに振り分けます。イベントの接続とCordovaガイドのreceive転送を参照してください。 |
readValues |
ネイティブからDOMへの値の読み取りを行いません。 | フォールバックが非表示の間にネイティブのトグルが変化する場合、現在の状態を読み取り、再表示時に古い値に戻らないようにします。値のバインディングを参照してください。 |
values |
readValuesがあれば、返されたすべてのキーをdata-native-ui-value-*属性にします。readValuesがなければ値を反映しません。 |
カスタム要素が属性ではなくcheckedから描画する場合、そのキーをホストのプロパティに対応付けます。アプリケーションイベントは生成しません。 |
captureDelayMs |
50 msのデバウンス後に画像を準備します。 | 選択イベントの時点でタブの強調表示がまだアニメーション中なら、ピクセルが安定するまで待ちます。キャプチャのタイミングを参照してください。オーバーレイの表示開始は遅らせません。 |
canCapture |
trueを返します。Engineによるジオメトリとプラットフォームの確認は引き続き適用されます。 | SDKがキャプチャ可能な静的コンテンツから制限付き動画へ切り替わる場合、不適切なキャプチャを防ぎます。現在のコンテンツの適格性を返してください。 |
failedFallback |
適切な画像がなければ通常のWebフォールバックを使います。 | SDKビューに利用可能なWebの代替がない場合、レンダラーが配置を維持しているときに限り、自動的な移動中もネイティブ表示を維持します。明示的なWebの被覆とnoneが優先されます。失敗時の方針を参照してください。 |
allowedOrigins |
Capacitor: 同梱のserver.urlまたはローカルのホスト名とスキーム。アプリのserver設定がなければlocalhostのデフォルト。Cordova: localhostのデフォルト。 |
プログラムによる設定や、信頼するオリジンを狭める場合に上書きします。Androidではナビゲーション前にinstallで設定し、登録がそれを継承します。オリジンの照合を参照してください。 |
runtime |
Capacitor。 | Cordova連携では必須です。通知とリソースURLでCordovaの転送方式を使うよう、Cordovaを選択します。 |
captureMode (Android) |
背景の表示も含むCOMPOSITED。 |
不透明なカードが周囲のコンテンツを横切ってスクロールする場合、VIEWはウィンドウの周囲のピクセルを含めず、カードだけをキャプチャします。半透明コンテンツ、動画、SurfaceViewには使わないでください。キャプチャの適格性を参照してください。 |
Engineは表示意図とコンポーネントの値を別々に公開します。いずれもアプリ側のEngineラッパーは不要です。Ionicオーバーレイの検出は登録引数ではなく、個別に有効化する共有初期化関数です。アプリが管理するオーバーレイでは、プラグインからpause/resumeを再エクスポートし、アプリがオーバーレイの前後で明示的に呼び出せるようにします。