Skip to content

Latest commit

 

History

History
117 lines (101 loc) · 5.21 KB

NavigationBar.md

File metadata and controls

117 lines (101 loc) · 5.21 KB

<NavigationBar /> 导航栏

NavigationBar 组件定义一个页面导航条, 用于页面顶部显示页面标题及按钮等。

Props

Prop Type Default Note
View props... NavigationBar 组件继承 View 组件的全部属性。
type string 'ios' 风格类型。
- auto: 自动, 根据操作系统自动选择
- ios: iOS风格
- android: Android风格
显示效果参见Screenshots
title string
element
导航条标题, 可传入字符串或 React Native 组件, 传入字符串时使用<NavigationBar.Title />组件渲染。
titleStyle 同Text.style 导航条标题样式, 当 title 类型为 element 时无效。
leftView element 导航条左视图。
rightView element 导航条右视图。
tintColor string 导航条左、右视图文字与图像颜色, 默认值在 Theme 中设置。
background element 导航条背景视图。
hidden bool false 是否隐藏导航条
animated bool true 显示/隐藏导航条和状态栏时是否有动画效果
statusBarStyle string 'default' 系统状态栏样式(iOS only)。
- default: 默认, 黑色文字或图标。
- light-content: 亮色调, 白色文字或图标。
statusBarColor string 导航条背景颜色, 默认值在 Theme 中设置。
statusBarHidden bool false 是否隐藏系统状态栏, 为 true 时系统状态栏与导航条均不显示。
statusBarInsets bool true 是否自动增加状态栏占位空间(iOS only)。

Static Props

Prop Type Default Note
Title class 导航条标题组件。
Button class 导航条按钮组件。
LinkButton class 导航条链接按钮组件, 继承自 NavigationBar.Button。
IconButton class 导航条图标按钮组件, 继承自 NavigationBar.Button。
BackButton class 导航条返回按钮组件, 继承自 NavigationBar.Button。

<NavigationBar.Title /> Props

Prop Type Default Note
Text props... NavigationBar.Title 组件继承 Text 组件的全部属性。
text string
number
显示文本, 可以是字符串或数字。
numberOfLines number 1 显示行数, 继承自 Text 组件并修改默认值。
allowFontScaling bool false 是否允许系统自动缩放字体大小(iOS only), 继承自 Text 组件并修改默认值。

<NavigationBar.Button /> Props

Prop Type Default Note
TouchableOpacity props... NavigationBar.Button 组件继承 TouchableOpacity 组件的全部属性。
hitSlop 同TouchableOpacity.hitSlop {top: 12, bottom: 12, left: 8, right: 8} 继承 TouchableOpacity 组件并修改默认值。

<NavigationBar.LinkButton /> Props

Prop Type Default Note
NavigationBar.Button props... NavigationBar.LinkButton 组件继承 NavigationBar.Button 组件的全部属性。
title string
number
按钮标题, 可以是字符串或数字。

<NavigationBar.IconButton /> Props

Prop Type Default Note
NavigationBar.Button props... NavigationBar.IconButton 组件继承 NavigationBar.Button 组件的全部属性。
icon 同Image.source 按钮图标。

<NavigationBar.BackButton /> Props

Prop Type Default Note
NavigationBar.Button props... NavigationBar.BackButton 组件继承 NavigationBar.Button 组件的全部属性。
title string
number
标题, 可以是字符串或数字。默认值在 Theme 中设置。
icon 同Image.source 按钮图标, 默认为 iOS 系统返回按钮的样式。

Example

简单用法

<NavigationBar title='Teaset' />

Android风格导航条

<NavigationBar title='Teaset' type='android' />

返回按钮

<NavigationBar title='Teaset' leftView={<NavigationBar.BackButton title='Back' />} />

自定义

<NavigationBar
  style={{backgroundColor: '#eff'}}
  type='ios'
  tintColor='#333'
  title={
    <View style={{flex: 1, paddingLeft: 4, paddingRight: 4, alignItems: 'center'}}>
      <Label style={{color: '#000', fontSize: 15}} text='Teaset' />
      <Label style={{color: '#333', fontSize: 11}}  text='Secondary title' />
    </View>
  }
  leftView={<NavigationBar.IconButton icon={require('../icons/search.png')} />}
  rightView={
    <View style={{flexDirection: 'row'}}>
      <NavigationBar.IconButton icon={require('../icons/edit.png')} />
      <NavigationBar.IconButton icon={require('../icons/trash.png')} />
    </View>
  }
  />

Screenshots