mirror of https://github.com/ElemeFE/element
				
				
				
			
		
			
				
	
	
		
			232 lines
		
	
	
		
			7.8 KiB
		
	
	
	
		
			Markdown
		
	
	
			
		
		
	
	
			232 lines
		
	
	
		
			7.8 KiB
		
	
	
	
		
			Markdown
		
	
	
| <script>
 | |
|   module.exports = {
 | |
|     data() {
 | |
|       return {
 | |
|         radio: '1',
 | |
|         radio1: 'selected and disabled',
 | |
|         radio2: 3,
 | |
|         radio3: 'New York',
 | |
|         radio4: 'New York',
 | |
|         radio5: 'New York',
 | |
|         radio6: 'New York',
 | |
|         radio7: '1',
 | |
|         radio8: '1',
 | |
|         radio9: '1',
 | |
|         radio10: '1'
 | |
|       };
 | |
|     }
 | |
|   };
 | |
| </script>
 | |
| 
 | |
| ## 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`.
 | |
| ```html
 | |
| <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`.
 | |
| ```html
 | |
| <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.
 | |
| 
 | |
| ```html
 | |
| <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`.
 | |
| ```html
 | |
| <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.
 | |
| ```html
 | |
| <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 |
 | |
| 
 |