Add "radioGroup" form tag lib

[peterfarrell]

We have an options tag for the form tag library already and it makes sense to do something similar for a group of radios. Grails has a similar tag available in it's library.

Reference:  http://www.grails.org/Tag+-+radioGroup

Syntax would have to be discussed.

[mattwoodward]

Definitely would love to see this, and the grails syntax looks pretty good. Translated into CFML, I suppose we'd want to follow the syntax of the select box maybe?

<form:radioGroup name="myRadioGroup" items="#array|struct|query#" 
    checkValue="#variable|literal#" />

One thing I have run into in messing with the select is maybe we do need a way to specify values and labels a bit more explicitly, like you can in grails:

<form:radioGroup name="myRadioGroup" labels="label1,label2,label3" 
    values="value1,value2,value3" />

At first I didn't think we needed the syntax they have in grails to do the formatting of each item, but radio buttons are a bit different than a select so it might make sense to throw that in as well. The syntax they use seems logical to me (other than the obvious invalid syntax typos they have in their examples).

[peterfarrell]

This is good information Matt. What do you propose for the syntax that we can iterate over so we can create radio groups? Do you want to call it radioGroup or radios?

If we allow a struct for the items attribute we could use the key for value of radio and the key's value for the label. A little harder for arrays or queries. Not sure if I'm sold on breaking it out to labels and values (unless we want to support more than just structs).

Considering you've been using the form tag lib a lot, would you like to develop this new tag?

[peterfarrell]

I bequeath this ticket upon you, fine Sir. Have fun...

[peterfarrell]

Yea, just picking up on the nested syntax to iterate over for each radio value is definitely something we'll need to add. As for some people each radio might be a table row, nested in a li or p tag. So the formatting is something we can't just assume. You're right, radios are completely different from options which don't have formatting because that's all part of a select box.

I guess the nested formatting shouldn't allow CFML tag (since only Open BD has a render function). There isn't anyway we can loop over that. So the nested stuff should be placeholders and non-CFML tags. Sorta like this:

<form:radioGroup name="myRadioGroup" items="#array|struct|query#" checkValue="#variable|literal#">
   <li>${value} ${radio}</li>
</form:radioGroup>

[peterfarrell]

We talked about possible syntax on this thread:  http://bit.ly/egGAc

[peterfarrell]

We'll also use the same syntax decided for the new checkboxGroup tag in ticket #323.

[peterfarrell]

Let's target the completion of this ticket for the Thursday July 16th so we can test before the release of the beta.

[peterfarrell]

I looked at the code and it looks pretty straight forward. Haven't had a chance to test it yet, but I will this weekend. Go ahead with the checkboxgroup tag and add the doco to the wiki ASAP (I'd like to release a Beta on Monday).

[peterfarrell]

This is currently in the repo.

[peterfarrell]

Still needs to support path attribute.