mirror of https://github.com/ElemeFE/element
				
				
				
			Cascader.md spanish version
							parent
							
								
									287b823938
								
							
						
					
					
						commit
						33773dbd12
					
				| 
						 | 
				
			
			@ -280,13 +280,14 @@
 | 
			
		|||
 | 
			
		||||
## Cascader
 | 
			
		||||
 | 
			
		||||
If the options have a clear hierarchical structure, Cascader can be used to view and select them.
 | 
			
		||||
Si las opciones tienen una estructura jerárquica clara, Cascader puede utilizarse para visualizarlas y seleccionarlas.
 | 
			
		||||
 | 
			
		||||
### Basic usage
 | 
			
		||||
### Uso básico
 | 
			
		||||
 | 
			
		||||
There are two ways to expand child option items.
 | 
			
		||||
Existen dos maneras de expandir los elementos hijo de la opción.
 | 
			
		||||
 | 
			
		||||
:::demo Al asignar al atributo `options` un array de opciones, se genera un Cascader. El atributo `expand-trigger` define cómo se expanden las opciones hijo. Este ejemplo también muestra el evento `change` , cuyo parámetro es el valor de Cascader, un array formado por los valores de cada nivel seleccionado.
 | 
			
		||||
 | 
			
		||||
:::demo Assigning the `options` attribute to an array of options renders a Cascader. The `expand-trigger` attribute defines how child options are expanded. This example also demonstrates the `change` event, whose parameter is the value of Cascader, an array made up of the values of each selected level.
 | 
			
		||||
```html
 | 
			
		||||
<div class="block">
 | 
			
		||||
  <span class="demonstration">Child options expand when clicked (default)</span>
 | 
			
		||||
| 
						 | 
				
			
			@ -519,11 +520,12 @@ There are two ways to expand child option items.
 | 
			
		|||
```
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
### Disabled option
 | 
			
		||||
### Opcion Disabled
 | 
			
		||||
 | 
			
		||||
Disable an option by setting a `disabled` field in the option object.
 | 
			
		||||
Para desactivar una opción configure un campo `disabled` en el objeto de opción.
 | 
			
		||||
 | 
			
		||||
:::demo En este ejemplo, el primer elemento del array `options` tiene un campo  `disabled: true` , por lo que está desactivado. Por defecto, Cascader verifica el campo `disabled` en cada objeto de opción; si está utilizando otro nombre de campo para indicar si una opción está deshabilitada, puede asignarla en el atributo `props` (consulte la tabla API a continuación para obtener más detalles). Y por supuesto, el valor de `value`, `label` y `children` también se pueden personalizar de la misma manera.
 | 
			
		||||
 | 
			
		||||
:::demo In this example, the first item in `options` array has a `disabled: true` field, so it is disabled. By default, Cascader checks the `disabled` field in each option object; if you are using another field name to indicate whether an option is disabled, you can assign it in the `props` attribute (see the API table below for details). And of course, field name `value`, `label` and `children` can also be customized in the same way.
 | 
			
		||||
```html
 | 
			
		||||
<el-cascader
 | 
			
		||||
  :options="optionsWithDisabled"
 | 
			
		||||
| 
						 | 
				
			
			@ -735,11 +737,12 @@ Disable an option by setting a `disabled` field in the option object.
 | 
			
		|||
```
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
### Display only the last level
 | 
			
		||||
### Mostrar sólo el último nivel
 | 
			
		||||
 | 
			
		||||
The input can display only the last level instead of all levels.
 | 
			
		||||
Puede mostrar sólo el último nivel en lugar de todos los niveles.
 | 
			
		||||
 | 
			
		||||
:::demo El atributo `show-all-levels` define si se visualizan todos los niveles. Si es `false`, sólo se muestra el último nivel.
 | 
			
		||||
 | 
			
		||||
:::demo The `show-all-levels` attribute defines if all levels are displayed. If it is `false`, only the last level is displayed.
 | 
			
		||||
```html
 | 
			
		||||
<el-cascader
 | 
			
		||||
    :options="options"
 | 
			
		||||
| 
						 | 
				
			
			@ -951,9 +954,9 @@ The input can display only the last level instead of all levels.
 | 
			
		|||
```
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
### With default value
 | 
			
		||||
### Con valor por defecto
 | 
			
		||||
 | 
			
		||||
:::demo The default value can be defined with an array.
 | 
			
		||||
:::demo El valor por defecto se puede definir con un array.
 | 
			
		||||
