PhpStorm 2024.1 Help

Handlebars and Mustache

With PhpStorm, you can use Handlebars expressions and Mustache templates in hbs or mustache files. PhpStorm processes contents of such files according to default or custom settings specified on the Templates page of the Settings dialog.

Before you start

  1. Make sure the JavaScript and TypeScript plugin is enabled in the settings. Press Ctrl+Alt+S to open the IDE settings and then select Plugins. Click the Installed tab. In the search field, type JavaScript and TypeScript. For more information about plugins, refer to Managing plugins.

  2. Install and enable the Handlebars/Mustache plugin on the Settings | Plugins page, tab Marketplace, as described in Installing plugins from JetBrains Marketplace.

Configuring Handlebars and Mustache in PhpStorm

  1. In the Settings dialog (Ctrl+Alt+S) , go to Languages & Frameworks | JavaScript | Templates.

  2. On the Templates page that opens, switch to the Handlebars/Mustache area.

  3. To automatically insert the second closing curly brace } of a Handlebars expression on typing the first closing one, select the Automatically insert closing tag checkbox.

    PhpStorm also recognizes triple stashes {{{ that prevent escaping values inside expressions. In this case, PhpStorm automatically inserts two closing curly braces as soon as you type the first closing one.

  4. To automatically reformat Handlebars expressions and Mustache templates on code generation, refactoring, or pressingCtrl+Alt+L, select the Enable formatting checkbox. Otherwise, PhpStorm always keeps their original formatting.

  5. Choose the language to use the style for comments from. When you enter a line or block comment by pressing Ctrl+/ or Ctrl+Shift+/, PhpStorm inserts the comment delimiters that are used in the chosen language, for example:

    • {{!----}} for Handlebars

    • /**/ for JavaScript

    • <!----> for HTML

  6. To configure Handlebars/Mustache-aware syntax highlighting, in the Settings dialog (Ctrl+Alt+S) , go to Editor | Color Scheme | Handlebars/Mustache. Select the color scheme, accept the highlighting settings inherited from defaults or customize them as described in Configuring Colors and Fonts.

Last modified: 17 April 2024