adaptivecards-templating
    TypeScript icon, indicating that this package has built-in type declarations

    2.2.0 • Public • Published

    Adaptive Card Templating for JavaScript

    This library implements a JSON-to-JSON templating/data-binding engine. While it is designed to be used with Adaptive Cards, it is not dependent on Adaptive Cards and can therefore be used in many contexts and applications.

    Learn more about Adaptive Card Templating

    IMPORTANT: Breaking change in version 2.0 and later

    Before version 2.0, the adaptivecards-templating package embedded a full copy of the adaptive-expressions package. This model didn't allow an application to use Adaptive Card templating with a more recent version of adaptive-expressions, and bug fixes in adaptive-expressions would always have to be accompanied with a new release of the adaptivecards-templating package.

    From version 2.0 on, adaptivecards-templating doesn't embed adaptive-expressions anymore, and it is the responsibility of the consuming application to explicitly load this package.

    Install and import the module

    Node

    npm install adaptive-expressions adaptivecards-templating --save
    // Import the module:
    import * as ACData from "adaptivecards-templating";
    
    // OR require it:
    var ACData = require("adaptivecards-templating");

    CDN

    The unpkg.com CDN makes it easy to load the script in an browser.

    The latest release will keep you up to date with features and fixes, but may have breaking changes over time. For maximum stability you should use a specific version.

    • adaptivecards-templating.js - non-minified, useful for dev
    • adaptivecards-templating.min.js - minified version, best for production
    <!-- Option 1: always load the latest release -->
    <script src="https://unpkg.com/adaptivecards-templating/dist/adaptivecards-templating.min.js"></script>
    
    <!-- Option 2: load a specific version (e.g, 1.0-rc1) -->
    <script src="https://unpkg.com/adaptivecards-templating@<VERSION>/dist/adaptivecards-templating.min.js"></script>

    Once the library is loaded, the global ACData variable is defined and ready to be used.

    Usage

    Hello World example

    Here is a simplistic "Hello World" example on how to use the library to generate an Adaptive Card using a template bound to a data object. Note this example requires the adaptivecards package.

    import * as ACData from "adaptivecards-templating";
    import * as AdaptiveCards from "adaptivecards";
    
    // Define a template payload
    var templatePayload = {
        "type": "AdaptiveCard",
        "version": "1.0",
        "body": [
            {
                "type": "TextBlock",
                "text": "Hello ${name}!"
            }
        ]
    };
    
    // Create a Template instance from the template payload
    var template = new ACData.Template(templatePayload);
    
    // Create a data binding context, and set its $root property to the
    // data object to bind the template to
    var context: ACData.IEvaluationContext = {
        $root = {
            "name": "Adaptive Cards"
        }
    };
    
    // "Expand" the template - this generates the final Adaptive Card,
    // ready to render
    var card = template.expand(context);
    
    // Render the card
    var adaptiveCard = new AdaptiveCards.AdaptiveCard();
    adaptiveCard.parse(card);
    
    document.getElementById('exampleDiv').appendChild(adaptiveCard.render());

    This example is implemented in the example.html file.

    Functions

    Built-in functions

    For a list of and documentation on built-in functions, please refer to the AdaptiveExpressions documentation.

    Custom functions

    // Coming soon...

    Install

    npm i adaptivecards-templating

    DownloadsWeekly Downloads

    8,056

    Version

    2.2.0

    License

    MIT

    Unpacked Size

    206 kB

    Total Files

    23

    Last publish

    Collaborators

    • adaptivecards