Navbar React コンポーネント
Navbar は、ページタイトルとナビゲーション要素を含む、画面上部の固定(Fixed および Through レイアウトタイプの場合)領域です。
Navbar React コンポーネントは、Navbar コンポーネントを表します。
Navbar コンポーネント
以下のコンポーネントが含まれています。
Navbar
NavLeft
NavRight
NavTitle
NavTitleLarge
Navbar プロパティ
プロパティ | タイプ | デフォルト | 説明 |
---|---|---|---|
<Navbar> プロパティ | |||
title | string | Navbar タイトル | |
subtitle | string | Navbar サブタイトル | |
backLink | boolean string | テキスト付きの戻るリンクを追加します(string 値が指定されている場合) | |
backLinkUrl | string | カスタムの戻るリンク URL | |
backLinkForce | boolean | false | ページを強制的にロードし、履歴内の前のページを無視します |
backLinkShowText | boolean | デフォルトでは、MDテーマでは戻るリンクテキストは無効です | |
sliding | boolean | true | ナビ要素に「スライディング」効果を有効にします |
outline | boolean | true | iOSテーマ用にNavbarの下部に薄い境界線(ヘアライン)を追加します |
hidden | boolean | false | Navbar を非表示にします |
innerClass | string | navbar-inner 要素に追加のクラスを追加します | |
innerClassName | string | innerClass プロパティのエイリアス | |
large | boolean | 大きなタイトル付きのNavbarを有効にします | |
transparent | boolean | Navbar を透明にします。大きなNavbarを透明にするためにlarge プロパティに追加して使用できます。 | |
titleLarge | string | Navbar の大きなタイトルテキスト。指定しない場合は、title プロパティと同じになります | |
<NavLeft> プロパティ | |||
backLink | boolean string | テキスト付きの戻るリンクを追加します(文字列値が指定されている場合) | |
backLinkUrl | string | カスタムの戻るリンク URL | |
backLinkForce | boolean | false | ページを強制的にロードし、履歴内の前のページを無視します |
backLinkShowText | boolean | デフォルトでは、MDテーマでは戻るリンクテキストは無効です | |
sliding | boolean | 「スライディング」効果を有効にします。デフォルトでは、親の Navbar の sliding プロパティを継承します | |
<NavTitle> プロパティ | |||
title | string | 要素の内部タイトルテキストを指定します(子要素がない場合に影響します) | |
subtitle | string | サブタイトルテキスト | |
sliding | boolean | 「スライディング」効果を有効にします。デフォルトでは、親の Navbar の sliding プロパティを継承します | |
<NavRight> プロパティ | |||
sliding | boolean | 「スライディング」効果を有効にします。デフォルトでは、親の Navbar の sliding プロパティを継承します |
Navbar メソッド
<Navbar> メソッド | |
---|---|
.hide(animate) | Navbar を非表示にします |
.show(animate) | Navbar を表示します |
.size() | Navbar のサイズを調整します |
Navbar イベント
イベント | 説明 |
---|---|
<Navbar> イベント | |
backClick clickBack | Navbar の戻るリンクがクリックされた後にイベントがトリガーされます |
navbarHide | Navbar が非表示になったときにイベントがトリガーされます |
navbarShow | Navbar が表示されたときにイベントがトリガーされます |
navbarCollapse | 大きなタイトル付きのNavbarが折りたたまれたとき(大きなNavbarから通常のNavbarへ)にイベントがトリガーされます |
navbarExpand | 大きなタイトル付きのNavbarが展開されたとき(通常のNavbarから大きなNavbarへ)にイベントがトリガーされます |
<NavLeft> イベント | |
backClick clickBack | Navbar の戻るリンクがクリックされた後にイベントがトリガーされます |
Navbar スロット
Navbar React コンポーネント(<Navbar>
)には、カスタム要素用の追加のスロットがあります
default
- 要素は<div class="navbar-inner">
要素の子として挿入されますbefore-inner
- 要素は<div class="navbar-inner">
要素の直前に挿入されますafter-inner
- 要素は<div class="navbar-inner">
要素の直後に挿入されますleft
- 要素は Navbar の左側の要素に挿入されますright
- 要素は Navbar の右側の要素に挿入されますtitle
- 要素は Navbar のタイトル要素に挿入されますtitle-large
- 要素は Navbar の大きなタイトルテキスト要素に挿入されます
<Navbar title="My App">
<a href="#" slot="left">Left Link</a>
<a href="#" slot="right">Right Link</a>
<div slot="before-inner">Before Inner</div>
<div slot="after-inner">After Inner</div>
<div>Default slot</div>
</Navbar>
{/* Renders to: */}
<div class="navbar">
<div class="navbar-bg"></div>
<div>Before Inner</div>
<div class="navbar-inner">
<div class="left">
<a href="#">Left Link</a>
</div>
<div class="title">My App</div>
<div class="right">
<a href="#">Right Link</a>
</div>
<div>Default slot</div>
</div>
<div>After Inner</div>
</div>
例
最小限のレイアウト
<Navbar title="My App"></Navbar>
戻るリンク付きの最小限のレイアウト
<Navbar title="My App" backLink="Back"></Navbar>
「スライディング」トランジション効果なし(iOSテーマのみに影響します)
<Navbar title="My App" backLink="Back" sliding="{false}"></Navbar>
右パネルを開くための追加の右リンク付き
<Navbar title="My App" backLink="Back">
<NavRight>
<Link icon="icon-bars" panelOpen="right"></Link>
</NavRight>
</Navbar>
{/* or */}
<Navbar title="My App" backLink="Back">
<Link slot="right" icon="icon-bars" panelOpen="right"></Link>
</Navbar>
大きなタイトル付き
<Navbar title="My App" backLink="Back" large></Navbar>
{/* with different large title text */}
<Navbar title="My App" backLink="Back" large titleLarge="Large Title"></Navbar>
3つの部分すべて
<Navbar>
<NavLeft backLink="Back"></NavLeft>
<NavTitle>My App</NavTitle>
<NavRight>
<Link icon="icon-bars" panelOpen="right"></Link>
</NavRight>
</Navbar>
フルカスタムレイアウト
<Navbar>
<NavLeft>
<Link>Left Link</Link>
</NavLeft>
<NavTitle>My App</NavTitle>
<NavRight>
<Link>Right Link</Link>
</NavRight>
</Navbar>