View our GitHub

Please visit sails-docs on GitHub to view documentation on your mobile device.

Edit Page

Partials

Sails uses ejs-locals in its view rendering code, so in your views you can do:

<%- partial ('foo.ejs') %>

to render a partial located at /views/foo.ejs. All of your locals will be sent to the partial automatically.

The paths are relative to the view that loads the partial. So if you have a a user view at /views/users/view.ejs and want to load /views/partials/widget.ejs then you would use:

<%- partial ('../partials/widget.ejs') %>

One thing to note: partials are rendered synchronously, so they will block Sails from serving more requests until they're done loading. It's something to keep in mind while developing your app, especially if you anticipate a large number of connections.

NOTE: When using other templating languages than ejs, their syntax for loading partials or block, etc. will be used. Please refer to their documentation for more information on their syntax and conventions

Is something missing?

If you notice something we've missed or could be improved on, please follow this link and submit a pull request to the sails-docs repo. Once we merge it, the changes will be reflected on the website the next time it is deployed.