RadioButtonGroup

Abrir en ChatGPT

23.01

Java API

El RadioButtonGroup gestiona una colección de RadioButton componentes. Solo un RadioButton puede estar seleccionado en un RadioButtonGroup. Cuando un usuario selecciona un nuevo botón de opción, el previamente seleccionado en el grupo se deselecciona automáticamente.

Creando un RadioButtonGroup

Renderizado del RadioButtonGroup

El componente RadioButtonGroup no renderiza un elemento HTML. Solo proporciona la lógica para hacer que los componentes RadioButton se comporten como un grupo en lugar de individualmente.

Crea componentes RadioButton individuales y pásalos al constructor de RadioButtonGroup. Solo un botón en el grupo puede estar seleccionado a la vez.

Mostrar Código

Java

Agregando y eliminando componentes RadioButton

Puedes incluir componentes RadioButton en el constructor de RadioButtonGroup para crear un grupo a partir de los componentes proporcionados. Para agregar o eliminar un RadioButton de un RadioButtonGroup existente, utiliza los métodos add() o remove().

Obteniendo el Grupo de un RadioButton

El componente RadioButton tiene el método getButtonGroup(), que devuelve el RadioButtonGroup al que pertenece, o null si no tiene un grupo.

Anidando 25.11

Al igual que otros componentes, puedes anidar un RadioButtonGroup dentro de un contenedor, por lo que no tienes que agregar directamente cada RadioButton individualmente.

RadioButton agree = new RadioButton("Aceptar");
RadioButton neutral = new RadioButton("Neutral");
RadioButton disagree = new RadioButton("Rechazar");

RadioButtonGroup group = new RadioButtonGroup("opciones", agree, neutral, disagree);

Fieldset fieldset = new Fieldset("Opciones");
fieldset.add(group);

Usando RadioButtonGroupChangeEvent

Cada RadioButton puede tener su propio listener de eventos para detectar cuando un usuario lo activa. Sin embargo, una ventaja de usar un RadioButtonGroup es que puedes usar un solo listener de eventos que responda a todos los botones de radio en el grupo con el RadioButtonGroupChangeEvent.

Agregando listeners de eventos a cada RadioButton

agree.onValueChange(e -> changeEvent());
neutral.onValueChange(e -> changeEvent());
disagree.onValueChange(e -> changeEvent());

Agregando un solo listener de eventos al RadioButtonGroup

RadioButtonGroup group = new RadioButtonGroup("opciones", agree, neutral, disagree);
group.onChange(e -> changeEvent());

El siguiente ejemplo de Ubicación del Drawer utiliza el RadioButtonGroupChangeEvent para cambiar automáticamente la ubicación del componente Drawer:

Mostrar Código

Java

Nombrando

El atributo name en un RadioButtonGroup agrupa juntos los RadioButtons relacionados, permitiendo a los usuarios hacer una única elección entre las opciones proporcionadas y haciendo cumplir la exclusividad entre los RadioButtons. El nombre de un grupo no se refleja en el DOM, sin embargo, y es una utilidad de conveniencia para el desarrollador Java.