Filter Plugin

This wiki is about 0.3 version, not released yet.

About

Filter plugin provides simple ui components to create dynamic filters to search data

Installation

grails install-plugin filter

Component Tags

Select Fields

Select Criteria

Single

Usage

You can use the simple filter with "dynamic" tag:

<filter:dynamic bean="Book" update="[success:'list',failure:'error']"/>

If you want use paginate and sortable column, you need change the default tags to:

<filter:sortableColumn property="id" title="Id" bean="Book" />

<filter:paginate total="${total}" bean="Book"/>

Dynamic tag uses a class in css, called filter, the properties used on image below are:

.filter {
    background: #fff url(../images/skin/shadow.jpg) bottom repeat-x;
    border: 1px solid #ccc;
    color: #666;
    font-size: 10px;
    overflow: hidden;
    padding: 3px 3px;
    margin: 0 0 5 0;
}

Demo

Download demo

Plugin version history

• ???. ??, 2009 (version 0.3)
• features:
• FilterService created, to allow use of filter from other components or controllers.
• Added support to Association filter.
• New tags added: selectFields,selectCriteria
• Tag dynamic renamed to single
• Only show criterias that can applied to selected field, in single component.
• Dec. 26, 2008 (version 0.2)
• features:
• Allow to use another name for list template.
• Allow to use another name/id for success and failure update.
• Added visual effect for filter action.(loading)
• fixed:
• Do not work with float fields.
• Do not work with non default grails domain class.
• Incorrect "show link" after filter. (It's necessary to change the list view,the name of the controller needs to be explicit in show link.)
• general:
• general code cleanup.
• Taglib javascrit code moved to external file: grails-filter.js
• Nov. 11, 2008 (version 0.1)
• Initial release
• Only support simple filters without association and conjunctions using tag "dynamic"
• I18n support for domain class attributes and dynamic tag labels

Development

• For support questions, use grails user mailing list.
• For bugs, improvements or new features request use JIRA.
• For information about plugin development status see development blog.