Below are answers to the most common questions regarding Aria Templates.
If you have a question that is not adressed here, don't hesitate and contact us.
What is Aria Templates? Is it a new library?
At the time AT started, client-side templating was a new and promising concept with no real useable implementation. Aria Templates has been designed from the ground up to be an enterprise grade framework that would shorten development cycles and be sufficiently robust to be used in production environments. You can read more about AT's background in our About section.
Under what license is AT available?
Aria Templates uses the Apache 2.0 License. More information is available on the license page.
What are the supported browsers?
All modern browsers are supported as well as IE down to version 7.
How do I...?
How do I create my first project?
You'll first need to download a copy of the framework here, then you can either download one of the existing guides or start from one of the samples. To start a new project from scratch, install the Atgen utility.
How do I access DOM elements?
Aria Templates is designed so that you don't have to care about DOM micro-management, which is why you won't have to worry about that question.
How can I use framework/library X in my Aria Templates project?
Because of the way AT operates (sandboxing DOM access and refreshing it), using other JS libraries in your code might prove tricky at times. One solution to this is to use the embed widget to create a container that will not be managed by AT. Take a look at this article for more information.
How do I get syntax highlighting for my templates?
We're actively working on an IDE to make UI developers' life easier.
If you are an Eclipse user, you can already benefit from syntax highlighting and basic completion from the AT Eclipse plugin. Send us a message to get information on how to install it.
For Notepad++ or SublimeText users, we also have syntax highlighters available for you. Have a look at the editor-tools repository.
How to submit bug reports / suggestions?
Updating the data model does not trigger any refresh
You probably are modifying the data model directly instead of using the appropriate helpers. For example, bindings will not be notified if you type
this.data.score = 42;For this to work properly you need to write
aria.utils.Json.setValue(this.data, "score", 42);
I added a controller and my app stopped working
Chances are that your controller implements an init() method that doesn't complete properly. Remember that, because init can be implemented asynchronously, the framework has no way to tell when it finishes. To state that you're done, your init method must at one point call back the framework like this:
this.$callback(cb);The callback pattern is explained here.