Grails Reference

Creates a form that submits to a controller, action, and/or id. Beyond what is below all the usual HTML attributes apply.

Examples

class Book {
     def list = { [ books: Book.list( params ) ] }
     def show = { [ book : Book.get( params['id'] ) ] }
}

<g:form name="myForm" action="myaction" id="1">...</g:form>
results in:
<form action="/shop/book/myaction/1" method="post" name="myForm" id="myForm" >...</form><g:form name="myForm" url="[action:'list',controller:'book']">...</g:form>
results in:
<form action="/shop/book/list" method="post" name="myForm" id="myForm" >...</form>
<g:form action="show">...</g:form>
results in:
<form action="/shop/book/show" method="post" >...</form>

Description

Source

def form = { attrs, body ->        def useToken = attrs.remove('useToken')
        def writer = getOut()
        writer << "<form action=\"${createLink(attrs)}\" "
        // default to post
        def method = attrs.remove('method')?.toUpperCase() ?: 'POST'
        def httpMethod = HttpMethod.valueOf(method)
        boolean notGet = httpMethod != HttpMethod.GET
        if (notGet) {
            writer << 'method="post" '
        }
        else {
            writer << 'method="get" '
        }
        // process remaining attributes
        attrs.id = attrs.id ? attrs.id : attrs.name
        if (attrs.id == null) attrs.remove('id')
        outputAttributes(attrs)
        writer << ">"
        if (request['flowExecutionKey']) {
            writer.println()
            hiddenFieldImpl(writer, [name: "execution", value: request['flowExecutionKey']])
        }
        if (notGet && httpMethod != HttpMethod.POST) {
            hiddenFieldImpl(writer, [name: "_method", value: httpMethod.toString()])
        }
        if (useToken) {
            def token = SynchronizerToken.store(session)
            writer.println()
            hiddenFieldImpl(writer, [name: SynchronizerToken.KEY, value: token.currentToken])
            writer.println()
            hiddenFieldImpl(writer, [name: SynchronizerToken.URI, value: request.forwardURI])
        }
        // output the body
        writer << body()
        // close tag
        writer << "</form>"
    }

form

Purpose

Examples

Description

Source