Skip to content

rcasto/adaptive-html

Repository files navigation

AdaptiveHtml

HTML to Adaptive Card JSON converter library (Demo editor)

The goal of this project is to allow integration with existing WYSIWYG editors such as CKEditor and convert their HTML output to an Adaptive Card.

Under the hood, this project has taken the Turndown code and repurposed it.

Table of contents

Getting started

You can either install the npm package or use a CDN.

Via npm

npm install adaptive-html

Via CDN

<script src="https://cdn.jsdelivr.net/npm/adaptive-html/dist/adaptive-html.iife.min.js"></script>

API

toJSON(string | HTMLElement) => Adaptive Card JSON

var adaptiveCardJson = AdaptiveHtml.toJSON(`
    <p>Turn me into an Adaptive Card</p>
`);
console.log(JSON.stringify(adaptiveCardJson, null, '\t'));
/*
    JSON returned

    {
        "type": "AdaptiveCard",
        "body": [
            {
                "type": "TextBlock",
                "text": "Turn me into an Adaptive Card",
                "wrap": true
            }
        ],
        "actions": [],
        "version": "1.0"
    }
*/

Override version of Adaptive Card schema used

The toJSON method has an optional options object that can be passed in as the second parameter. The only accepted property within this object at the moment is version, which should be the version of the Adaptive Card schema that you would like associated with the generated Adaptive Card JSON output. By default, the version will be "1.0".

var adaptiveCardJson = AdaptiveHtml.toJSON(`
    <p>Turn me into an Adaptive Card</p>
`, {
    version: '1.5',
});
console.log(JSON.stringify(adaptiveCardJson, null, '\t'));
/*
    JSON returned

    {
        "type": "AdaptiveCard",
        "body": [
            {
                "type": "TextBlock",
                "text": "Turn me into an Adaptive Card",
                "wrap": true
            }
        ],
        "actions": [],
        "version": "1.5"
    }
*/

Currently supported HTML tags

  • p
  • br
  • h1, h2, h3, h4, h5, h6
  • ul, ol
  • li
  • a
  • em, i
  • strong, b
  • img

The default replacement for tags not listed above depends on whether the tag refers to a block or inline level HTML element.

For block level elements, its contents are processed, and wrapped in a Container.
For inline level elements, its contents are processed and simply returned.

Known caveats

  • Images in list steps and nested steps are pushed to the bottom of the corresponding list step
  • Lists cannot contain headings

Building it yourself

If you wish to build the library yourself then you can follow these steps:

  1. Clone or download the repository
  2. cd to the repository directory via the command line/terminal
  3. Run npm install to install the necessary dependencies
    • Note: Make sure you have Node.js installed
  4. Hack away
  5. Execute the command npm run build
  6. You should now be able to view the built libraries under the dist/ folder within your copy of the repository

Test Client

To demonstrate the transformation there is a test client within the repository. To launch it follow these steps:

  1. Execute the command npm run client from project root
  2. Navigate to http://localhost:8080

Running tests

You can run tests by executing the command npm test.

If you want to generate a code coverage report execute the command npm run test:report. Launch coverage/index.html in the browser to view the report.