```html
 | 
			
		||||
<el-cascader
 | 
			
		||||
  :options="options"
 | 
			
		||||
| 
						 | 
				
			
			@ -1168,9 +1171,10 @@ The input can display only the last level instead of all levels.
 | 
			
		|||
 | 
			
		||||
### Change on select
 | 
			
		||||
 | 
			
		||||
Parent options can also be selected.
 | 
			
		||||
También se pueden seleccionar las opciones del elemento padre.
 | 
			
		||||
 | 
			
		||||
:::demo Por defecto sólo se pueden seleccionar las opciones del último nivel. Al asignar `change-on-select` a `true`, también se pueden seleccionar opciones en los niveles superiores.
 | 
			
		||||
 | 
			
		||||
:::demo By default only the options in the last level can be selected. By assigning `change-on-select` to `true`, options in parent levels can also be selected.
 | 
			
		||||
```html
 | 
			
		||||
<el-cascader
 | 
			
		||||
  :options="options"
 | 
			
		||||
| 
						 | 
				
			
			@ -1382,11 +1386,12 @@ Parent options can also be selected.
 | 
			
		|||
```
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
### Dynamically load child options
 | 
			
		||||
### Carga dinamica de elementos hijos
 | 
			
		||||
 | 
			
		||||
Load child options when their parent option is clicked or hovered over.
 | 
			
		||||
Se puede hacer una carga dinamica de elementos hijos cuando se hace clic en el elemento padre o se pasa el ratón sobre el.
 | 
			
		||||
 | 
			
		||||
:::demo En este ejemplo, el array de opciones no tiene datos de ciudades cuando se inicializa. Con el evento `active-item-change`, puede cargar dinámicamente las ciudades de un estado específico. Además, este ejemplo también demuestra cómo se utilizan los`props`.
 | 
			
		||||
 | 
			
		||||
:::demo In this example, the options array does not have data of cities when initialized. With the `active-item-change` event, you can load the cities of a specific state dynamically. Besides, this example also demonstrates how `props` is used.
 | 
			
		||||
```html
 | 
			
		||||
<el-cascader
 | 
			
		||||
  :options="options2"
 | 
			
		||||
| 
						 | 
				
			
			@ -1433,11 +1438,12 @@ Load child options when their parent option is clicked or hovered over.
 | 
			
		|||
```
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
### Filterable
 | 
			
		||||
### Filtrable
 | 
			
		||||
 | 
			
		||||
Search and select options with a keyword.
 | 
			
		||||
Buscar y seleccionar opciones con una palabra clave.
 | 
			
		||||
 | 
			
		||||
:::demo Añadir `filterable` a `el-cascader` permite filtrar
 | 
			
		||||
 | 
			
		||||
:::demo Adding `filterable` to `el-cascader` enables filtering
 | 
			
		||||
```html
 | 
			
		||||
<div class="block">
 | 
			
		||||
  <span class="demonstration">Only options of the last level can be selected</span>
 | 
			
		||||
| 
						 | 
				
			
			@ -1663,34 +1669,35 @@ Search and select options with a keyword.
 | 
			
		|||
