HTML & VueJS

The BetterForms framework allows you to dig deep into the low levels of HTML code and still keep the benefits of a framework and reactivity. Many components have html compatible keys or accept slots that allow HTML to be rendered. BetterForms uses VueJS under the hood to keep all the elements working together.

143KB

Vue-Essentials-Cheat-Sheet.pdf

pdf

Injecting VueJS syntax

You can harness the full power of VueJS the html rendering engine inside of BetterForms but simply adding Vue html syntax into your HTML code. When you use Vue, it maintains a link to the data in your data model and wherever that data is referenced so changes made to the data model will reflect instantly on the page.

This combination of an input field and HTML is made possible with VueJS

Here's just a few things you can do with VueJS Syntax:

• Render merged data from the data model

• Build tables and other repeating data. (see example below)

• Execute all actions and pass data to those actions.

How do I know when to use {{curly-brackets}} or not?

The {{}} syntax is only for injecting JavaScript into HTML code. Everything that you stick inside of of the curly brackets is actually just JavaScript. Vue is the glue that allows you combine HTML and JS and dynamically insert data (as calculated by the JS) into the HTML of your page.

Remember: the contents of the curly brackets is a single line of JavaScript and must evaluate to return a value. However, you only need to add the curly brackets if you're trying to place the result of that value into HTML code.

Examples

Merge Data

// the data model
{
    "nameFirst": "Jim",
    "nameLast": "Bob"
}

// an HTML element
{
  "html": "<h2>My name is {{model.nameFirst}}</h2>",
  "styleClasses": "col-md-12",
  "type": "html"
}

Repeating Data

Example Data Model:

// the data model
{
    "items": [{
        "name": "Racecar",
        "qty": 2
    },{
        "name": "Wheels",
        "qty": 30
    }]
}

HTML code to build a table from the array

<table class="table">
    <thead>
        <tr>
            <th>Quan</th>
            <th>Name</th>
        </tr>
    </thead>
    <tbody>
        <tr v-for="line in model.items"> 
            <td>{{line.qty}}</td> 
            <td>{{line.name}}</td> 
        </tr>
    </tbody>
</table>>

Note that the line variable is declared on line 9. It can be set an anything and then is referenced later on lines 10 & 11 to get at the individual objects of the array.

Other JavaScript Libraries

BetterForms is bundled with the following JS libraries:

• MomentJS - working with dates and times

  • https://momentjs.com/docs/#/displaying/

  • Version: 2.24.0

• NumeralJS - formatting numbers

  • http://numeraljs.com/#format

  • Version: 2.0.6

• Lodash - any useful function you can imagine

  • https://lodash.com/docs/

  • Version: 4.17.11

• Marked - markdown complier

  • https://marked.js.org/

  • Version: 0.6.2

• Bootstrap - CSS styling

  • https://getbootstrap.com/

  • Version: 3.3.7 (this will be removed in the future, it can be added in via CDN)

You can access these libraries anywhere where JavaScript can be inserted, including these curly brackets