books/docs/client/router.md

Client-side Routing

The Frappe.js client comes in with a built in router, that is handles via hashing (example #route)

Add a new route

You can add a new route by calling frappe.router.add

Dynamic routes can be added by declaring each parameter as :param in the route string (similar to express.js)

Example

const Page = require('frappejs/frappe/client/view/page').Page;

let todo_list = new Page('ToDo List');

// make the current page active
todo_list.show();

// to do list
frappe.router.add('default', () => {
	app.todo_list.show();
	app.todo_list.list.run();
});

// setup todo form
frappe.router.add('edit/todo/:name', async (params) => {
	app.doc = await frappe.get_doc('ToDo', params.name);
	app.edit_page.show();
	app.edit_page.form.use(app.doc);
});

// setup todo new
frappe.router.add('new/todo', async (params) => {
	app.doc = await frappe.get_doc({doctype: 'ToDo'});
	app.doc.set_name();
	app.edit_page.show();
	app.edit_page.form.use(app.doc, true);
});

Show a route

To set a route, you can call frappe.router.show(route_name)

frappe.router.show(window.location.hash);