跳至主要內容
版本:v8

ion-app

App 是 Ionic 應用程式的容器元素。每個專案只能有一個 <ion-app> 元素。一個應用程式可以有多個 Ionic 元件,包括選單、標頭、內容和頁尾。覆蓋層元件會在呈現時附加到 <ion-app>

使用 ion-app 可啟用下列行為

  • 鍵盤生命週期事件,無需任何原生外掛程式
  • 硬體返回按鈕監聽器,用於自訂 Android 裝置上的硬體返回按鈕行為
  • Capacitor 或 Cordova 中的狀態列支援,允許使用者點擊狀態列滾動到視圖頂端
  • 滾動輔助工具,用於滾動內容,以便焦點文字輸入不會被螢幕鍵盤覆蓋
  • 在 Material Design 模式下啟用按鈕時的漣漪效果
  • 其他點擊和焦點工具,使使用 Ionic 應用程式的體驗感覺更像原生應用程式

程式化焦點

Ionic 為具有 ion-focusable 類別的元件提供焦點工具。當按下某些鍵盤按鍵(例如 Tab)時,這些工具會自動管理元件的焦點。元件也可以使用 ion-app 中的 setFocus 方法,以程式化的方式響應用戶操作來取得焦點。

屬性

此元件沒有可用的屬性。

事件

此元件沒有可用的事件。

方法

setFocus

描述用於將焦點設定在使用 ion-focusable 的元素上。如果因為鍵盤事件而將焦點設定在元素上,請勿使用此方法,因為焦點工具會為我們處理此操作。當我們希望以程式化的方式設定元素的焦點以響應另一個使用者操作時,應使用此方法。(例如:當使用者呈現快顯視窗時,我們會將焦點設定在快顯視窗內的第一個元素上,但快顯視窗並不總是因鍵盤操作而呈現。)
簽名setFocus(elements: HTMLElement[]) => Promise<void>

CSS 陰影部分

此元件沒有可用的 CSS 陰影部分。

CSS 自訂屬性

此元件沒有可用的 CSS 自訂屬性。

插槽

此元件沒有可用的插槽。