navigation

Initial release of NavigationReactNative

New

• #96 Changed build task to use Rollup instead of Browserify
• #104 Removed byte order mark from npm package entry point

New

• #96 Changed build task to use rollup instead of browserify
• #102 Allowed construction of navigation links with pre-populated crumb trails (fluent navigation)

Fixed

• #95 Improved performance of navigation link construction
• #104 Removed byte order mark from npm package entry point

Changed

If you don’t use the crumb trail then this is a non-breaking release

• #111 Passed new navigation data to truncateCrumbTrail
• #112 Removed automatic crumb trail truncation. You can use the following to revert to the previous crumb trail truncation behaviour:

for(var key in stateNavigator.states) {
    stateNavigator.states[key].truncateCrumbTrail = function(state, data, crumbs) {
        var newCrumbs = [];
        for (var i = 0; i < crumbs.length; i++) {
            if (crumbs[i].state === state)
                break;
            newCrumbs.push(crumbs[i]);
        }
        return newCrumbs;
    }
}

New

• #77 Added Constraints. Attached a validate function to a State that can check the navigation data. Navigation to a State is only allowed if validate returns true

Fixed

• #77 Removed crumb trail from Crumb data
• #82 Allowed applicationPath without a leading slash in HTML5HistoryManager

Changed

• #77 Removed route sorting. Routes are matched in configuration order with constraints providing added match control

Fixed

• #78 Catered for Date and Array navigation data in active checks on Navigate and Refresh Links
• #79 Prevented redundant re-rendering of Link components

New

• #74 Passed async data into onNavigate handlers

Fixed

• Removed Unknown Prop Warning

Fixed

• Removed ReactDOM dependency by replacing findDOMNode with ref callback
• Rendered anchor instead of span when active Link disabled

A redesign of the Navigation router that makes it easier to use and understand. See the documentation for details.

New

• #44 Accepted Dates in NavigationData. They're converted to yyyy-mm-dd in the URL
• #45 Added urlEncode and urlDecode functions to StateHandler for customised URL encoding

Fixed

• #42 Accepted array-specific default types, e.g., 'stringarray' and 'numberarray'

Changed

• #42 Repeated query string parameters for NavigationData arrays, e.g., /?x=a&x=b. To revert to the old behaviour, set the new combineArray Navigation setting to false

Applies to NavigationJS, NavigationAngular, NavigationKnockout and NavigationReact

New

• #34 NavigationJS Added old State, old Dialog, old data and previous data to the StateContext
• #35 NavigationJS Added optional historyAction parameter to navigation functions. Pass HistoryAction.Replace to replace the current Url or HistoryAction.None to leave it unchanged
• #35 Navigation Plugins Added history action attribute to Hyperlinks. Set ‘Replace’ to replace the current Url when clicked or ‘None’ to leave it unchanged
• #36 NavigationJS Added title to StateContext for dynamically setting document title

Fixed

• #36 NavigationJS Set document title after history added
• #37 Navigation Plugins Differentiated empty string from null in active Hyperlink check

Changed

• #34 NavigationJS Added tracking of previous State and data when navigating back and refreshing. To revert to the old behaviour, set the new trackAllPreviousData Navigation setting to false
• #39 NavigationReact Updated to React 0.14, introducing a dependency on react-dom

Applies to NavigationAngular, NavigationKnockout and NavigationReact

New

• #20 Re-evaluated Hyperlinks when they're clicked instead of after each navigation to improve performance
• #26 Allowed active Hyperlinks to be styled, either by disabling or with the addition of a css class. Only Refresh and Transition Hyperlinks can become active.
• #28 Added a navigating attribute to Hyperlinks that's called prior to the navigation, allowing the navigation and/or default to be cancelled

Fixed

• #22 Ignored Hyperlink clicks triggered by non-left mouse buttons or when a keyboard modifier was pressed

New

• #14 Stored the Previous State and Return Data in the Crumb Trail, making a single QueryString parameter for all crumb trail tracking. Enabled using the new combineCrumbTrail Navigation setting.
• #15 Allowed customised crumb trail persistence with new CrumbTrailPersister base class and crumbTrailPersister Navigation setting. Created localStorage persister implementation, StorageCrumbTrailPersister.
• #16 Added unloading function to State to, for example, allow the current State to cancel the navigation when there are pending changes. Added history flags to unloading and navigating State functions to indicate a browser history navigation so the Url can be reset if cancelled. Ensured HistoryManagers reset the Url if addHistory called with nulls.
• #17 Improved Route Build Performance by removing the RegExp dependency.
• #18 Allowed a State to have more than one Route. Without multiple routes couldn't support {x}/y/{z} with optional y and z. With multiple routes: ['{x}', '{x}/y/{z}'].
• #19 Added a trackTypes property to State to disable the tracking of NavigationData types in the Url. Default types are still honoured. Setting a default type of 'number', passed strings will be converted to numbers.
• #23 Allowed async data retrieved in a State's navigating function to be passed directly to the State's navigated function.

Initial release of NavigationJS, NavigationAngular, NavigationKnockout and NavigationReact