Easy form fields generation taglib.
Owner: jvilaplana | 0.3.3 | Aug 19, 2020 | Package | Issues | Source | Documentation | License: MIT
dependencies {
compile 'grails.bootstrap.forms:grails-bootstrap-forms:0.3.3'
}
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
. |