Grails Uni-Form Plugin - Making Web Forms Simple as 1, 2, 3.

  • Tags: javascript, css, ui, form
  • Latest: 1.5
  • Last Updated: 29 December 2010
  • Grails version: 1.1.1 > *
  • Authors: Lim Chee Kin
0 vote
Dependency:
compile ":uni-form:1.5"

 Documentation

Summary

Description

Overview

This plugin supplies Uni-Form resources.

Use this plugin in your own apps and plugins to avoid resource duplication and conflicts.

Note for developers working with this plugin

This plugin just provides the resources and a tag to include them. It must not include tags to add new functionality or wrap Uni-Form features.

If you need a newer version of Uni-Form than is currently available with this plugin you can update this plugin in grails SVN yourself. The original author has no desire to manage releases - provided you follow the clear conventions set out, all users of this plugin will be happy! Be my guest and release new versions as and when - just don't break anything for existing users. That means:

  • Always include all Uni-Form resources such as uni-form.css, default.uni-form.css, blue.uni-form.css, dark.uni-form.css, ready.uni-form.css, uni-form.jquery.js and uni-form-validation.jquery.js
  • Don't add any functionality tags to this plugin
IMPORTANT: Make sure the version number of the plugin and the Uni-Form distribution is the same.

Conventions

The version number of this plugin must always follow the version number of the Uni-Form version it bundled.

E.g. the first release of this plugin is 1.5 - because it ships Uni-Form 1.5. If Uni-Form upgrades to 1.6 or similar, this plugin would need to be upgraded to use it and use the version number 1.6.

The key part is that any apps/plugins can install or dependsOn "uniForm" of a given version e.g. 1.5 to pull in that version of Uni-Form.

This plugin optionally depends on the jQuery library for highlight effect of selected field and input validation.

Tags

There is one tag - <uf:resources/> - which pulls in the resources needed. The tag supports the following attributes:

Type of resources

type = js|css

Optional. If this attribute is unspecified, it will pull in all JavaScript and CSS resources.

Style of Uni-Form

style = default|blue|dark

Optional. If this attribute is unspecified, it will pull in the "default" style.

Input Validation

validation = true|false

Optional. If this attribute is unspecified, it will default to true, using Uni-Form's validation mechanism. To use this feature, jQuery library is needed. You can turn off this feature globally by specify the following configuration in Config.groovy:

uniForm.validation = false