跳至主要內容
版本:v8

ion-header

標頭是頁面的根元件,會將自身對齊至頁面頂端。建議將其用作一個或多個工具列的包裝器,但也可以用來包裝任何元素。當在標頭內部使用工具列時,內容將會進行調整,以確保尺寸正確,且標頭會考量任何裝置安全區域。

基本用法

半透明標頭

標頭可以透過設定 translucent 屬性來符合原生 iOS 應用程式中的透明度。為了看到標頭後方滾動的內容,必須在內容上設定 fullscreen 屬性。此效果僅在模式為 "ios" 且裝置支援 backdrop-filter 時才會套用。

精簡標頭

Ionic 提供原生 iOS 應用程式中的功能,以顯示較大的工具列標題,然後在滾動時將其摺疊為較小的標題。這可以透過新增兩個標頭來完成,一個在內容上方,另一個在內容內部,然後在內容內部的標頭上將 collapse 屬性設定為 "condense"。此效果僅在模式為 "ios" 時才會套用。

淡入淡出標頭

許多原生 iOS 應用程式在工具列上都有淡入淡出效果。這可以透過將標頭上的 collapse 屬性設定為 "fade" 來實現。當頁面首次載入時,標頭上的背景和邊框將會隱藏。當內容滾動時,標頭將會淡入。此效果僅在模式為 "ios" 時才會套用。

此功能也可以與精簡標頭結合使用。屬性 collapse 的值設定為 "fade" 應在內容外部的標頭上。

與虛擬捲動搭配使用

淡入淡出標頭需要捲動容器才能正常運作。當使用虛擬捲動解決方案時,需要提供自訂捲動目標。需要停用內容上的捲動,並將 .ion-content-scroll-host 類別新增至負責捲動的元素。

邊框

"md" 模式中,標頭底部會有一個 box-shadow。在 "ios" 模式中,它會在底部收到一個 border。可以透過將 .ion-no-border 類別新增至標頭來移除這些邊框。

屬性

collapse

描述描述將套用至標頭的捲動效果。僅在 iOS 模式中套用。

通常用於可摺疊大型標題
屬性collapse
類型"condense" | "fade" | undefined
預設值undefined

mode

描述模式決定要使用哪個平台樣式。
屬性mode
類型"ios" | "md"
預設值undefined

translucent

描述如果為 true,則標頭將會是半透明的。僅在模式為 "ios" 且裝置支援 backdrop-filter 時才會套用。

注意:為了使內容在標頭後方滾動,需要在內容上設定 fullscreen 屬性。
屬性translucent
類型boolean
預設值false

事件

此元件沒有可用的事件。

方法

此元件沒有可用的公開方法。

CSS 陰影部分

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

CSS 自訂屬性

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

插槽

此元件沒有可用的插槽。