Table of Contents | ||||
---|---|---|---|---|
|
Componentes relativos a formularios
Los componentes que el usuario pueda introducir un valor, podra ser implementado con:
En formularios manejados por plantillas (Template-driven Forms), vinculando el dato mediante ngModel.
En formularios reactivos (Reactive Forms), indicando el nombre del control mediante el atributo formControlName.
...
Character count
...
Code Block | ||
---|---|---|
| ||
<desy-character-count ... ></desy-character-count> |
...
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Propiedades de accesibilidad El componente admite los parámetros de accesibilidad. |
Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Ejemplo básico, utilizando ngModel
Ejemplo completo, utilizando formControlName Componente
HTML utilizando labelText, hintText y errorMessageText
HTML utilizando labelData, hintData y errorMessageData
HTML utilizando labelRef, hintRef y errorMessageRef
|
Checkboxes
...
Code Block | ||
---|---|---|
| ||
<desy-checkboxes ... >...</desy-checkboxes> |
Permite representar un listado de checkboxes.
...
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ItemCheckboxData
Propiedades de accesibilidad El componente e ItemCheckboxData admite los siguientes parámetros de accesibilidad. |
Expand | ||
---|---|---|
| ||
Se permite proyectar contenido dentro de checkboxes para facilitar su uso. Admite los siguientes componentes: FieldsetComponent
Permite especificar las propiedades del fieldset. No se debe especificar el caller de este componente, ya que se sobrescribirá internamente. LegendComponent
Si no se especifica el componente fieldset, se puede utilizar para incorporar el título. HintComponent
Permite especificar la descripción de ayuda. Se ignorará el parámetro id, ya que se sobrescribirá internamente. ErrorMessageComponent
Permite especificar el mensaje de error. Se ignorará el parámetro id, ya que se sobrescribirá internamente. CheckboxItemComponent
Permite especificar cada checkbox. Admite los mismos parámetros que ItemCheckboxData. El parámetro checked admite double-binding. A su vez, este componente admite como contenido los componentes LabelComponent, HintComponent y ContentComponent. Este último permite especificar el contenido condicional que se mostrará al seleccionar el checkbox, siempre y cuando se especifice el parámetro conditional a true. Si no se especifica el LabelComponent, el contenido (salvo los componentes HintContent y ContentComponent, si se especifican) será insertado dentro de un label de forma interna. |
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Ejemplo con contenido y NgModelComponente
HTML
|
...
Ejemplo con parámetros y NgModelComponente
HTML
Ejemplo con Formulario y condicionales |
Date-input
...
Code Block | ||
---|---|---|
| ||
<desy-date-input ... ></desy-date-input> |
...
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
Ejemplo con contenido y ngModel
Ejemplos con NgModel y Template DrivenComponente
HTML con campo independiente
HTML con campo utilizado en un formulario dirigido por plantilla
Ejemplo con Reactive formComponente
HTML
|
Anchor | ||||
---|---|---|---|---|
|
Error Message
...
Code Block | ||
---|---|---|
| ||
<desy-error-message ... ></desy-error-message> |
...
Expand | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
El componente admite los siguientes parámetros de accesibilidad. |
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Error message con entrada de texto
Error message con contenido
|
FieldSet
...
Code Block | ||
---|---|---|
| ||
<desy-filedset ... ></desy-fieldset> |
...
Expand | ||
---|---|---|
| ||
Se permite proyectar contenido dentro de fieldset para facilitar su uso. Admite los siguientes componentes: LegendComponent
Permite especificar el texto de legenda. ContentComponent
Permite especificar el contenido a incluir dentro del fieldset. |
Expand | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
HTML utilizando legendText
Fieldset utilizando contenido en la leyenda
HTML utilizando legendData
HTML utilizando legendRef
|
File Upload
...
Code Block | ||
---|---|---|
| ||
<desy-file-upload ... ></desy-file-upload> |
Permite seleccionar un archivo del dispositivo
...
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Propiedades de accesibilidad El componente admite los siguientes parámetros de accesibilidad. Este componente tiene personalizados los siguientes atributos.
|
Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Ejemplo básico, utilizando ngModel Componente
HTML
Ejemplo completo, utilizando formControlName Componente
HTML utilizando labelText, hintText y errorMessageText
HTML utilizando labelData, hintData y errorMessageData
HTML utilizando labelRef, hintRef y errorMessageRef
|
Anchor | ||||
---|---|---|---|---|
|
...
Code Block | ||
---|---|---|
| ||
<desy-hint ... ></desy-hint> |
...
Expand | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
Propiedades de accesibilidad El componente admite los siguientes parámetros de accesibilidad. |
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Hint con entrada de texto
Hint con entrada HTML
Hint con entrada de contenido
|
Input
...
Code Block | ||
---|---|---|
| ||
<desy-input ... ></desy-input> |
...
Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Ejemplo básico, utilizando ngModel Componente
HTML
Ejemplo completo, utilizando formControlName Componente
HTML utilizando labelText, hintText y errorMessageText
HTML utilizando labelData, hintData y errorMessageData
HTML utilizando labelRef, hintRef y errorMessageRef
|
Input-group
...
Code Block | ||
---|---|---|
| ||
<desy-input-group ... ></desy-input-group> |
...
Expand | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Ejemplo con contenido y NgModel
Ejemplo con parámetros y NgModelComponente
HTML con campo independiente
HTML con campo utilizado en un formulario reactivo
HTML con campo utilizado en un formulario dirigido por plantilla
|
Label
...
Code Block | ||
---|---|---|
| ||
<desy-label ... ></desy-label> |
Genera un etiqueta html label
...
Expand | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
Propiedades de accesibilidad El componente admite los siguientes parámetros de accesibilidad. |
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Label con entrada de texto
Label con contenido
|
Legend
...
Code Block | ||
---|---|---|
| ||
<desy-legend ...></desy-legend> |
...
Expand | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
Hint con entrada de texto
|
Radios
...
Code Block | ||
---|---|---|
| ||
<desy-radios ...></desy-radios> |
...
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ItemRadioData
El componente y ItemRadioData admite los siguientes parámetros de accesibilidad. |
Expand | ||
---|---|---|
| ||
Se permite proyectar contenido dentro de radios para facilitar su uso. Para ello se facilitan los siguientes sub-componentes: FieldsetComponent
Permite especificar las propiedades del fieldset. No se debe especificar el caller de este componente, ya que se sobrescribirá internamente. LegendComponent
Si no se especifica el componente fieldset, se puede utilizar para incorporar el título. HintComponent
Permite especificar la descripción de ayuda. Se ignorará el parámetro id, ya que se sobrescribirá internamente. ErrorMessageComponent
Permite especificar el mensaje de error. Se ignorará el parámetro id, ya que se sobrescribirá internamente. RadioItemComponent
Permite especificar cada radio. Admite los mismos parámetros que ItemRadioData. El parámetro checked admite double-binding. A su vez, este componente admite como contenido los componentes LabelComponent, HintComponent y ContentComponent. Este último permite especificar el contenido condicional que se mostrará al seleccionar el radio, siempre y cuando se especifice el parámetro conditional a true. Si no se especifica el LabelComponent, el contenido (salvo los componentes HintContent y ContentComponent, si se especifican) será insertado dentro de un label de forma interna. |
Expand | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
Ejemplo con contenido y NgModelComponente
HTML
Ejemplo parámetros y NgModelComponente
HTML
Ejemplo con Formulario y condicionales |
SearchBar
...
Code Block | ||
---|---|---|
| ||
<desy-search-bar ...></desy-search-bar> |
...
Expand | ||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||
El componente admite los siguientes parámetros de accesibilidad. Este componente tiene personalizados los siguientes atributos.
|
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Expand | ||
---|---|---|
| ||
Se permite insertar un componente Button como contenido del componente Searchbar. En este caso, no se mostrará el botón de búsqueda por defecto. |
Expand | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||
Ejemplo básico, utilizando ngModel Componente
Ejemplo utilizando un componente botón como contenido Componente
Ejemplo completo, utilizando formControlName Componente
|
Select
...
Code Block | ||
---|---|---|
| ||
<desy-select ...></desy-select> |
Permite representar un listado desplegable
...
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Objeto SelectItemData
El componente y SelectItemData admite los siguientes parámetros de accesibilidad. Este componente tiene personalizados los siguientes atributos.
|
Expand | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
Se permite proyectar contenido dentro del select para facilitar su uso. Para ello se facilitan los siguientes sub-componentes: LabelComponent
Permite indicar un texto en el componente. HintComponent
Permite indicar un texto de ayuda en el componente. ErrorMessageComponent
Permite indicar un mensaje de error en el componente. OptionComponent
Permite indicar una opción en el select del componente. OptionGroupComponent
Permite agrupar opciones dentro del menú desplegable. Admite las siguientes propiedades de entrada
Admite un listado de componentes OptionComponent como contenido. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Ejemplo con contenido y ngModel
Ejemplo básico, utilizando ngModel |
...
Componente
HTML
Ejemplo completo, utilizando formControlName |
...
Componente
HTML utilizando labelText, hintText y errorMessageText
HTML utilizando labelData, hintData y errorMessageData
HTML utilizando labelRef, hintRef y errorMessageRef
|
Textarea
...
Code Block | ||
---|---|---|
| ||
<desy-textarea ...></desy-textarea> |
...
Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
Ejemplo básico, utilizando ngModel Componente
HTML
Ejemplo completo, utilizando formControlName Componente
HTML utilizando labelText, hintText y errorMessageText
HTML utilizando labelData, hintData y errorMessageData
HTML utilizando labelRef, hintRef y errorMessageRef
|
Accesibilidad
...
En todos los componentes se han tenido en cuenta los siguiente parámetros de accesibilidad. Se detalla en cada componente.
Parámetro | Atributo de accesibilidad equivalente |
---|---|
role | role |
ariaLabel | aria-label |
ariaDescribedBy | aria-describedby |
ariaLabelledBy | aria-labelledby |
ariaHidden | aria-hidden |
ariaDisabled | aria-disabled |
ariaControls | aria-controls |
ariaCurrent | aria-current |
ariaLive | aria-live |
ariaExpanded | aria-expanded |
ariaErrorMessage | aria-errormessage |
ariaHasPopup | aria-haspopup |
ariaModal | aria-modal |
tabindex | tabindex |
Uso de los directivas de los formularios
...
Vamos a ver como se usa cada uno de las directivas.
ConditionDirective
...
Code Block |
---|
<ng-template desyCondition ...> ... </ng-template> |
...
Expand | ||||
---|---|---|---|---|
| ||||
|
...