Documentation

Soy templates

Summary

Soy templates, aka. Google Closure templates, allow devs to use the same template on both in the client and on the server.

Status

API status:experimental
Included in AUI core?Not in core You must explicitly require the web resource key.
Web resource key:com.atlassian.auiplugin:aui-experimental-soy
Experimental since:4.2

Options

AUI is rolling out Soy templates for core components.

In future we hope to offer extracted soydoc and live coding tools, but in the meantime the most popular way to explore the Soy is to read the templates themselves. The templates are commented with usage recommendations; see /auiplugin/src/main/resources/soy/atlassian and test page is http://localhost:9999/ajs/plugins/servlet/ajstest/test-pages/soy/soy-test.html in your refapp.

Conventions

The AUI Soy templates have been built with some common conventions:

  • All should accept id, class, attr, tagName options
  • class and attr will accept a string/array/object as appropriate
  • "content" always means HTML

Useful links about Soy

https://developers.google.com/closure/templates/docs/overview