com.jgeppert.struts2.jquery.components.Radio Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of struts2-jquery-plugin Show documentation
There is a newer version: 5.0.5
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *  http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

package com.jgeppert.struts2.jquery.components;

import com.opensymphony.xwork2.util.ValueStack;
import org.apache.struts2.views.annotations.StrutsTag;
import org.apache.struts2.views.annotations.StrutsTagAttribute;
import org.apache.struts2.views.annotations.StrutsTagSkipInheritance;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * 
 * 
 * A tag that creates an Button Set from a Radio Button Map.
 * 
 * 
 * 
 * Examples
 * 
 * 
 * 
 * Create a Buttonset from Radio Buttons Map.
 * 
 *  * <div id="formResult" class="result ui-widget-content ui-corner-all">Submit form bellow.</div>
 *
 *   <s:form id="form" action="echo" theme="simple">
 *           <label for="echo">Choose your Friend: </label>
 *       <sj:radio
 *           id="radiobuttonset"
 *               list="{'Patrick', 'Jason', 'Jay', 'Toby', 'Rene'}"
 *               name="echo"/>
 *       <br/>
 *           <sj:submit
 *             targets="formResult"
 *             value="AJAX Submit"
 *             indicator="indicator"
 *             button="true"
 *           />
 *   </s:form>
 * 
 * 
 *
 * @author Johannes Geppert
 */
@StrutsTag(name = "radio", tldTagClass = "com.jgeppert.struts2.jquery.views.jsp.ui.RadioTag", description = "Render a Button Set from a given radio button list", allowDynamicAttributes = true)
public class Radio extends AbstractFormListElement {

    public static final String TEMPLATE = "radio";
    public static final String TEMPLATE_CLOSE = "radio-close";
    public static final String COMPONENT_NAME = Radio.class.getName();
    public static final String JQUERYACTION = "buttonset";

    private static final String PARAM_BUTTONSET = "buttonset";
    private static final String PARAM_ICON = "icon";
    private static final String PARAM_DIRECTION = "direction";

    private static final String ID_PREFIX_RADIO = "radio_";

    protected String buttonset;
    protected String icon;
    protected String direction;

    public Radio(ValueStack stack, HttpServletRequest request, HttpServletResponse response) {
        super(stack, request, response);
    }

    public String getDefaultOpenTemplate() {
        return TEMPLATE;
    }

    protected String getDefaultTemplate() {
        return TEMPLATE_CLOSE;
    }

    public void evaluateExtraParams() {
        super.evaluateExtraParams();

        addParameter(PARAM_JQUERY_ACTION, JQUERYACTION);

        addParameterIfPresent(PARAM_BUTTONSET, this.buttonset, Boolean.class);
        addParameterIfPresent(PARAM_ICON, this.icon, Boolean.class);
        addParameterIfPresent(PARAM_DIRECTION, this.direction);

        addGeneratedIdParam(ID_PREFIX_RADIO);
    }

    @Override
    @StrutsTagSkipInheritance
    public void setTheme(String theme) {
        super.setTheme(theme);
    }

    @Override
    public String getTheme() {
        return "jquery";
    }

    @StrutsTagAttribute(description = "Disable or enable the jQuery UI buttonset feature.", defaultValue = "true", type = "Boolean")
    public void setButtonset(String buttonset) {
        this.buttonset = buttonset;
    }

    @StrutsTagAttribute(description = "Whether to show the radio icon, depending on the input's type.", defaultValue = "true", type = "Boolean")
    public void setIcon(String icon) {
        this.icon = icon;
    }

    @StrutsTagAttribute(description = "By default, controlgroup displays its controls in a horizontal layout. Use this option to use a vertical layout instead.", defaultValue = "horizontal")
    public void setDirection(String direction) {
        this.direction = direction;
    }

}