FAQ

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.

Top

General

  • What is Aria Templates? Is it a new library?

    Aria Templates is an MVC Javascript framework based on client-side templating. AT provides a set of helpers that make it easier to develop web applications and, as a framework, enriches your code with familiar features inspired from common object-oriented concepts. It also is a powerful templating which make creating user interfaces a breeze.

  • Why come up with another JavaScript framework?

    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 download one of the existing guides. 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?

    If you find some problem, issue or bug, please report it here. If you want to contribute to AT everything is explained on this page. For general questions don't hesitate to drop us a message!

Common issues

  • 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.