navigate

navigate

A router for the browser (client-side JavaScript).

• Overview
• Installation
• API
• Development

Overview

• Has no dependencies.
• Supports Asynchronous Module Loader (AMD, RequireJS), CommonJS (Node.js require) and regular <script> loading.
• If HTML5 History API is not available, falls back to hashes.
• Handles click events on same origin links.
• Tested on these browsers:
  • Mozilla Firefox 1.0+
  • Opera 8.00+
  • Google Chrome 1+
  • Microsoft Internet Explorer 6+
  • Apple Safari 3.0+

Installation

Install manually by adding to your HTML file:

<script src="/path/to/navigate/navigate.js"></script>

Install with npm:

$ npm install --save navigate

Install with component:

$ component install jakutis/navigate

Install with bower:

$ bower install --save navigate

API

// configure, can be called anytime at all (including never)
navigate({
    // whether same origin a.href clicks are captured
    clickHandlingEnabled : true,
    // URL path prefix
    basePath : ''
});

// initialize
navigate();

// get current page (also initialize, if not initialized)
navigate(function(entryPage) {
    console.log('Entry page to this web app is ' + entryPage);
});

// handle navigations to /user/* pages
navigate(/^\/user\/(.+)$/, function(args, from, to) {
    console.log('Navigated from page ' + from + ' to ' + to);
    console.log('Showing user ' + args[0]);
});

// navigate to user's "tahu" page
navigate('/user/tahu');

Development

TODO