7.8 KiB
Radio
Selección única entre múltiples opciones.
Uso básico
El elemento Radio no debe tener muchas opciones. De otra manera, utilice el componente Select.
:::Demo Crear un elemento Radio es fácil, solo necesita enlazar(bind) una variable a la directiva v-model del Radio. Va a ser igual al valor label del Radio seleccionado. El tipo de dato de label es String, Number o Boolean.
<template>
<el-radio v-model="radio" label="1">Option A</el-radio>
<el-radio v-model="radio" label="2">Option B</el-radio>
</template>
<script>
export default {
data () {
return {
radio: '1'
};
}
}
</script>
:::
Deshabilitado
El atributo disabled es utilizado para deshabilitar un Radio.
:::demo Solo necesita agregar el atributo disabled.
<template>
<el-radio disabled v-model="radio1" label="disabled">Option A</el-radio>
<el-radio disabled v-model="radio1" label="selected and disabled">Option B</el-radio>
</template>
<script>
export default {
data () {
return {
radio1: 'selected and disabled'
};
}
}
</script>
:::
Grupo de elementos Radio
Recomendado para seleccionar opciones que se excluyen mutuamente.
:::demo Combine el-radio-group con el-radio para mostrar un grupo de Radios. Enlace la variable con v-model del elemento el-radio-group y asigne el valor del label en el-radio. Se provee el evento change con el valor actual como parámetro.
<el-radio-group v-model="radio2">
<el-radio :label="3">Option A</el-radio>
<el-radio :label="6">Option B</el-radio>
<el-radio :label="9">Option C</el-radio>
</el-radio-group>
<script>
export default {
data () {
return {
radio2: 3
};
}
}
</script>
:::
Estilo Button
Radio con estilo de botón.
:::demo Solo necesita cambiar el elemento el-radio a el-radio-button. Se provee el atributo size.
<template>
<div>
<el-radio-group v-model="radio3">
<el-radio-button label="New York"></el-radio-button>
<el-radio-button label="Washington"></el-radio-button>
<el-radio-button label="Los Angeles"></el-radio-button>
<el-radio-button label="Chicago"></el-radio-button>
</el-radio-group>
</div>
<div style="margin-top: 20px">
<el-radio-group v-model="radio4" size="medium">
<el-radio-button label="New York" ></el-radio-button>
<el-radio-button label="Washington"></el-radio-button>
<el-radio-button label="Los Angeles"></el-radio-button>
<el-radio-button label="Chicago"></el-radio-button>
</el-radio-group>
</div>
<div style="margin-top: 20px">
<el-radio-group v-model="radio5" size="small">
<el-radio-button label="New York"></el-radio-button>
<el-radio-button label="Washington" disabled ></el-radio-button>
<el-radio-button label="Los Angeles"></el-radio-button>
<el-radio-button label="Chicago"></el-radio-button>
</el-radio-group>
</div>
<div style="margin-top: 20px">
<el-radio-group v-model="radio6" disabled size="mini">
<el-radio-button label="New York"></el-radio-button>
<el-radio-button label="Washington"></el-radio-button>
<el-radio-button label="Los Angeles"></el-radio-button>
<el-radio-button label="Chicago"></el-radio-button>
</el-radio-group>
</div>
</template>
<script>
export default {
data () {
return {
radio3: 'New York',
radio4: 'New York',
radio5: 'New York',
radio6: 'New York'
};
}
}
</script>
:::
Con bordes
:::demo El atributo border agrega un borde al elemento Radio.
<template>
<div>
<el-radio v-model="radio7" label="1" border>Option A</el-radio>
<el-radio v-model="radio7" label="2" border>Option B</el-radio>
</div>
<div style="margin-top: 20px">
<el-radio v-model="radio8" label="1" border size="medium">Option A</el-radio>
<el-radio v-model="radio8" label="2" border size="medium">Option B</el-radio>
</div>
<div style="margin-top: 20px">
<el-radio-group v-model="radio9" size="small">
<el-radio label="1" border>Option A</el-radio>
<el-radio label="2" border disabled>Option B</el-radio>
</el-radio-group>
</div>
<div style="margin-top: 20px">
<el-radio-group v-model="radio10" size="mini" disabled>
<el-radio label="1" border>Option A</el-radio>
<el-radio label="2" border>Option B</el-radio>
</el-radio-group>
</div>
</template>
<script>
export default {
data () {
return {
radio7: '1',
radio8: '1',
radio9: '1',
radio10: '1'
};
}
}
</script>
:::
Atributos de Radio
| Atributo | Descripción | Tipo | Valores Aceptado | Por defecto |
|---|---|---|---|---|
| label | el valor del Radio | string / number / boolean | — | — |
| disabled | si el Radio está deshabilitado | boolean | — | false |
| border | agregar borde alrededor del elemento Radio | boolean | — | false |
| size | tamaño del elemento Radio, solo funciona si border es verdadero |
string | medium / small / mini | — |
| name | atributo nativo 'name' | string | — | — |
Atributos de Radio-button
| Atributo | Descripción | Tipo | Valores Aceptado | Por defecto |
|---|---|---|---|---|
| label | el valor del Radio | string / number | — | — |
| disabled | si el Radio está deshabilitado | boolean | — | false |
| name | atributo nativo 'name' | string | — | — |
Atributos de Radio-group
| Atributo | Descripción | Tipo | Valores Aceptado | Valores por defecto |
|---|---|---|---|---|
| size | tamaño de los radio buttons o bordered radios |
string | medium / small / mini | — |
| disabled | si la anidación de radios está desahabilitada | boolean | — | false |
| text-color | color de las letras cuando el botón está activo | string | — | #ffffff |
| fill | color del borde y fondo cuando el botón está activo | string | — | #409EFF |
Eventos de Radio
| Nombre de evento | Descripción | Parámetros |
|---|---|---|
| change | se dispara cuando el valor cambia | el valor del label del Radio seleccionado |
Eventos de Radio-group
| Nombre de evento | Descripción | Parámetros |
|---|---|---|
| change | se dispara cuando el valor cambia | el valor del label del Radio seleccionado |