Have ideas to improve npm?Join in the discussion! »

    hof-template-mixins

    5.3.2 • Public • Published

    hof-template-mixins

    A middleware that exposes a series of Mustache mixins on res.locals to ease usage of forms, translations, and some other things.

    Installation

    npm install [--save] hof-template-mixins;

    Usage

    var express = require('express');
    
    var i18n = require('i18n-future');
    var mixins = require('hof-template-mixins');
    
    app.set('view engine', 'html');
    app.set('views', path.join(__dirname, '/views'));
    
    app.use(i18n.middleware());
    app.use(mixins());
    
    app.use(function (req, res) {
        // NOTE: res.locals.partials has been set.
        res.render('example-template');
    });

    If rendering as part of a hof controller's middleware chain then the field configuration will automatically be set to res.locals.options.fields by the controller, and will be loaded from here by the mixins.

    Alternatively, if not using hof controllers, you can explicitly set field configuration with instantiating the middleware by passing a fields option. This should not be used for dynamic field configuration.

    Translation

    By default any function set to req.translate will be used for translation if it exists. For example, that generated using i18n-future middleware.

    Options

    viewsDirectory

    Allows you override the directory that the module checks for partials in - Default: the root of this project

    viewEngine

    Allows you to alter the file extension of the templates - Default: 'html'

    sharedTranslationsKey

    Prefixes keys for translation - Default: ''

    translate

    Defines a custom translation method - Default: req.translate

    fields

    Allows for manually setting static field configuration - Default: null

    Mustache mixins available

    t
    time
    selected
    lowercase
    uppercase
    hyphenate
    date
    currency
    select
    input-text
    input-date
    input-text-compound
    input-text-code
    input-number
    input-phone
    radio-group
    checkbox
    checkbox-compound
    checkbox-required
    checkbox-group
    input-submit
    textarea
    qs
    renderField
    

    qs

    This mixin takes a key=value query string and returns a query string with the extra params appended. If the key is already present in the query string, the value passed to the mixin is used

    <a href="{{#qs}}key=value{{/qs}}">Click to append query</a>

    renderField

    The renderField mixin can be called in your template to render all fields. This will lookup the field.mixin in res.locals and call it passing the field key.

    {{#fields}}
      {{#renderField}}{{/renderField}}
    {{/fields}}

    fields.js

    module.exports = {
        'my-field': {
            mixin: 'input-text'
        }
    }

    If mixin is omitted input-text will be used

    To disable auto-rendering of a field, set disableRender: true in the field config. This is required when using the child element rendering functionality to prevent the field being rendered multiple times.

    Render a single field

    To render a specific fields in your templates use the mixin name (matching those above) and field name like so...

    {{#input-text}}myTextField{{/input-text}}
    
    {{#select}}mySelectMenu{{/select}}
    
    {{#radio-group}}myRadioGroup{{/radio-group}}

    Options

    • className: A string or array of string class names.
    • label: The intended value of the HTML label attribute.
    • type: The value of the HTML input type attribute.
    • required: Value applied to aria-required HTML attribute.
    • hint: This adds context to the label, which it is a part of, for input text, radio groups and textarea. It is used within the input by aria-describedby for screen readers.
    • maxlength: Applicable to text-based fields and mapped to the maxlength HTML attribute.
    • options: Applicable to HTML select and radio controls and used to generate the items of either HTML element.
    • selected: Applicable to select, checkbox, and radio controls. Will render the selected HTML option/element selected or checked.
    • legend: Applicable to radio button controls, which are wrapped in a HTML fieldset with a legend element.
    • legendClassName: Applied as a class name to HTML legend attribute.
    • toggle: Can be used to toggle the display of the HTML element with a matching id. See hof-frontend-toolkit for details.
    • attributes: A hash of key/value pairs applicable to a HTML textarea field. Each key/value is assigned as an attribute of the textarea. For example spellcheck="true".
    • child: Render a child partial beneath each option in an optionGroup. Accepts a custom mustache template string, a custom partial in the format partials/{your-partial-name}, 'html' which is used to specify the html for the field has already been prerendered, such as in hof-component-date or a template mixin key which will be rendered within a panel element partial.

    Install

    npm i hof-template-mixins

    DownloadsWeekly Downloads

    68

    Version

    5.3.2

    License

    MIT

    Unpacked Size

    95.4 kB

    Total Files

    24

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar