Grails Bootstrap Forms

A Grails 3 plugin to automatically generate form fields using Bootstrap 4.

Overview

The grails-bootstrap-forms plugin offers an easy-to-use TagLib to render fields in views.

Basic usage

Add the Bintray repository to your build.gradle file:

buildscript {
    repositories {
        ...
        maven { url "http://dl.bintray.com/jvilaplana/plugins" }
    }
}

Add the dependency to your project's build.gradle file:

dependencies {
    ...
    compile 'grails.bootstrap.forms:grails-bootstrap-forms:0.3.3'
}

Add the stylesheet to your project's application.css file:

*= require bootstrap-forms

There is a tag to display a field for show.gsp views and another one to render form fields.

To show a field you can use:

<bf:showField bean="${user}" property="username" />

To render a form field you can use:

<bf:formField bean="${user}" property="username" />

Documentation

showField attributes

| Attribute | Description | | --------- | ----------- | | bean | Instance | | property | Property of the bean to be rendered | | width | Column width, defaults to 3 | | type | Type of the property to be rendered. One of text, textarea, number, date, time, datetime or select. If not specified, the type will be guessed. | addon | If specified, its value will be appended to the field. | | cssClass | A CSS class that will be added to the field |

formField attributes

| Attribute | Description | | --------- | ----------- | | bean | Instance | | property | Property of the bean to be rendered | | width | Column width, defaults to 3 | | type | Type of the property to be rendered. One of text, textarea, number, date, time, transient or select. If not specified, the type will be guessed. | addon | If specified, its value will be appended to the field. | | cssClass | A CSS class that will be added to the field | | required | Set its value to required to set the field as required. | | height | Set the sizing of the field to lg or sm. | rows | Set the number of rows for fields with type="textarea". | name | Set the name and id attributes of the field. Defaults to property. |