ion-tabs

概要(CONTENTS)

Ionic4项目中我们可以使用Ionic4底部Tabs组件组件ion-tabs对项目进行布局。

ion-tabs官方文档地址:https://ionicframework.com/docs/api/tabs

Tabs are a top level navigation component to implement a tab-based navigation. The component is a container of individual Tab components.

ion-tabs is a styleless component that works as a router outlet in order to handle navigation. This component does not provide any UI feedback or mechanism to switch between tabs. In order to do so, an ion-tab-bar should be provided as a direct child of ion-tabs:

<ion-tabs>
  <ion-tab tab="home">Home Contention-tab>
  <ion-tab tab="settings">Settings Contention-tab>

  <ion-tab-bar slot="bottom">

    <ion-tab-button tab="home">
      <ion-label>Homeion-label>
      <ion-icon name="home">ion-icon>
      <ion-badge>6ion-badge>
    ion-tab-button>

    <ion-tab-button tab="settings">
      <ion-label>Settingsion-label>
      <ion-icon name="settings">ion-icon>
    ion-tab-button>

  ion-tab-bar>
ion-tabs>

Note that both ion-tabs and ion-tab-bar can be used as standalone elements. They don’t depend on each other to work, but they are usually used together in order to implement a tab-based navigation that feels like a native app.

ion-tab-bar always needs slot="bottom" in order to be projected into ion-tabs at the right place.

The "tab" property

Each ion-tab-button will activate one of the tabs when tapped. In order to link the button to the ion-tab container, a matching tab property must be used.

<ion-tab tab="settings">
[...]
<ion-tab-button tab="settings">

This ion-tab-button and ion-tab are now linked by the common tab property.

The tab property identifies each tab, and it has to be unique within the scope of the same ion-tabs. It's important to set the same property to ion-tab and ion-tab-button, even if you are only using one. e.g. You could use the ion-tab-bar without using ion-tabs. In this case you should still give each ion-tab the property of tab="something".

Router integration

When the ionic's router (ion-router) is used, the tab property matches the "component" of ion-route:

The following route within the scope of a ion-tabs outlet:

<ion-route url="/settings-page" component="settings">ion-route>

Would match the following tab:

<ion-tab tab="settings" component="settings-component">ion-tab>

Angular Router integration

Using tabs with Angular's router is fairly straight forward. Here you only need to define tab which is the reference to the route.


<ion-tabs>
  <ion-tab-bar slot="bottom">
    <ion-tab-button tab="schedule">
      <ion-icon name="calendar">ion-icon>
      <ion-label>Scheduleion-label>
    ion-tab-button>
  ion-tab-bar>
ion-tabs>

ion-tabs 用法(Usage)

<ion-tabs>
  <ion-tab-bar slot="bottom">
    <ion-tab-button tab="schedule">
      <ion-icon name="calendar">ion-icon>
      <ion-label>Scheduleion-label>
      <ion-badge>6ion-badge>
    ion-tab-button>

    <ion-tab-button tab="speakers">
      <ion-icon name="contacts">ion-icon>
      <ion-label>Speakersion-label>
    ion-tab-button>

    <ion-tab-button tab="map">
      <ion-icon name="map">ion-icon>
      <ion-label>Mapion-label>
    ion-tab-button>

    <ion-tab-button tab="about">
      <ion-icon name="information-circle">ion-icon>
      <ion-label>Aboution-label>
    ion-tab-button>
  ion-tab-bar>
