Group

This is a constructor macro which generates an input field wrapped with standard markup with the ability to prepend/append extra elements. It is called by other macros like form.text and form.password.

Usually, you’ll have a single options hash to this You need to specify which of the options you want to apply to the parent wrapper (usually a <div>) and which you want to be attached to the actual form input element. Use the only and exclude array functions to manipulate your options array.

Example usage

{{
    form.group({
        'parent': options|only('class label help')
        'inputs': [
            elem.input(options
                |exclude('class label help')
            )
        ]
    })
}}

In this example, if 'class': 'FOO', 'label': 'BAR' and 'help': 'BAZ' will be placed in the markup like so:

<div class="form__group FOO">
    <label for="inputText" class="control__label">BAR</label>
    <div class="controls">
        <input id="inputText" name="inputText" placeholder="Placeholder" type="text" class="form__control">
        <p class="help-block">BAZ</p>
    </div>
</div>

Options

Options applied to the parent wrapper