@@ -324,14 +324,16 @@ Incluye todo tipo de entradas, tales como `input`, `select`, `radio` y `checkbox
...
@@ -324,14 +324,16 @@ Incluye todo tipo de entradas, tales como `input`, `select`, `radio` y `checkbox
}
}
</script>
</script>
```
```
:::
:::
:::tip
:::tip
[W3C](https://www.w3.org/MarkUp/html-spec/html-spec_8.html#SEC8.2) reglamenta que
[W3C](https://www.w3.org/MarkUp/html-spec/html-spec_8.html#SEC8.2) reglamenta que
> <i>Cuando sólo hay un campo de entrada de texto de una sola línea en un formulario, el agente usuario debe aceptar <b>Enter</b> en ese campo como una solicitud para enviar el formulario.</i>
> <i>Cuando sólo hay un campo de entrada de texto de una sola línea en un formulario, el agente usuario debe aceptar <b>Enter</b> en ese campo como una solicitud para enviar el formulario.</i>
Para prevenir este comportamiento, puede agregar `@submit.native.prevent` on `<el-form>`.
Para prevenir este comportamiento, puede agregar `@submit.native.prevent` on `<el-form>`.
:::
:::
### Formulario inline
### Formulario inline
...
@@ -372,6 +374,7 @@ Cuando el espacio vertical es limitado y la forma es relativamente simple, puede
...
@@ -372,6 +374,7 @@ Cuando el espacio vertical es limitado y la forma es relativamente simple, puede
}
}
</script>
</script>
```
```
:::
:::
### Alineamiento
### Alineamiento
...
@@ -413,13 +416,14 @@ Dependiendo de su diseño, hay varias maneras diferentes de alinear el elemento
...
@@ -413,13 +416,14 @@ Dependiendo de su diseño, hay varias maneras diferentes de alinear el elemento
}
}
</script>
</script>
```
```
:::
:::
### Validación
### Validación
El componente `form` le permite verificar sus datos, ayudándole a encontrar y corregir errores.
El componente `form` le permite verificar sus datos, ayudándole a encontrar y corregir errores.
:::demo Sólo tiene que añadir el atributo `rules` en el componente `Form`, pasar las reglas de validación y establecer el atributo `prop` para `Form-Item` como una clave específica que necesita ser validada. Ver más información en [async-validator](https://github.com/yiminghe/async-validator).
:::demo Sólo tiene que añadir el atributo `rules` en el componente `Form`, pasar las reglas de validación y establecer el atributo `prop` para `Form-Item` como una clave específica que necesita ser validada. Ver más información en [async-validator](https://github.com/yiminghe/async-validator).
@@ -528,6 +532,7 @@ El componente `form` le permite verificar sus datos, ayudándole a encontrar y c
...
@@ -528,6 +532,7 @@ El componente `form` le permite verificar sus datos, ayudándole a encontrar y c
}
}
</script>
</script>
```
```
:::
:::
### Reglas personalizadas de validación
### Reglas personalizadas de validación
...
@@ -627,9 +632,10 @@ Este ejemplo muestra cómo personalizar sus propias reglas de validación para f
...
@@ -627,9 +632,10 @@ Este ejemplo muestra cómo personalizar sus propias reglas de validación para f
}
}
</script>
</script>
```
```
:::
:::
### Eliminar o agregar validaciones dinamicamente
### Eliminar o agregar validaciones dinamicamente
:::demo Además de pasar todas las reglas de validación al mismo tiempo en el componente `form`, también puede pasar las reglas de validación o borrar reglas en un único campo de formulario de forma dinámica.
:::demo Además de pasar todas las reglas de validación al mismo tiempo en el componente `form`, también puede pasar las reglas de validación o borrar reglas en un único campo de formulario de forma dinámica.
...
@@ -705,6 +711,7 @@ Este ejemplo muestra cómo personalizar sus propias reglas de validación para f
...
@@ -705,6 +711,7 @@ Este ejemplo muestra cómo personalizar sus propias reglas de validación para f
}
}
</script>
</script>
```
```
:::
:::
### Validación numerica
### Validación numerica
...
@@ -755,6 +762,7 @@ Este ejemplo muestra cómo personalizar sus propias reglas de validación para f
...
@@ -755,6 +762,7 @@ Este ejemplo muestra cómo personalizar sus propias reglas de validación para f
}
}
</script>
</script>
```
```
:::
:::
:::tip
:::tip
...
@@ -831,67 +839,71 @@ Todos los componentes de un formulario heredan su atributo `size`. De manera sim
...
@@ -831,67 +839,71 @@ Todos los componentes de un formulario heredan su atributo `size`. De manera sim
};
};
</script>
</script>
```
```
:::
:::
### Form Atributos
### Form Atributos
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| inline | Si el form es inline | boolean | — | false |
| inline | Si el form es inline | boolean | — | false |
| label-position | Posicion de la etiqueta. Si esta 'left' o 'right', también se necesita el prop `label-width` | string | left / right / top | right |
| label-position | Posicion de la etiqueta. Si esta 'left' o 'right', también se necesita el prop `label-width`| string | left / right / top | right |
| label-width | ancho de la etiqueta, y todos los form items directos descendientes heredarán este valor | string | — | — |
| label-width | ancho de la etiqueta, y todos los form items directos descendientes heredarán este valor | string | — | — |
| label-suffix | sufijo de la etiqueta | string | — | — |
| label-suffix | sufijo de la etiqueta | string | — | — |
| show-message | si mostrar o no el mensaje de error | boolean | — | true |
| show-message | si mostrar o no el mensaje de error | boolean | — | true |
| inline-message | si desea visualizar el mensaje de error inline con la posición del form item | boolean | — | false |
| inline-message | si desea visualizar el mensaje de error inline con la posición del form item | boolean | — | false |
| status-icon | si desea visualizar un icono que indique el resultado de la validación | boolean | — | false |
| status-icon | si desea visualizar un icono que indique el resultado de la validación | boolean | — | false |
| validate-on-rule-change | si se dispara la validacion cuando el prop `rules` cambia | boolean | — | true |
| validate-on-rule-change | si se dispara la validacion cuando el prop `rules` cambia | boolean | — | true |
| size | el tamaño de los componentes en este form | string | medium / small / mini | — |
| size | el tamaño de los componentes en este form | string | medium / small / mini | — |
| disabled | si se desactivan todos los componentes del formulario. Si esta en `true` no puede ser cambiado por el prop `disabled` individual de los componentes. | boolean | — | false |
| disabled | si se desactivan todos los componentes del formulario. Si esta en `true` no puede ser cambiado por el prop `disabled` individual de los componentes. | boolean | — | false |
| validate | el método para validar todo el formulario. Takes a callback as a param. After validation, the callback will be executed with two params: a boolean indicating if the validation has passed, and an object containing all fields that fail the validation. Devuelve una promesa si se omite el return | Function(callback: Function(boolean, object)) |
| validate | el método para validar todo el formulario. Takes a callback as a param. After validation, the callback will be executed with two params: a boolean indicating if the validation has passed, and an object containing all fields that fail the validation. Devuelve una promesa si se omite el return | Function(callback: Function(boolean, object)) |
| validateField | el método para validar un determinado form item | Function(prop: string, callback: Function(errorMessage: string)) |
| validateField | el método para validar un determinado form item | Function(prop: string, callback: Function(errorMessage: string)) |
| resetFields | restablece todos los campos y elimina el resultado de validación | — |
| resetFields | restablece todos los campos y elimina el resultado de validación | — |
| clearValidate |limpieza de validación para determinados campos. El parámetro es un conjunto de nombres de propiedad de los elementos del formulario cuyos mensajes de validación se eliminarán. Si se omiten, se borrarán todos los mensajes de validación de los campos. | Function(props: array)
| clearValidate | limpieza de validación para determinados campos. El parámetro es un conjunto de nombres de propiedad de los elementos del formulario cuyos mensajes de validación se eliminarán. Si se omiten, se borrarán todos los mensajes de validación de los campos. | Function(props: array) |
| validate | se dispara después de validar un item del formulario | la propiedad (`prop name`) nombre del item del form que se esta validando, si la validacion paso o no. |
| validate | se dispara después de validar un item del formulario | la propiedad (`prop name`) nombre del item del form que se esta validando, si la validacion paso o no. |
### Form-Item Atributos
### Form-Item Atributos
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| prop | un key de `model`. En el uso del método validate and resetFields, el atributo es obligatorio. | string | keys of model that passed to `form` | |
| prop | un key de `model`. En el uso del método validate and resetFields, el atributo es obligatorio. | string | keys of model that passed to `form` | |
| label | etiqueta | string | — | — |
| label | etiqueta | string | — | — |
| label-width | ancho de la etiqueta, e.g. '50px' | string | — | — |
| label-width | ancho de la etiqueta, e.g. '50px' | string | — | — |
| required | si el campo es obligatorio o no, estará determinado por las reglas de validación si se omite. | boolean | — | false |
| required | si el campo es obligatorio o no, estará determinado por las reglas de validación si se omite. | boolean | — | false |
| rules | reglas de validacion del form | object | — | — |
| rules | reglas de validacion del form | object | — | — |
| error | mensaje de error de campo, establezca su valor y el campo validará el error y mostrará este mensaje inmediatamente. | string | — | — |
| error | mensaje de error de campo, establezca su valor y el campo validará el error y mostrará este mensaje inmediatamente. | string | — | — |
| show-message | si mostrar o no el mensaje de error | boolean | — | true |
| show-message | si mostrar o no el mensaje de error | boolean | — | true |
| inline-message | mensaje de validación estilo inline | boolean | — | false |
| inline-message | mensaje de validación estilo inline | boolean | — | false |
| size | Tamaño de los componentes en este form item | string | medium / small / mini | - |
| size | Tamaño de los componentes en este form item | string | medium / small / mini | - |
### Form-Item Slot
### Form-Item Slot
| Nombre | Descripción |
| Nombre | Descripción |
| ------ | ------------------------ |
| ------ | ------------------------ |
| — | contenido del Form Item |
| — | contenido del Form Item |
| label | contenido de la etiqueta |
| label | contenido de la etiqueta |
### Form-Item Scoped Slot
### Form-Item Scoped Slot
| Name | Description |
|---------------|-------------|
| Name | Description |
| error | Custom content to display validation message. The scope parameter is { error } |
:::demo Deshabilite el Input con el atributo `disabled`.
:::demo Deshabilite el Input con el atributo `disabled`.
```html
```html
<el-input
<el-input
...
@@ -186,6 +187,7 @@ export default {
...
@@ -186,6 +187,7 @@ export default {
}
}
</script>
</script>
```
```
:::
:::
### Input con icono
### Input con icono
...
@@ -242,6 +244,7 @@ export default {
...
@@ -242,6 +244,7 @@ export default {
}
}
</script>
</script>
```
```
:::
:::
### Textarea
### Textarea
...
@@ -268,6 +271,7 @@ export default {
...
@@ -268,6 +271,7 @@ export default {
}
}
</script>
</script>
```
```
:::
:::
### Textarea tamaño automatico
### Textarea tamaño automatico
...
@@ -302,6 +306,7 @@ export default {
...
@@ -302,6 +306,7 @@ export default {
}
}
</script>
</script>
```
```
:::
:::
### Mezclando elementos con input
### Mezclando elementos con input
...
@@ -353,6 +358,7 @@ export default {
...
@@ -353,6 +358,7 @@ export default {
}
}
</script>
</script>
```
```
:::
:::
### Tamaño
### Tamaño
...
@@ -395,6 +401,7 @@ export default {
...
@@ -395,6 +401,7 @@ export default {
}
}
</script>
</script>
```
```
:::
:::
### Autocompletado
### Autocompletado
...
@@ -469,13 +476,14 @@ Puede obtener algunas sugerencias basadas en la entrada actual.
...
@@ -469,13 +476,14 @@ Puede obtener algunas sugerencias basadas en la entrada actual.
}
}
</script>
</script>
```
```
:::
:::
### Template personalizado
### Template personalizado
Personalice cómo se muestran las sugerencias.
Personalice cómo se muestran las sugerencias.
:::demo Utilice `scoped slot` para personalizar los elementos de sugerencias. En el scope, puede acceder al objeto de sugerencia mediante la clave `item`.
:::demo Utilice `scoped slot` para personalizar los elementos de sugerencias. En el scope, puede acceder al objeto de sugerencia mediante la clave `item`.
```html
```html
<el-autocomplete
<el-autocomplete
...
@@ -557,6 +565,7 @@ Personalice cómo se muestran las sugerencias.
...
@@ -557,6 +565,7 @@ Personalice cómo se muestran las sugerencias.
}
}
</script>
</script>
```
```
:::
:::
### Búsqueda remota
### Búsqueda remota
...
@@ -564,6 +573,7 @@ Personalice cómo se muestran las sugerencias.
...
@@ -564,6 +573,7 @@ Personalice cómo se muestran las sugerencias.
Búsqueda de datos desde el servidor.
Búsqueda de datos desde el servidor.
:::demo
:::demo
```html
```html
<el-autocomplete
<el-autocomplete
v-model="state4"
v-model="state4"
...
@@ -616,35 +626,36 @@ Búsqueda de datos desde el servidor.
...
@@ -616,35 +626,36 @@ Búsqueda de datos desde el servidor.
};
};
</script>
</script>
```
```
:::
:::
### Input atributos
### Input atributos
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| type | tipo de input | string | text, textarea y otros [tipos de entrada nativos](https://developer.mozilla.org/es/docs/Web/HTML/Elemento/input#Form_%3Cinput%3E_types) | text |
| type | tipo de input | string | text, textarea y otros [tipos de entrada nativos](https://developer.mozilla.org/es/docs/Web/HTML/Elemento/input#Form_%3Cinput%3E_types) | text |
| value | valor enlazado | string / number | — | — |
| value | valor enlazado | string / number | — | — |
| maxlength | igual que `maxlength` en el input nativo | number | — | — |
| maxlength | igual que `maxlength` en el input nativo | number | — | — |
| minlength | igual que `minlength` en el input nativo | number | — | — |
| minlength | igual que `minlength` en el input nativo | number | — | — |
| disabled | si esta deshabilitado | boolean | — | false |
| disabled | si esta deshabilitado | boolean | — | false |
| size | tamaño del input, esto no funciona cuando `type` no es textarea | string | medium / small / mini | — |
| size | tamaño del input, esto no funciona cuando `type` no es textarea | string | medium / small / mini | — |
| prefix-icon | clase del icono de prefijo | string | — | — |
| prefix-icon | clase del icono de prefijo | string | — | — |
| suffix-icon | clase del icono de sufijo | string | — | — |
| suffix-icon | clase del icono de sufijo | string | — | — |
| rows | número de filas, sólo funciona cuando `type` es 'textarea'. | number | — | 2 |
| rows | número de filas, sólo funciona cuando `type` es 'textarea'. | number | — | 2 |
| autosize | si textarea tiene una altura adaptativa, sólo funciona cuando el`type` es 'textarea'. Puede aceptar un objeto, p. ej. { minRows: 2, maxRows: 6 } | boolean / object | — | false |
| autosize | si textarea tiene una altura adaptativa, sólo funciona cuando el`type` es 'textarea'. Puede aceptar un objeto, p. ej. { minRows: 2, maxRows: 6 } | boolean / object | — | false |
| autocomplete | igual que `autocomplete` en el input nativo | string | on/off | off |
| autocomplete | igual que `autocomplete` en el input nativo | string | on/off | off |
| auto-complete | @DEPRECATED in next major version | string | on/off | off |
| auto-complete | @DEPRECATED en el proximo cambio mayor de version | string | on/off | off |
| name | igual que `name` en el input nativo | string | — | — |
| name | igual que `name` en el input nativo | string | — | — |
| readonly | igual que `readonly` en el input nativo | boolean | — | false |
| readonly | igual que `readonly` en el input nativo | boolean | — | false |
| max | igual que `max` en el input nativo | — | — | — |
| max | igual que `max` en el input nativo | — | — | — |
| min | igual que `min` en el input nativo | — | — | — |
| min | igual que `min` en el input nativo | — | — | — |
| step | igual que `step` en el input nativo | — | — | — |
| step | igual que `step` en el input nativo | — | — | — |
| resize | control para el dimensionamiento | string | none, both, horizontal, vertical | — |
| resize | control para el dimensionamiento | string | none, both, horizontal, vertical | — |
| autofocus | igual que `autofocus` en el input nativo | boolean | — | false |
| autofocus | igual que `autofocus` en el input nativo | boolean | — | false |
| form | igual que `form` en el input nativo | string | — | — |
| form | igual que `form` en el input nativo | string | — | — |
| label | texto de la etiqueta | string | — | — |
| label | texto de la etiqueta | string | — | — |
| tabindex | orden de tabulacion para el Input | string | - | - |
| tabindex | orden de tabulacion para el Input | string | - | - |
### Input slots
### Input slots
...
@@ -657,42 +668,42 @@ Búsqueda de datos desde el servidor.
...
@@ -657,42 +668,42 @@ Búsqueda de datos desde el servidor.
|fetch-suggestions | un método para obtener las sugerencias del input. Cuando las sugerencias estén listas, invocar `callback(data:[])` para devolverlas a Autocomplete | Function(queryString, callback) | — | — |
| fetch-suggestions | un método para obtener las sugerencias del input. Cuando las sugerencias estén listas, invocar `callback(data:[])` para devolverlas a Autocomplete | Function(queryString, callback) | — | — |
| popper-class | nombre personalizado de clase para el dropdown de autocomplete | string | — | — |
| popper-class | nombre personalizado de clase para el dropdown de autocomplete | string | — | — |
| trigger-on-focus | si se deben mostrar sugerencias cuando el input obtiene el foco | boolean | — | true |
| trigger-on-focus | si se deben mostrar sugerencias cuando el input obtiene el foco | boolean | — | true |
| name | igual que `name` en el input nativo | string | — | — |
| name | igual que `name` en el input nativo | string | — | — |
| select-when-unmatched | si se emite un evento `select` al pulsar enter cuando no hay coincidencia de Autocomplete | boolean | — | false |
| select-when-unmatched | si se emite un evento `select` al pulsar enter cuando no hay coincidencia de Autocomplete | boolean | — | false |
| hide-loading | si se debe ocultar el icono de loading en la búsqueda remota | boolean | — | false |
| hide-loading | si se debe ocultar el icono de loading en la búsqueda remota | boolean | — | false |
| popper-append-to-body | si añadir el desplegable al cuerpo. Si la posición del menú desplegable es incorrecta, puede intentar establecer este prop a false | boolean | - | true |
| popper-append-to-body | si añadir el desplegable al cuerpo. Si la posición del menú desplegable es incorrecta, puede intentar establecer este prop a false | boolean | - | true |
### Autocomplete Slots
### Autocomplete Slots
...
@@ -705,14 +716,14 @@ Atributo | Descripción | Tipo | Opciones | Por defecto
...
@@ -705,14 +716,14 @@ Atributo | Descripción | Tipo | Opciones | Por defecto