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 自訂屬性。
插槽
此元件沒有可用的插槽。