源碼在此 僅供參考
一、簡介
根據React Navigation官網文檔描述:Learn once, navigate anywhere.
React Navigation的誕生,源于React Native社區(qū)對基于Javascript的可擴展且使用簡單的導航解決方案的需求。
React Navigation是Facebook,Expo和React社區(qū)的開發(fā)者們合作的結果:它取代并改進了React Native生態(tài)系統(tǒng)中的多個導航庫,其中包括Ex-Navigation,React Native的Navigator和NavigationExperimental組件。
內置導航器
react-navigation包含以下功能來幫助你創(chuàng)建導航器:
- StackNavigator - 一次只渲染一個頁面,并提供頁面之間跳轉的方法。 當打開一個新的頁面時,它被放置在堆棧的頂部
- TabNavigator - 渲染一個選項卡,讓用戶可以在幾個頁面之間切換
- DrawerNavigator - 提供一個從屏幕左側滑入的抽屜
使用導航頂層組件
導航器渲染的僅僅是React組件對應的應用頁面。
要了解如何創(chuàng)建頁面,請閱讀以下內容:
- Screen navigation prop 允許調用調用導航操作,例如打開另一個頁面
- Screen navigationOptions 定制導航器顯示如何顯示(例如標題欄的標題,選項卡的標簽)
二、使用
上面介紹了很多,你可以點進去看StackNavigator、TabNavigator等它們的內容屬性,屬性有點多,這里就不累贅羅列了,具體可以參考這篇文章:react-navigation使用技巧 寫得很好~
直接上效果:

使用步驟如下:
- 導入依賴庫
在項目Terminal中輸入命令行:
npm install react-navigation --save
然后在package.json文件中就可以看到,依賴庫已經導入完畢:
"react-native-tab-navigator": "^0.3.4",
接下來就可以愉快地使用react-navigation來進行頁面導航了。
- 配置Navigator
- 在項目的入口中直接配置StackNavigator,StackNavigator中注冊所有需要跳轉的界面,在這個項目中還有注冊登錄功能,在效果圖中沒有展示,這里不作探討。首先是入口文件:
import React from 'react';
import {StackNavigator} from 'react-navigation';
import {TabNav} from "./RootPage";
import LoginPage from "./page/Login/loginPage";
import RegPage from "./page/Login/regPage";
import {FindAccountPage} from "./page/Login/findAccountPage"; // 路由導航
const App = StackNavigator({
Login: {screen: LoginPage}, // 登錄頁
Reg: {screen: RegPage}, // 注冊頁
FindAccount: {screen: FindAccountPage}, // 找回密碼頁
Main: {
screen: TabNav,
navigationOptions: ({navigation}) => ({
header: null
})
}
},
{
initialRouteName: 'Login',
headerMode: 'screen'
});
export default App;
上面可以注意到TabNav,也就是TabNavigator,是作為一個screen參數的值傳入到StackNavigator中,在上面提到的navigationOptions的配置中,我們將header設置為null,也就是不要標題欄。
- 接著進入到配置TabNavigator的RootPage中:
import React from 'react';
import {TabNavigator} from 'react-navigation';
import HomePage from './page/Home/HomePage';
import FriendPage from './page/Friend/FriendPage';
import TaskPage from './page/Task/TaskPage';
import MinePage from './page/Mine/MinePage';
import DealPage from './page/Deal/DealPage';
export const TabNav = TabNavigator(
{
Home: {
screen: HomePage,
},
Task: {
screen: TaskPage,
},
Friend: {
screen: FriendPage,
},
Deal: {
screen: DealPage,
},
Mine: {
screen: MinePage,
}
},
{
tabBarOptions: {
//當前選中的tab bar的文本顏色和圖標顏色
activeTintColor: '#4BC1D2',
//當前未選中的tab bar的文本顏色和圖標顏色
inactiveTintColor: '#000',
//是否顯示tab bar的圖標,默認是false
showIcon: true,
//showLabel - 是否顯示tab bar的文本,默認是true
showLabel: true,
//是否將文本轉換為大小,默認是true
upperCaseLabel: false,
//material design中的波紋顏色(僅支持Android >= 5.0)
pressColor: '#788493',
//按下tab bar時的不透明度(僅支持iOS和Android < 5.0).
pressOpacity: 0.8,
//tab bar的樣式
style: {
backgroundColor: '#fff',
paddingBottom: 1,
borderTopWidth: 0.2,
paddingTop:1,
borderTopColor: '#ccc',
},
//tab bar的文本樣式
labelStyle: {
fontSize: 11,
margin: 1
},
//tab 頁指示符的樣式 (tab頁下面的一條線).
indicatorStyle: {height: 0},
},
//tab bar的位置, 可選值: 'top' or 'bottom'
tabBarPosition: 'bottom',
//是否允許滑動切換tab頁
swipeEnabled: true,
//是否在切換tab頁時使用動畫
animationEnabled: false,
//是否懶加載
lazy: true,
//返回按鈕是否會導致tab切換到初始tab頁? 如果是,則設置為initialRoute,否則為none。 缺省為initialRoute。
backBehavior: 'none',
});
在這里我們可以看到,我們將底部導航的屬性基本都用上了,這是為了方便大家在使用時作適合自己的選擇,畢竟需求不一樣,不過這個效果是可以接受的了~
- 在這個界面中導入了其他五個子界面,每個子界面效果可以設置成差不多,例如下面這樣:
import React, {Component} from 'react';
import {
View,
Text,
Image,
StyleSheet,
} from 'react-native';
export default class FriendPage extends Component {
static navigationOptions = {
tabBarLabel: '好友',
tabBarIcon: ({focused}) => {
if (focused) {
return (
<Image style={styles.tabBarIcon} source={require('../../img/fri_sel.png')}/>
);
}
return (
<Image style={styles.tabBarIcon} source={require('../../img/fri_nor.png')}/>
);
},
};
render() {
return (
<View style={styles.container}>
<Text>這是好友</Text>
</View>
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
flexDirection: 'column',
justifyContent: 'center',
alignItems: 'center',
},
tabBarIcon: {
width: 21,
height: 21,
}
});
在子界面中可以設置icon圖標樣式,表示在點擊前后顏色的改變,效果如下:



當然,我們也可以設置標題欄,只需要在下面代碼中添加headerTitle屬性:
export default class FriendPage extends Component {
static navigationOptions = {
tabBarLabel: '好友',
headerTitle: '好友',
tabBarIcon: ({focused}) => { ...
別忘了,在StackNavigator配置TabNavigator時不要設置header為null即可。
Main: {
screen: TabNav,
navigationOptions: ({navigation}) => ({
// header: null
})
}
關于DrawerNavigator,用到的情況比較少,就不展開說了,可以參考下面這個Demo 傳送門
三、總結 & 題外話
總的來說,react-navigation這個庫并不復雜,關鍵在于你需要將它封裝成為符合自己項目需求的框架樣式,后續(xù)的功能才能依次往里添加和實現。有些坑還是需要自己踩的,不過踩的坑基本都忘記了,可能痛苦的經理人總是本能想著忘記吧,哈哈又扯遠了,剛開始學RN,求大神們別嘲諷哈,不過認真完成一件事情,的確有很高的成就感呢~繼續(xù)加油!