| /* |
| * 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 org.apache.wicket.markup.html.form; |
| |
| import java.util.List; |
| import java.util.Map; |
| |
| import org.apache.wicket.markup.ComponentTag; |
| import org.apache.wicket.model.IModel; |
| import org.apache.wicket.settings.DebugSettings; |
| import org.apache.wicket.util.lang.Args; |
| import org.apache.wicket.util.string.AppendingStringBuffer; |
| import org.apache.wicket.util.string.Strings; |
| import org.apache.wicket.util.value.IValueMap; |
| |
| |
| /** |
| * A choice subclass that shows choices in radio style. |
| * <p> |
| * Java: |
| * |
| * <pre> |
| * List SITES = Arrays.asList(new String[] { "The Server Side", "Java Lobby", "Java.Net" }); |
| * // Add a radio choice component that uses Input's 'site' property to designate the |
| * // current selection, and that uses the SITES list for the available options. |
| * form.add(new RadioChoice("site", SITES)); |
| * </pre> |
| * |
| * HTML: |
| * |
| * <pre> |
| * <span style="vertical-align: top;" wicket:id="site"> |
| * <input type="radio">site 1</input> |
| * <input type="radio">site 2</input> |
| * </span> |
| * </pre> |
| * |
| * </p> |
| * |
| * @author Jonathan Locke |
| * @author Igor Vaynberg (ivaynberg) |
| * |
| * @param <T> |
| * The model object type |
| */ |
| public class RadioChoice<T> extends AbstractSingleSelectChoice<T> |
| { |
| private static final long serialVersionUID = 1L; |
| |
| private String prefix = ""; |
| private String suffix = ""; |
| |
| private LabelPosition labelPosition = LabelPosition.AFTER; |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @see org.apache.wicket.Component#Component(String) |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String) |
| */ |
| public RadioChoice(final String id) |
| { |
| super(id); |
| } |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param choices |
| * The list of choices in the radio choice |
| * @see org.apache.wicket.Component#Component(String) |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, List) |
| */ |
| public RadioChoice(final String id, final List<? extends T> choices) |
| { |
| super(id, choices); |
| } |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param renderer |
| * The rendering engine |
| * @param choices |
| * The list of choices in the radio choice |
| * @see org.apache.wicket.Component#Component(String) |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, |
| * List,IChoiceRenderer) |
| */ |
| public RadioChoice(final String id, final List<? extends T> choices, |
| final IChoiceRenderer<? super T> renderer) |
| { |
| super(id, choices, renderer); |
| } |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param model |
| * See Component |
| * @param choices |
| * The list of choices in the radio choice |
| * @see org.apache.wicket.Component#Component(String, IModel) |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, IModel, List) |
| */ |
| public RadioChoice(final String id, IModel<T> model, final List<? extends T> choices) |
| { |
| super(id, model, choices); |
| } |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param model |
| * See Component |
| * @param choices |
| * The list of choices in the radio choice |
| * @param renderer |
| * The rendering engine |
| * @see org.apache.wicket.Component#Component(String, IModel) |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, IModel, |
| * List,IChoiceRenderer) |
| */ |
| public RadioChoice(final String id, IModel<T> model, final List<? extends T> choices, |
| final IChoiceRenderer<? super T> renderer) |
| { |
| super(id, model, choices, renderer); |
| } |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param choices |
| * The list of choices in the radio choice |
| * @see org.apache.wicket.Component#Component(String) |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, IModel) |
| */ |
| public RadioChoice(String id, IModel<? extends List<? extends T>> choices) |
| { |
| super(id, choices); |
| } |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param model |
| * The model that is updated with changes in this component. See Component |
| * @param choices |
| * The list of choices in the radio choice |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, IModel,IModel) |
| * @see org.apache.wicket.Component#Component(String, IModel) |
| */ |
| public RadioChoice(String id, IModel<T> model, IModel<? extends List<? extends T>> choices) |
| { |
| super(id, model, choices); |
| } |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param choices |
| * The list of choices in the radio choice |
| * @param renderer |
| * The rendering engine |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, |
| * IModel,IChoiceRenderer) |
| * @see org.apache.wicket.Component#Component(String) |
| */ |
| public RadioChoice(String id, IModel<? extends List<? extends T>> choices, |
| IChoiceRenderer<? super T> renderer) |
| { |
| super(id, choices, renderer); |
| } |
| |
| |
| /** |
| * Constructor |
| * |
| * @param id |
| * See Component |
| * @param model |
| * The model that is updated with changes in this component. See Component |
| * @param choices |
| * The list of choices in the radio choice |
| * @param renderer |
| * The rendering engine |
| * @see org.apache.wicket.Component#Component(String, IModel) |
| * @see org.apache.wicket.markup.html.form.AbstractChoice#AbstractChoice(String, IModel, |
| * IModel,IChoiceRenderer) |
| */ |
| public RadioChoice(String id, IModel<T> model, IModel<? extends List<? extends T>> choices, |
| IChoiceRenderer<? super T> renderer) |
| { |
| super(id, model, choices, renderer); |
| } |
| |
| /** |
| * @see org.apache.wicket.markup.html.form.FormComponent#onComponentTag(org.apache.wicket.markup.ComponentTag) |
| */ |
| @Override |
| protected void onComponentTag(ComponentTag tag) |
| { |
| super.onComponentTag(tag); |
| // since this component cannot be attached to input tag the name |
| // variable is illegal |
| tag.remove("name"); |
| } |
| |
| /** |
| * @return Prefix to use before choice |
| */ |
| public String getPrefix() |
| { |
| return prefix; |
| } |
| |
| /** |
| * @param index |
| * index of the choice |
| * @param choice |
| * the choice itself |
| * @return Prefix to use before choice. The default implementation just returns |
| * {@link #getPrefix()}. Override to have a prefix dependent on the choice item. |
| */ |
| protected String getPrefix(int index, T choice) |
| { |
| return getPrefix(); |
| } |
| |
| /** |
| * @param index |
| * index of the choice |
| * @param choice |
| * the choice itself |
| * @return Separator to use between radio options. The default implementation just returns |
| * {@link #getSuffix()}. Override to have a prefix dependent on the choice item. |
| */ |
| protected String getSuffix(int index, T choice) |
| { |
| return getSuffix(); |
| } |
| |
| /** |
| * @param prefix |
| * Prefix to use before choice |
| * @return this |
| */ |
| public final RadioChoice<T> setPrefix(String prefix) |
| { |
| // Tell the page that this component's prefix was changed |
| addStateChange(); |
| this.prefix = prefix; |
| return this; |
| } |
| |
| /** |
| * @return Separator to use between radio options |
| */ |
| public String getSuffix() |
| { |
| return suffix; |
| } |
| |
| /** |
| * @param suffix |
| * Separator to use between radio options |
| * @return this |
| */ |
| public final RadioChoice<T> setSuffix(String suffix) |
| { |
| // Tell the page that this component's suffix was changed |
| addStateChange(); |
| this.suffix = suffix; |
| return this; |
| } |
| |
| /** |
| * Sets the preferred position of the <label> for each choice |
| * |
| * @param labelPosition |
| * The preferred position for the label |
| * @return {@code this} instance, for chaining |
| */ |
| public RadioChoice<T> setLabelPosition(LabelPosition labelPosition) |
| { |
| Args.notNull(labelPosition, "labelPosition"); |
| this.labelPosition = labelPosition; |
| return this; |
| } |
| |
| /** |
| * Not supported - does nothing. |
| */ |
| @Override |
| protected CharSequence getDefaultChoice(String selectedValue) |
| { |
| return ""; |
| } |
| |
| /** |
| * Generates and appends html for a single choice into the provided buffer |
| * |
| * @param buffer |
| * Appending string buffer that will have the generated html appended |
| * @param choice |
| * Choice object |
| * @param index |
| * The index of this option |
| * @param selected |
| * The currently selected string value |
| */ |
| @Override |
| protected void appendOptionHtml(final AppendingStringBuffer buffer, final T choice, int index, |
| final String selected) |
| { |
| // Append option suffix |
| buffer.append(getPrefix(index, choice)); |
| |
| String id = getChoiceRenderer().getIdValue(choice, index); |
| final String idAttr = getMarkupId() + "-" + id; |
| |
| boolean enabled = isEnabledInHierarchy() && !isDisabled(choice, index, selected); |
| |
| CharSequence renderValue = renderValue(choice); |
| |
| // Allows user to add attributes to the <label..> tag |
| IValueMap labelAttrs = getAdditionalAttributesForLabel(index, choice); |
| StringBuilder extraLabelAttributes = new StringBuilder(); |
| if (labelAttrs != null) |
| { |
| for (Map.Entry<String, Object> attr : labelAttrs.entrySet()) |
| { |
| extraLabelAttributes.append(' ') |
| .append(Strings.escapeMarkup(attr.getKey())) |
| .append("=\"") |
| .append(Strings.escapeMarkup(attr.getValue().toString())) |
| .append('"'); |
| } |
| } |
| |
| labelPosition.before(buffer, idAttr, extraLabelAttributes, renderValue); |
| |
| // Add radio tag |
| buffer.append("<input name=\"") |
| .append(getInputName()) |
| .append('"') |
| .append(" type=\"radio\"") |
| .append((isSelected(choice, index, selected) ? " checked=\"checked\"" : "")) |
| .append((enabled ? "" : " disabled=\"disabled\"")) |
| .append(" value=\"") |
| .append(Strings.escapeMarkup(id)) |
| .append("\" id=\"") |
| .append(Strings.escapeMarkup(idAttr)) |
| .append('"'); |
| |
| // Allows user to add attributes to the <input..> tag |
| { |
| IValueMap attrs = getAdditionalAttributes(index, choice); |
| if (attrs != null) |
| { |
| for (Map.Entry<String, Object> attr : attrs.entrySet()) |
| { |
| buffer.append(' ') |
| .append(Strings.escapeMarkup(attr.getKey())) |
| .append("=\"") |
| .append(Strings.escapeMarkup(attr.getValue().toString())) |
| .append('"'); |
| } |
| } |
| } |
| |
| DebugSettings debugSettings = getApplication().getDebugSettings(); |
| String componentPathAttributeName = debugSettings.getComponentPathAttributeName(); |
| if (Strings.isEmpty(componentPathAttributeName) == false) |
| { |
| CharSequence path = getPageRelativePath(); |
| path = Strings.replaceAll(path, "_", "__"); |
| path = Strings.replaceAll(path, ":", "_"); |
| buffer.append(' ').append(componentPathAttributeName).append("=\"") |
| .append(path) |
| .append("_input_") |
| .append(index) |
| .append('"'); |
| } |
| |
| buffer.append("/>"); |
| |
| labelPosition.after(buffer, idAttr, extraLabelAttributes, renderValue); |
| |
| // Append option suffix |
| buffer.append(getSuffix(index, choice)); |
| } |
| |
| /** |
| * You may subclass this method to provide additional attributes to the <label ..> tag. |
| * |
| * @param index |
| * index of the choice |
| * @param choice |
| * the choice itself |
| * @return tag attribute name/value pairs. |
| */ |
| protected IValueMap getAdditionalAttributesForLabel(int index, T choice) |
| { |
| return null; |
| } |
| |
| /** |
| * You may subclass this method to provide additional attributes to the <input ..> tag. |
| * |
| * @param index |
| * index of the choice |
| * @param choice |
| * the choice itself |
| * @return tag attribute name/value pairs. |
| */ |
| protected IValueMap getAdditionalAttributes(final int index, final T choice) |
| { |
| return null; |
| } |
| } |