ユーザーインターフェイス / コンポーネント / Tab

タブ

このTabsコンポーネントは、iOSとAndroidの両方のプラットフォームに共通のUIを提供しながら、 異なるビュー間を移動する簡単な方法を提供します。 Tabsに適した推奨シナリオは、中間レベルのナビゲーションです。 下部ナビゲーションの詳細と詳細については、マテリアルデザインガイドラインを参照してください。

Tabsコンポーネントの要点

使用法

Tabsコンポーネントは、2つのサブコンポーネントが含まれています。

<Tabs selectedIndex="1">

	<!-- The bottom tab UI is created via TabStrip (the containier) and TabStripItem (for each tab)-->
	<TabStrip>
		<TabStripItem>
			<Label text="Home"></Label>
			<Image src="font://&#xf015;" class="fas"></Image>
		</TabStripItem>
		<TabStripItem class="special">
			<Label text="Account"></Label>
			<Image src="font://&#xf007;" class="fas"></Image>
		</TabStripItem>
		<TabStripItem class="special">
			<Label text="Search"></Label>
			<Image src="font://&#xf00e;" class="fas"></Image>
		</TabStripItem>
	</TabStrip>

	<!-- The number of TabContentItem components should corespond to the number of TabStripItem components -->
	<TabContentItem>
		<GridLayout>
			<Label text="Home Page" class="h2 text-center"></Label>
		</GridLayout>
	</TabContentItem>
	<TabContentItem>
		<GridLayout>
			<Label text="Account Page" class="h2 text-center"></Label>
		</GridLayout>
	</TabContentItem>
	<TabContentItem>
		<GridLayout>
			<Label text="Search Page" class="h2 text-center"></Label>
		</GridLayout>
	</TabContentItem>

</Tabs>
注釈: TabStripItem構成要素数は、tabContentItem構成要素数と等しくなければなりません。

ダイナミックな創造

Tabsコンポーネントをプログラムで作成するには、 それぞれのTabStripItemを作成するために特別なプロパティを使用する必要があります。 これらのプロパティはtitleiconSourceiconClass(対応するLabelImageを作成するために使用されます)です。

	let tabs = new Tabs();
	let tabStrip = new TabStrip();

	let tabStripItem1 = new TabStripItem();
	tabStripItem1.title = "Tab 1";
	tabStripItem1.iconSource = "font://" + String.fromCharCode(charCode1);
	tabStripItem1.iconClass = "far"; // e.g., FontAвесоме

	let tabStripItem2 = new TabStripItem();
	tabStripItem2.title = "Tab 2";
	tabStripItem2.iconSource = "font://" + String.fromCharCode(charCode2);
	tabStripItem2.iconClass = "far"; // e.g., FontAвесоме

	let tabStripItems = [tabStripItem1, tabStripItem2];
	tabStrip.items = tabStripItems;

	let contentItems = [conterntItem1, contentItem2]; // where contentItem1 and 2 are the layouts/frames that holds the actual content

	tabs.tabStrip = tabStrip;
	tabs.items = contentItems;

	let stack = new StackLayout(); // the ""simple rule
	stack.addChild(tabs)
	somePage.content = stack; // base example for adding the newly created Tabs to the current page

デモソース


スタイリング

注釈: nativescript-themeの統合と、カスタムCSSのサポートは現在開発中であり、現在進行中です。

メインのスタイルオプションには、TabStripコンポーネントに設定する必要がある3つの特定のプロパティが導入されています。

これらのプロパティは、CSSを介してインラインで動的に設定できます。

TabStrip {
    selected-item-color: blueviolet;
    un-selected-item-color: brown;
    highlight-color: gold;
}

TabContentItem.first-tabcontent {
    background-color: seashell;
    color: olive;
}
TabContentItem.second-tabcontent {
    background-color: slategray;
    color: aquamarine;
}
TabContentItem.third-tabcontent {
    background-color: blueviolet;
    color: antiquewhite;
}
注釈: 現在、TabStripItem 内の LabelImage コンポーネントには、 backgroundColor, color, fontFamily, fontSize, fontStyle, fontWeight, textTransform のスタイリングプロパティのみを設定することができます。 これらのプロパティの使用法についての詳細は、Styling の記事を参照してください。 これらのプロパティはインラインまたは CSS で設定することができます。
注釈: iOSでは、TabStripItem を個別にスタイル設定することはできません。

デモソース


プロパティ

Tabsのプロパティ

名前タイプ説明
itemsArray<TabContentItem>BottomNavigationの項目を取得または設定します。
selectedIndexnumberBottomNavigationのselectedIndexを取得または設定します。
swipeEnabledbooleanタブのスワイプ有効状態を取得または設定します。
offscreenTabLimitnumberタブのオフスクリーンプリロードタブの数を取得または設定します。
tabStripTabStripBottomNavigationのタブストリップを取得または設定します。
tabsPosition"top", "bottom"タブの位置状態を取得または設定します。デフォルト値:top
iOSTabBarItemsAlignment"leading", "justified", "center", "centerSelected"iOSのみ:iOSのタブバーアイコンのMDCTabBarAlignmentを取得または設定します。デフォルト値:justified

TabStripプロパティ

名前タイプ説明
iosIconRenderingMode"automatic", "alwaysOriginal", "alwaysTemplate"iOSのアイコンレンダリングモードを取得または設定します。
isIconSizeFixedbooleantrueに設定すると、アイコンはプラットフォーム固有の設計ガイドラインに従って固定サイズになります。デフォルト値:true
itemsArray<TabStripItem>TabStrip のストリップ項目の配列を取得または設定します。
highlightColorColor選択した TabStripItem の下線の色を取得または設定します。
selectedItemColorColorタブストリップで選択された項目の色を取得または設定します。
unSelectedItemColorColorタブストリップで選択されていない項目の色を取得または設定します。

TabStripItemプロパティ

名前タイプ説明
titlestringタブストリップエントリのタイトルを取得または設定します。
iconSourcestringタブストリップエントリのアイコンソースを取得または設定します。ローカルイメージパス(~)、リソースイメージ(res://)、アイコンフォント(font://)をサポートします。注:プログラムによるタブの作成に使用されます。
iconClassstringタブストリップエントリのアイコンのCSSクラス名を取得または設定します。注:プログラムによるタブの作成に使用されます。

イベント

Tabsイベント

名前説明
selectedIndexChangedselectedIndexプロパティが変更されたときに発生します。
loadedビューがロードされたときに発生します。
unloadedビューがアンロードされたときに発生します。
layoutChangedレイアウト処理のためにビューのレイアウト境界が変更されたときに発生します。

TabStripイベント

名前説明
itemTapTabStripItemがタップされたときに発生します。

TabStripItemイベント

名前説明
tapTabStripItemがタップされたときに発生します。

APIリファレンス

名前タイプ
TabsClass
TabStripClass
TabStripItemClass
TabContentItemClass

ネイティブコンポーネント

ANDROID IOS
FrameLayout MDCTabBar
入門

コアコンセプト

ユーザーインターフェース

ツール

ハードウェアアクセス

プラグインの開発

リリース

アプリテンプレート

パフォーマンスの最適化

フレームワークモジュール

ガイド

サポートを受ける

トラブルシューティング

Siedkick