The view module provides a simple View-Presenter pattern for creating views using a template and a single transformational JavaScript method.
The template is the "View", the single JavaScript method is the "Presenter".
This simple pattern allows for a very clean View which can easily be extended with any advanced features you might want.
It ships with templating support for HTML or Markdown, but can easily be extended with the templating engine of your choice.
The project is well tested with easy to read test cases. It's been in development for several years and is used in many production applications such as hook.io
Features
Hierarchy Views mapped directly to the file-system
The structure of the folder which contains the view maps directly to the constructed View object.
// renders View-PresentermyView.index.present(opts, cb); myView.about.index.present(opts, cb);myView.about.team.present(opts, cb);myView.contact.present(opts, cb);// also can introspect templates as stringsmyView.index.template;myView.about.index.template;myView.about.team.template;
Isomorphic $ based Presenter Pattern
A Presenter is a single optional JavaScript method which can be associated with a View template.
Presenters are paired with a View by existing in the same directory and sharing the same name as the View template.
When View.present() is called, this Presenter method will execute on the context of the View template.
module['exports'] = function examplePresenter(opts, callback) { // this.$ is a jQuery like selector with it's HTML context set to the current `View.template` var $ = this.$; // you can perform normal jQuery like modifications here $('h1').html('Hello'); // once you are done transforming the template, continue with the newly modified html // notice this uses a callback? this means you can retrieve data from any remote source! // simply require the module you need in this Presenter and call out. callback(null, $.html());}
Our unit tests will give a much better idea on how this works in practice.
Layouts / Nested Layouts
A simple layout pattern is available for Views.
If a View has a layout.html or layout.js file present, that layout file will yield the results of the View-Presenter into the layout.
If no layout is found at the current level of the View-Presenter tree, the View will recurse upwards until a layout or the root is found.
// Will yield the contents of the "index" View inside the ".yield" elementmyView.index.present(opts, cb); // In the case of a nested view, the layout will still be appliedmyView.about.team.present(opts, cb);myView.about.index.present(opts, cb);myView.contact.present(opts, cb);
Our unit tests will also give a better idea on how nested layouts will be applied.
Built-in Node.js HTTP middleware
The view module ships with a built-in Node.js middleware. This middleware will map the View to incoming urls of your web application.