To help you get started, we've collected the most common ways that senna is being used within popular public projects.

uyuni-project / uyuni / web / html / src / manager / shared / spa / spa-engine.js View on Github

window.pageRenderers.spa.init = function init() {
  const appInstance = new App();
  appInstance.setLinkSelector("a.js-spa");
  appInstance.setFormSelector("");
  appInstance.addSurfaces(["left-menu-data", "ssm-box", "page-body"])
  appInstance.addRoutes([{
    path: /.*/,
    handler: function (route, a, b) {
      const screen = new HtmlScreen();
      screen.setCacheable(false);
      return screen;
    }
  }]);

  appInstance.on('endNavigate', function(navigation) {
    // workaround to redirect to the login page when there is no session:
    // More info: https://github.com/liferay/senna.js/issues/302
    const urlPath = appInstance.browserPathBeforeNavigate;

View more ways to use senna

⚠️ In the future, the senna npm package will be deprecated. Development continues in the liferay/liferay-portal repo (more specifically, inside the frontend-js-spa-web module), but not as an independent project, in order to better integrate with and serve the needs of Liferay DXP. At the time of writing, the last official release of the npm packages was v2.7.9, from the 2.x series on the master branch, and it is still used by a number of pre-EOL versions of Liferay DXP, such as 7.0.x, 7.1.x, 7.2.x, and 7.3.x. Any future maintenance releases of the senna npm package will be produced from this repo, and the old repo at liferay/senna.js will be archived (marked as read-only).

Senna.js

Senna.js is a blazing-fast single page application engine that provides several low-level APIs that allows you to build modern web-based applications with only ~15 KB of JavaScript without any dependency.

• Official website
• Website repository
• Documentation
• API Docs

Support and Project status

Senna.js is widely used and well maintained internally at Liferay but does not currently have staffing to support the open source release. As such this project is mostly internal and support is minimal. For certain issues, like build integration we are in an especially bad position to offer support.

To get assistance you can use any of the following forums

1. Look through the documentation.
2. File an issue on GitHub

We will try our best, but keep in mind that given our support staffing, we may not be able to help.

Install

Install via npm, Bower, CDN or download as a zip:

npm install senna

Examples

• Email Example: Enable Single Page Apps using only HTML5 data-attributes;
• Gallery Example: Carousel app with history support and cacheable screens;
• Blog Example: Infinite scrolling pages done right with history support;

Setup

1. Install NodeJS >= v0.12.0, if you don't have it yet.

2. Install global dependencies:

[sudo] npm install -g gulp

3. Install local dependencies:

npm install
bower install

4. Build the code:

gulp

gulp server

5. Test the code:

gulp test

gulp test:coverage

Contributing

Please, see our detailed CONTRIBUTING guide for all the information you need to contribute to the project!

History

For detailed changelog, check Releases.

Credits

• Inspired by Daniel Pupius' Surface project
• Demo layouts by Pure CSS
• Icon made by Freepik

Team

Senna.js was made with love by these people and a bunch of awesome contributors.

Author	Maintainer
Eduardo Lundgren	Bruno Basto

Browser Support

License

BSD License © Liferay, Inc.