```
 | 
			
		||||
:::
 | 
			
		||||
 | 
			
		||||
### Attributes
 | 
			
		||||
| Attribute | Description         | Type    | Options       | Default|
 | 
			
		||||
|---------- |-------------------- |---------|-------------  |-------- |
 | 
			
		||||
| options   | data of the options | array | — | — |
 | 
			
		||||
| props | configuration options, see the following table | object | — | — |
 | 
			
		||||
| value | selected value | array | — | — |
 | 
			
		||||
| popper-class | custom class name for Cascader's dropdown | string | — | — |
 | 
			
		||||
| placeholder | input placeholder | string | — | Select |
 | 
			
		||||
| disabled  | whether Cascader is disabled | boolean |  — | false |
 | 
			
		||||
| clearable  | whether selected value can be cleared | boolean | — | false |
 | 
			
		||||
| expand-trigger  | trigger mode of expanding current item | string | click / hover | click |
 | 
			
		||||
| show-all-levels | whether to display all levels of the selected value in the input | boolean | — | true |
 | 
			
		||||
| filterable  | whether the options can be searched | boolean | — | — |
 | 
			
		||||
| debounce | debounce delay when typing filter keyword, in milliseconds | number | — | 300 |
 | 
			
		||||
| change-on-select | whether selecting an option of any level is permitted | boolean | — | false |
 | 
			
		||||
| size  | size of Input | string | medium / small / mini | — |
 | 
			
		||||
| before-filter | hook function before filtering with the value to be filtered as its parameter. If `false` is returned or a `Promise` is returned and then is rejected, filtering will be aborted | function(value) | — | — |
 | 
			
		||||
### Atributos
 | 
			
		||||
| Atributo         | Descripción                              | Tipo            | Opciones              | Por defecto |
 | 
			
		||||
| ---------------- | ---------------------------------------- | --------------- | --------------------- | ----------- |
 | 
			
		||||
| options          | datos de las opciones                    | array           | —                     | —           |
 | 
			
		||||
| props            | opciones de configuration,  mire la tabla siguiente | object          | —                     | —           |
 | 
			
		||||
| value            | valor seleccionado                       | array           | —                     | —           |
 | 
			
		||||
| popper-class     | nombre de clase para el Cascader's dropdown | string          | —                     | —           |
 | 
			
		||||
| placeholder      | input placeholder                        | string          | —                     | Select      |
 | 
			
		||||
| disabled         | si Cascader esta disabled                | boolean         | —                     | false       |
 | 
			
		||||
| clearable        | si se puede borrar el valor seleccionado | boolean         | —                     | false       |
 | 
			
		||||
| expand-trigger   | evento del elemento actual para expandirse. | string          | click / hover         | click       |
 | 
			
		||||
| show-all-levels  | si mostrar todos los niveles del valor seleccionado en la entrada | boolean         | —                     | true        |
 | 
			
		||||
| filterable       | si se pueden buscar las opciones         | boolean         | —                     | —           |
 | 
			
		||||
| debounce         | retardo al escribir la palabra clave del filtro, en milisegundos | number          | —                     | 300         |
 | 
			
		||||
| change-on-select | si se permite seleccionar una opción de cualquier nivel | boolean         | —                     | false       |
 | 
			
		||||
| size             | tamaño del input                         | string          | medium / small / mini | —           |
 | 
			
		||||
| before-filter    | funcion antes de filtrar con el valor a filtrar como parámetro. Si se devuelve `false` o se devuelve una `Promise` y luego es rechazada, el filtrado será abortado. | function(value) | —                     | —           |
 | 
			
		||||
 | 
			
		||||
### props
 | 
			
		||||
| Attribute | Description | Type | Accepted Values | Default |
 | 
			
		||||
| --------- | ----------------- | ------ | ------ | ------ |
 | 
			
		||||
| label     | specify which key of option object is used as the option's label | string | — | — |
 | 
			
		||||
| value     | specify which key of option object is used as the option's value | string | — | — |
 | 
			
		||||
| children  | specify which key of option object is used as the option's child options | string | — | — |
 | 
			
		||||
| disabled  | specify which key of option object indicates if the option is disabled | string | — | — |
 | 
			
		||||
| Atributo | Descripción                              | Tipo   | Valores aceptados | Por defecto |
 | 
			
		||||
| -------- | ---------------------------------------- | ------ | ----------------- | ----------- |
 | 
			
		||||
| label    | especifica qué clave del elemento de la opción se utiliza como etiqueta | string | —                 | —           |
 | 
			
		||||
| value    | especifica qué clave del elemento de la opción se utiliza como valor | string | —                 | —           |
 | 
			
		||||
| children | especifica qué clave del elemento de la opción se utiliza como hijo | string | —                 | —           |
 | 
			
		||||
| disabled | especifica qué clave del elemento de la opción indica si está deshabilitada | string | —                 | —           |
 | 
			
		||||
 | 
			
		||||
### Eventos
 | 
			
		||||
| Nombre             | Descripción                              | Parametros                |
 | 
			
		||||
| ------------------ | ---------------------------------------- | ------------------------- |
 | 
			
		||||
| change             | se dispara cuando el valor cambia        | valor                     |
 | 
			
		||||
| active-item-change | se dispara cuando cambia la opción activa, sólo funciona cuando `change-on-select` es `false`. | array de opciones activas |
 | 
			
		||||
 | 
			
		||||
### Events
 | 
			
		||||
| Event Name | Description | Parameters |
 | 
			
		||||
|---------- |-------- |---------- |
 | 
			
		||||
| change  | triggers when the binding value changes | value |
 | 
			
		||||
| active-item-change | triggers when active option changes, only works when `change-on-select` is `false` | an array of active options |
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
		Reference in New Issue