TAO Template Language Support

A Visual Studio Code extension that adds language support for the TAO template engine. Node-tao is a Nodejs template engine that focuses on performance, security, and developer experience.

✨ Features

• Tag completion – Autocompletion for TAO template tags.
• Include support – Suggestions and signature help for include(...).
• Control structures – Snippets and completions for if, for, for-in, and for-of with tags with syntax colors for html files.
• User data injection – Autocompletion for variables and helpers injected in the template.
• Template names provider – An include will suggest child templates of your project.
• Template navigation – Go to the file definition for an embedded child template in an include, hover to get the complete filepath.

📂 Configuration

If you want to override the default options, create a tao.config.mjs file at the root of your project and export your configuration as the default.

/**
 * @type {import('tao-vscode-extension').Options}
 * These are the default options.
 */
const options = {
  extension: 'html', // extension of your template files
  parse: { exec: '', interpolate: '=', raw: '~' }, // parse configuration
  tags: { opening: '<%', closing: '%>' }, // tags configuration
  views: 'src', // folder where template files are stored
};

export default options;

🚀 Injected data in templates

Injected data in a template file (variables and helpers) are available for autocompletion.

const displayName = (firstname, lastname) => `${firstname} ${lastname}`;
const result = tao.render(
  'template2.html',
  { firstname: 'John', lastname: 'Doe' },
  { displayName }
);

The data will be available after a specific render take place, since it has to be first injected.

NB: Injected data is available only by setting Node-TAO in development mode.

🎨 Customize TAO tags colors

If you wish to change the colors of the tags, provide the following configuration in the settings.json file in the settings of vscode.

"editor.tokenColorCustomizations": {
  "textMateRules": [
    {
      "scope": "punctuation.section.embedded.begin.tao",
      "settings": { "foreground": "#4faf43" }
    },
    {
      "scope": "punctuation.section.embedded.end.tao",
      "settings": { "foreground": "#4faf43" }
    }
  ]
}

🛠️ Requirements

Requires v0.0.3 of node-tao or higher.

📜 ChangeLogs

0.0.1

Initial release with completions, includes, tags, signature.

0.0.2

Syntax color corrections, corrections of for loop and for in variable autocompletion interpolation.

🔧 Contributing

Issues and pull requests are welcome!
👉 GitHub repository

📄 License

MIT