monster.getTemplate()
Syntax
monster.getTemplate(args);
Parameters
args
is a mandatory Object
parameter with the following properties:
Key | Description | Type | Default | Required |
---|---|---|---|---|
app | The context of the app, used for finding the template to load. | Object | true | true |
name | Name of the template, without the file extension. | String | true | |
data | Data to pass to the template. | Object | {} | false |
submodule | Name of the submodule, used to find the template to load | String | undefined | false |
raw | When set to true , Handlebars will not compile the template and it will be sent as is. | Boolean | false | false |
ignoreCache | When set to true , request the template even if it was already loaded. | Boolean | false | false |
ignoreSpaces | When set to true , carriage return, linefeed, tab, whitespace will not be trimmed from the template. | Boolean | false | false |
Return value
A String
representation of the template.
Description
The monster.getTemplate()
method allows you to request templates simply by specifying the name of the desired template. You can also pass data to the template with the data
parameter.
You can use the same getTemplate method and bypass the app property by using this.getTemplate(args)
within the right scope in an app.
Examples
Load template with no data into the DOM
function renderApp(container) {
var template = $(monster.getTemplate({
app: app,
name: 'app'
}));
container
.empty()
.append(template);
}
// Do something with `renderApp`
Load template with data into the DOM
function renderApp(container) {
getUserData(app.userId, function(userData) {
var dataToTemplate = {
userId: app.userId,
userData: userData
};
var template = $(monster.getTemplate({
app: app,
name: 'app',
data: dataToTemplate
}));
container
.empty()
.append(template);
});
}
// Do something with `renderApp`
Load a string template in a Toastr Notification or Monster Alert
function renderUserCreate(newUserData) {
requestCreateUser({
data: {
user: newUserData
},
success: function(data) {
var message = monster.getTemplate({
app: app,
name: '!' + app.i18n.active().toastr.success.userCreate,
data: {
name: data.name
}
});
monster.ui.toast({
type: 'success',
message: message
});
},
error: function(data) {
var message = monster.getTemplate({
app: app,
name: '!' + app.i18n.active().alert.error.userCreate,
data: {
type: data.type
}
});
monster.ui.alert('error', message);
}
});
}
// Do something with `renderUserCreate`