react-navigation/docs/guides/Guide-Headers.md
2017-01-28 00:21:49 +05:30

2.5 KiB

Configuring the Header

In the previous example, we created a StackNavigator to display severals screens in our app.

When navigating to a chat screen, we can specify params for the new route by providing them to the navigate function. In this case we want to provide the name of the person on the chat screen:

this.props.navigation.navigate('Chat', { user:  'Lucy' });

The user param can be accessed from the profile screen:

class ChatScreen extends React.Component {
  const { params } = this.props.navigation.state;
  render() {
    return <Text>Chat with {params.user}</Text>;
  }
}

Setting the Header Title

Next, the header title can be configured to use the screen param:

class ChatScreen extends React.Component {
  static navigationOptions = {
    // // Title may be a simple string:
    // title: 'Hello',

    // Or the title string may be a function of the navigation prop:
    title: ({ navigation }) => `Chat with ${navigation.state.params.user}`
  };
  ...
}
basic-header

Adding a Right Button

Then we can add a header navigation option that allows us to add a custom right button:

static navigationOptions = {
  header: {
    right: <Button title="Info" />,
  },
  ...
header-button

Just like title, the header option can be defined as a function of the navigation prop. Lets render a different button based on the route params, and set up the button to call navigation.setParams when pressed.

static navigationOptions = {
  title: ({ state }) => {
    if (state.params.mode === 'info') {
      return `${state.params.user}'s Contact Info`;
    }
    return `Chat with ${state.params.user}`;
  },
  header: ({ state, setParams }) => {
    // The navigation prop has functions like setParams, goBack, and navigate.
    let right = (
      <Button
        title={`${state.params.user}'s info`}
        onPress={() => setParams({ mode: 'info' })}
      />
    );
    if (state.params.mode === 'info') {
      right = (
        <Button
          title="Done"
          onPress={() => setParams({ mode: 'none' })}
        />        
      );
    }
    return { right };
  },
  ...

Now, the header can interact with the screen route/state:

header-interaction

To see the rest of the header options, see the navigation options document.