monster.getTemplate()

Syntax

monster.getTemplate(args);

Parameters

args is a mandatory Object parameter with the following properties:

KeyDescriptionTypeDefaultRequired
appThe context of the app, used for finding the template to load.Objecttruetrue
nameName of the template, without the file extension.Stringtrue
dataData to pass to the template.Object{}false
submoduleName of the submodule, used to find the template to loadStringundefinedfalse
rawWhen set to true, Handlebars will not compile the template and it will be sent as is.Booleanfalsefalse
ignoreCacheWhen set to true, request the template even if it was already loaded.Booleanfalsefalse
ignoreSpacesWhen set to true, carriage return, linefeed, tab, whitespace will not be trimmed from the template.Booleanfalsefalse

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`

On this page