ion-tabs>
<ion-tabs>

  <ion-tab tab="tab-schedule">
    <ion-nav>ion-nav>
  ion-tab>

  <ion-tab tab="tab-speaker">
    <ion-nav>ion-nav>
  ion-tab>

  <ion-tab tab="tab-map" component="page-map">
    <ion-nav>ion-nav>
  ion-tab>

  <ion-tab tab="tab-about" component="page-about">
    <ion-nav>ion-nav>
  ion-tab>

  <ion-tab-bar slot="bottom">
    <ion-tab-button tab="tab-schedule">
      <ion-icon name="calendar">ion-icon>
      <ion-label>Scheduleion-label>
      <ion-badge>6ion-badge>
    ion-tab-button>

    <ion-tab-button tab="tab-speaker">
      <ion-icon name="contacts">ion-icon>
      <ion-label>Speakersion-label>
    ion-tab-button>

    <ion-tab-button tab="tab-map">
      <ion-icon name="map">ion-icon>
      <ion-label>Mapion-label>
    ion-tab-button>

    <ion-tab-button tab="tab-about">
      <ion-icon name="information-circle">ion-icon>
      <ion-label>Aboution-label>
    ion-tab-button>
  ion-tab-bar>

ion-tabs>
import React from 'react';

import { IonTabs, IonTabBar, IonTabButton, IonIcon, IonLabel, IonBadge } from '@ionic/react';

const Example: React.SFC<{}> = () => (

  <IonTabs>
    <IonTabBar slot="bottom">
      <IonTabButton tab="schedule">
        <IonIcon name="calendar" />
        <IonLabel>ScheduleIonLabel>
        <IonBadge>6IonBadge>
      IonTabButton>

      <IonTabButton tab="speakers">
        <IonIcon name="contacts" />
        <IonLabel>SpeakersIonLabel>
      IonTabButton>

      <IonTabButton tab="map">
        <IonIcon name="map" />
        <IonLabel>MapIonLabel>
      IonTabButton>

      <IonTabButton tab="about">
        <IonIcon name="information-circle" />
        <IonLabel>AboutIonLabel>
      IonTabButton>
    IonTabBar>
  IonTabs>
);

export default Example;
<template>
  
  <ion-tabs @IonTabsWillChange="beforeTabChange" @IonTabsDidChange="afterTabChange">
    <ion-tab tab="schedule">
      <Schedule />
    ion-tab>

    
    <ion-tab tab="speakers" :routes="'app.speakers'">
      <Speakers />
    ion-tab>

    
    <ion-tab tab="map" :routes="['app.map', 'app.other.route']">
      <Map />
    ion-tab>

    
    <ion-tab tab="about" :routes="getMatchedRoutes">
      <About />
    ion-tab>

    
    <template slot="bottom">
      <ion-tab-bar>
        <ion-tab-button tab="schedule">
          <ion-icon name="calendar">ion-icon>
          <ion-label>Scheduleion-label>
          <ion-badge>6ion-badge>
        ion-tab-button>

        
        <ion-tab-button tab="speakers" :to="{ name: 'app.speakers' }">
          <ion-icon name="contacts">ion-icon>
          <ion-label>Speakersion-label>
        ion-tab-button>

        
        <ion-tab-button tab="map" :to="{ name: 'app.map', params: { mode: 'dark' } }">
          <ion-icon name="map">ion-icon>
          <ion-label>Mapion-label>
        ion-tab-button>

        
        <ion-tab-button tab="about" @click="goToAboutTab">
          <ion-icon name="information-circle">ion-icon>
          <ion-label>Aboution-label>
        ion-tab-button>
      ion-tab-bar>
    template>
  ion-tabs>
template>

ion-tabs 事件(Events)

Name Description
ionTabsDidChange Emitted when the navigation has finished transitioning to a new component.
ionTabsWillChange Emitted when the navigation is about to transition to a new component.

ion-tabs 内置方法(Methods)

getSelected

Description

Get the currently selected tab.

Signature getSelected() => Promise

getTab

Description

Get a specific tab by the value of its tab property or an element reference.

Signature getTab(tab: string | HTMLIonTabElement) => Promise

select

Description

Select a tab by the value of its tab property or an element reference.

Signature select(tab: string | HTMLIonTabElement) => Promise

Slots

Name Description
Content is placed between the named slots if provided without a slot.
"bottom" Content is placed at the bottom of the screen.
"top" Content is placed at the top of the screen.