Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

2.9.0 - 2018-07-20

Added

headerLayoutPreset: 'center' | 'left' to provide an easy solution for questions like this.
headerBackTitleEnabled - this configuration option for stack navigator allows you to force back button titles to either be rendered or not (if you disagree with defaults for your platform and layout preset).

Fixed

Android back button ripple is now appropriately sized (fixes #3955).
Respect header background color on container (fixes edge case where user depended on displaying content that was rendered behind the navigator, this particular behavior should not be depended on and may break in the future, but this change is still useful regardless).

2.8.0 - 2018-07-19

Added

headerLeftContainerStyle, headerTitleContainerStyle, and headerRightContainerStyle are exposed on navigationOptions. These properties allow you to customize the style of the container of headerLeft, headerTitle and headerRight components.

Fixed

Fixed memory leaks in createNavigator: closure scope leak, and clean up old descriptors.

2.7.0 - 2018-07-17

Added

The enableURLHandling prop on the top level navigator component allows you to disable deep linking handling. Currently it is always enabled. To disable it, <RootNavigator enableURLHandling={false} />

Changed

StackNavigator.replace method no longer requires a key param. If the key is left undefined, the last screen in the stack will be replaced.

Fixed

Support headerLeft component for the first screen in a stack (#4608).
Removed bottomBorder when headerTransparent is set to true.
Improve empty path and param handling in deep linking (#4671). This fixes issues with deep linking and fully tests the differences between path: '' and path: null. Empty string matches empty paths, and null path will let the child router handle paths at the same level. Also it makes sure that params are not duplicated between path and query when they are serialized with getPathAndParamsForState.
Fix onTransitionStart not being invoked when provided in navigator config.(#4100)
Rare case when users navigated back and forth quickly with exactly the right timing would cause a crash due to a scene being queued to transition, then clobbered, then attempted to render as a stale scene but without a descriptor. (commit)

2.6.2 - 2018-07-06

Changed

Relax vertical padding warnings on header.

2.6.1 - 2018-07-05

Added

Warn for more invalid headerStyle properties (padding, top/right/bottom/left, position).

Fixed

Fixed missing header shadow on Android.

2.6.0 - 2018-07-04

Added

NavigationEvents component as a declarative interface for subscribing to navigation focus events.

Fixed

Fix stack router child router delegation priority (https://github.com/react-navigation/react-navigation/commit/e8c1833053e37d28f0ce505ff323565abf23b6a2)
Avoid crash when calling isFocused on old route (https://github.com/react-navigation/react-navigation/commit/0921889f7a3acfc6d6bcc4909d209eeeee985ba7)
Stack router no longer attempts to parse query params within path handling
Switch router now has exact same param treatment for URLs as stack router does

Changed

Internally we no longer need to special case PlatformHelpers by platform as react-native-web handles the APIs we mocked out with it now.

2.5.5 - 2018-06-27

Added

Throw error in development mode when header navigation option is set to a string - a common mistake that would otherwise result in a cryptic error message.
Throw error in development mode when title is not a string.

Fixed

Delegate to child routers for more than just the top screen in the stack.
Update react-navigation-drawer to 0.4.3 to fix initialRouteParams option

2.5.4 - 2018-06-27

Fixed

Header no longer sometimes flashes for 1 frame when using header: null on initial route of stack with floating header.
Export createSwitchNavigator in react-navigation.web.js

2.5.3 - 2018-06-23

Fixed

setParams applies to the navigation object it is called on even if that is the navigation object for a navigation view (more details in react-navigation#4497)

2.5.2 - 2018-06-23

Fixed

Update react-navigation-drawer to fix regression in toggleDrawer

2.5.1 - 2018-06-22

Fixed

transitionConfig in stack navigator no longer passes incorrect fromTransitionProps when navigating back

2.5.0 - 2018-06-22

Changed

Refactor internals to make it play more nicely with web

Fixed

const defaultGetStateForAction = SwitchBasedNavigator.router.getStateForAction no longer throws error.
Updated react-navigation-drawer to 0.4.1 which should fix issues related to automatically closing drawer when changing routes.

2.4.1 - 2018-06-21

Changed

Improved examples