メインコンテンツへスキップ
バージョン: v8

ion-header

ヘッダーは、ページの上部に配置されるページのルートコンポーネントです。1つ以上の ツールバー のラッパーとして使用することをお勧めしますが、任意の要素をラップするために使用することもできます。ツールバーがヘッダー内で使用されている場合、コンテンツはサイズが正しくなるように調整され、ヘッダーはデバイスのセーフエリアを考慮します。

基本的な使用方法

半透明ヘッダー

ヘッダーは、translucent プロパティを設定することで、ネイティブ iOS アプリケーションに見られる透明度と一致させることができます。ヘッダーの後ろでコンテンツがスクロールするのを確認するには、コンテンツに fullscreen プロパティを設定する必要があります。この効果は、モードが "ios" で、デバイスが backdrop-filter をサポートしている場合にのみ適用されます。

凝縮されたヘッダー

Ionic は、ネイティブ iOS アプリケーションにある、大きなツールバーのタイトルを表示してから、スクロール時に小さなタイトルに縮小する機能を提供します。これは、コンテンツの上に1つ、コンテンツの内側に1つの、2つのヘッダーを追加し、コンテンツ内のヘッダーの collapse プロパティを "condense" に設定することで実現できます。この効果は、モードが "ios" の場合にのみ適用されます。

フェードヘッダー

多くのネイティブ iOS アプリケーションでは、ツールバーにフェード効果があります。これは、ヘッダーの collapse プロパティを "fade" に設定することで実現できます。ページが最初にロードされると、ヘッダーの背景と境界線が非表示になります。コンテンツがスクロールされると、ヘッダーがフェードインで戻ります。この効果は、モードが "ios" の場合にのみ適用されます。

この機能は、凝縮されたヘッダーと組み合わせることもできます。"fade" に設定された値を持つ collapse プロパティは、コンテンツの外側のヘッダーに設定する必要があります。

仮想スクロールでの使用

フェードヘッダーが正しく機能するには、スクロールコンテナーが必要です。仮想スクロールソリューションを使用する場合、カスタムのスクロールターゲットを提供する必要があります。コンテンツのスクロールを無効にし、スクロールを担当する要素に .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カスタムプロパティはありません。

スロット

このコンポーネントで利用可能なスロットはありません。