desy-angular v3.0 - Manual de integración DesyTablesModule

Componentes relativos a tablas


Vamos a ver como se usa cada uno de los componentes.

 

Table


<desy-table ...>...</desy-table>

Permite representar una tabla

Propiedad

Tipo

Descripción

Obligatorio

Propiedad

Tipo

Descripción

Obligatorio

rows

Array<CellData[]>

Contiene la información relativa a cada celda.

Si

head

CellData[]

Contiene la información relativa a la lista de cabeceras de la tabla.

 

id

string

Identificador del elemento <div>.

 

caption

string

Contenido del caption.

 

captionClasses

string

Clases CSS separadas por espacio que se aplicarán sobre el elemento <caption>.

Si se incluye el elemento <desy-caption> como contenido, se utilizará en su lugar la propiedad de dicho elemento.

 

firstCellIsHeader

boolean

Cuando es true, intercambia la primera celda de las filas de la tabla de <td> a <th>.

 

classes

string

Clases CSS separadas por espacio que se aplicarán sobre el elemento <table>.



 

Objeto CellData

Propiedad

Tipo

Descripción

Obligatorio

Propiedad

Tipo

Descripción

Obligatorio

id

string

Identificador



text

string

Contenido del texto en formato texto plano. No se aplicará cuando se especifique la propiedad html.

Si, cuando no se especifica html.

html

string

Contenido del texto en formato HTML.

Si, cuando no se especifica text.

classes

string

Classes CSS separadas por espacio que se aplicarán sobre los objetos de este tipo

 

colspan

number

Especifica el número de columnas que se extiende una celda

 

rowspan

number

Especifica el numero de filas que se extiende una celda

 

 

Propiedades de accesibilidad

El componente Table y cada CellData admiten los siguientes parámetros de accesibilidad.

 

Se permite proyectar contenido dentro de table para facilitar su uso. Para ello se facilitan los siguientes sub-componentes:

TableCaptionComponent

<desy-table-caption ...>...</desy-table-caption>

Permite especificar el caption. Admite la propiedad classes.

TableHeaderComponent

<desy-table-header>...</desy-table-header>

Permite agrupar las celdas de la cabecera.

TableRowComponent

Permite agrupar las celdas de cada fila.

TableCellComponent

Permite especificar una celda. Admite los mismos parámetros de entrada que el objeto CellData.

Implementación con contenido
Implementación con parámetros



 

 

Table advanced


Permite representar una tabla con elementos de búsqueda, ordenación y selección.

Propiedad

Tipo

Descripción

Obligatorio

Propiedad

Tipo

Descripción

Obligatorio

rows

RowData[]

Contiene la información relativa a cada fila. Admite double-binding.

 

head

HeadCellData[]

Contiene la información relativa a la lista de cabeceras de la tabla.

 

id

string

Identificador del elemento.



idPrefix

string

Prefijo a usar para los identificadores

 

caption

string

Contenido del caption

 

captionClasses

string

Clases CSS separadas por espacio que se aplicarán sobre el elemento <caption>

 

firstCellIsHeader

boolean

Cuando es true, intercambia la primera celda de las filas de la tabla de <td> a <th>

 

hasCheckboxes

boolean

Indica si la primera columna se muestran checkbox de selección.

 

classes

string

Clases CSS separadas por espacio que se aplicarán sobre el elemento <table>



 

Objeto HeadCellData

Propiedad

Tipo

Descripción

Obligatorio

Propiedad

Tipo

Descripción

Obligatorio

id

string

Identificador



text

string

Contenido del texto en formato texto plano. No se aplicará cuando se especifique la propiedad html.

Si, cuando no se especifica html.

html

string

Contenido del texto en formato HTML.

Si, cuando no se especifica text.

classes

string

Classes CSS separadas por espacio que se aplicarán sobre los objetos de este tipo

 

colspan

number

Especifica el número de columnas que se extiende una celda

 

rowspan

number

Especifica el numero de filas que se extiende una celda

 

hasFilter

boolean

Indica si tiene esta columna una barra de buscador.

 

filterClasses

string

Clases css a aplicar al buscador de la columna

 

orderBy

string

Indica si esa columna tiene ordenación y cual es su valor inicial.

Posibles valores: none, asc o desc.

 

 

Objeto RowData

Propiedad

Tipo

Descripción

Obligatorio

Propiedad

Tipo

Descripción

Obligatorio

id

string

Identificador de la fila.

Este identificador se usara en el evento emitido de selección.

Si, cuando tiene checkboxes.

cellsList

CellData[]

Contiene la información relativa a cada celda.

Si

checked

boolean

Permite indicar si la fila está seleccionada. Debe de estar habilitada la opción hasCheckboxes en el componente.

 

 

Objeto CellData

Propiedad

Tipo

Descripción

Obligatorio

Propiedad

Tipo

Descripción

Obligatorio

id

string

Identificador



text

string

Contenido del texto en formato texto plano. No se aplicará cuando se especifique la propiedad html.

Si, cuando no se especifica html.

html

string

Contenido del texto en formato HTML.

Si, cuando no se especifica text.

classes

string

Classes CSS separadas por espacio que se aplicarán sobre los objetos de este tipo

 

colspan

number

Especifica el número de columnas que se extiende una celda

 

rowspan

number

Especifica el numero de filas que se extiende una celda

 

 

Propiedades de accesibilidad

El componente, cada CellData y HeadCellData admiten los siguientes parámetros de accesibilidad.



Se permite proyectar contenido dentro de table-advanced para facilitar su uso. Para ello se facilitan los siguientes sub-componentes:

TableCaptionComponent

Permite especificar el caption. Admite la propiedad classes.

TableAdvancedHeaderComponent

Permite agrupar las celdas de la cabecera.

TableAdvancedHeaderCellComponent

Permite especificar una celda de la cabecera. Admite los mismos parámetros de entrada que el objeto HeadCellData.

TableAdvancedRowComponent

Permite agrupar las celdas de cada fila. Admite los mismos parámetros de entrada que el objeto RowData. El parámetro checked admite double-binding, así como detectar un cambio mediante el evento checkedChange.

TableAdvancedRowCellComponent

Permite especificar una celda de una fila normal de la tabla. Admite los mismos parámetros de entrada que el objeto CellData.



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

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