Skip to main content
Version: v7

ion-back-button

shadow

Back Buttonは、クリックされるとアプリの履歴に戻るようにナビゲートします。このボタンは、ナビゲーションスタックに履歴があるときのみ表示されます。ただし、 defaultHref が設定されている場合は除きます。戻るボタンはモードに応じて異なるテキストとアイコンを表示しますが、これはカスタマイズすることができます。

基本的な使い方

カスタムのBack Button

デフォルトでは、Back Buttonはテキスト "Back" と共に、ios では "chevron-back" アイコン、md では "arrow-back-sharp" アイコンを表示します。これは、iconまたはtextプロパティを設定することで、戻るボタンコンポーネントごとにカスタマイズすることができます。また、グローバル設定の backButtonIcon または backButtonText プロパティを使用して、グローバルに設定することもできます。詳しくは、Config docs を参照してください。

デフォルトのBack履歴

時折、アプリが履歴がないときに戻るボタンを表示し、ナビゲートする必要がある場合があります。この場合、戻るボタンの defaultHref をパスに設定することで実現できます。 defaultHref を使用するには、アプリにパスが設定されたルーターが含まれている必要があります。

プロパティ

color

Descriptionアプリケーションのカラーパレットから使用する色を指定します。デフォルトのオプションは以下の通りです。 "primary", "secondary", "tertiary", "success", "warning", "danger", "light", "medium", と "dark" です.色に関する詳しい情報は theming を参照してください。
Attributecolor
Type"danger" | "dark" | "light" | "medium" | "primary" | "secondary" | "success" | "tertiary" | "warning" | string & Record<never, never> | undefined
Defaultundefined

defaultHref

Description履歴がない場合に、デフォルトで戻るためのURL。
Attributedefault-href
Typestring | undefined
Defaultundefined

disabled

Descriptiontrueの場合、ユーザはボタンと対話することができません。
Attributedisabled
Typeboolean
Defaultfalse

icon

Description戻るボタンに使用する内蔵の名前付きSVGアイコン名またはSVGファイルの正確なsrcを指定します。
Attributeicon
Typenull | string | undefined
Defaultundefined

mode

Descriptionmodeは、どのプラットフォームのスタイルを使用するかを決定します。
Attributemode
Type"ios" | "md"
Defaultundefined

routerAnimation

Descriptionルーターを使用する場合、別のページに移動する際の遷移アニメーションを指定します。
Attributeundefined
Type((baseEl: any, opts?: any) => Animation) | undefined
Defaultundefined

text

Descriptionバックボタンに表示するテキストです。
Attributetext
Typenull | string | undefined
Defaultundefined

type

Descriptionボタンの種類です。
Attributetype
Type"button" | "reset" | "submit"
Default'button'

イベント

No events available for this component.

メソッド

No public methods available for this component.

CSS Shadow Parts

NameDescription
icon戻るボタンのアイコン(ion-iconを使用)。
nativeすべての子要素を包むネイティブ HTML ボタン要素。
text戻るボタンのテキストです。

CSSカスタムプロパティ

NameDescription
--backgroundボタンの背景
--background-focusedタブキーでフォーカスしたときのボタンの背景
--background-focused-opacityタブキーでフォーカスしたときのボタンの背景の不透明度
--background-hoverホバー時のボタンの背景
--background-hover-opacityホバー時の背景の不透明度
--border-radiusボタンの境界半径
--colorボタンの文字色
--color-focusedタブキーでフォーカスしたときのボタンの文字色
--color-hoverホバー時のボタンの文字色
--icon-font-sizeボタンアイコンのFont Size
--icon-font-weightボタンアイコンのFont Weight
--icon-margin-bottomボタンアイコンのBottom Margin
--icon-margin-endボタンアイコンの方向が左から右の場合はRight Margin、右から左の場合はLeft Margin
--icon-margin-startボタンアイコンの方向が左から右の場合はLeft Margin、右から左の場合はRight Margin
--icon-margin-topボタンアイコンのTop Margin
--icon-padding-bottomボタンアイコンのBottom Padding
--icon-padding-endボタンアイコンの向きが左から右の場合はRight Padding、右から左の場合はLeft Paddingを使用します。
--icon-padding-startボタンアイコンの方向が左から右の場合はLeft Padding、右から左の場合はRight Paddingを使用します。
--icon-padding-topボタンアイコンのTop Padding
--margin-bottomボタンのBottom Margin
--margin-endボタンの向きが左から右の場合はRight Margin、右から左の場合はLeft Margin
--margin-startボタンの向きが左から右の場合はLeft Margin、右から左の場合はRight Margin
--margin-topボタンのTop Margin
--min-heightボタンの最小高さ
--min-widthボタンの最小幅
--opacityボタンの不透明度
--padding-bottomボタンのBottom Padding
--padding-endボタンの向きが左から右の場合はRight Padding、右から左の場合はLeft Paddingとなります。
--padding-startボタンの向きが左から右の場合はLeft Padding、右から左の場合はRight Paddingとなります。
--padding-topボタンのTop Padding
--ripple-colorボタンリプルエフェクトの色
--transitionボタンの遷移

Slots

No slots available for this component.