Tabla
Las tablas muestran conjuntos de datos. Se pueden personalizar por completo.
Las tablas muestran la información de forma fácil de examinar, para que los usuarios puedan buscar patrones e información útil. Se pueden insertar en contenido principal, como tarjetas.
Tabla simple
Un ejemplo sencillo y sin adornos. Las columnas de la tabla se definen a partir de los datos.
Tabla con columnas personalizadas
Defina columnas personalizadas para su tabla.
Tabla con renderizado de columnas personalizado
Defina el renderizado de columnas. La ordenación y la exportación siguen funcionando en la tabla.
Ancho de columna de la tabla
El ancho de columna se puede definir mediante el parámetro -Width. También puede decidir truncar las columnas que se extiendan más allá de ese ancho.
Filtros
Puede configurar filtros personalizados por columna. La tabla admite los filtros text, select, fuzzy , slider, range, date , number y autocomplete.
Opciones estáticas para los filtros de selección
Cuando se utiliza el procesamiento en el servidor, los filtros disponibles pueden no mostrar todo el rango de opciones, ya que el desplegable de selección solo tiene acceso a la página de resultados actual. Para evitarlo, puede utilizar el parámetro -Options en New-UDTableColumn.
Buscar
Para habilitar la búsqueda, utilice el parámetro -ShowSearch en New-UDTable.
Cuando utilice columnas personalizadas, deberá añadir el parámetro -IncludeInSearch a las columnas que desee incluir en la búsqueda.
Tabla con procesamiento en el servidor
Procese los datos en el servidor para poder realizar la paginación, el filtrado, la ordenación y la búsqueda en sistemas como SQL. Para implementar una tabla en el servidor, utilizará el parámetro -LoadData. Este parámetro acepta un ScriptBlock. La variable $EventData incluye información sobre el estado de la tabla. Puede utilizar cmdlets para procesar los datos en función de esta información.
Estructura de $EventData
El objeto $EventData contiene las siguientes propiedades.
Filters
Hashtable[] @{ id = 'fieldName'
value = 'filterValue' }
Una lista de valores de filtro. Cada hashtable tiene una propiedad Id y una propiedad Value.
OrderBy
Hashtable @{ field = "fieldName" }
Nombre de la propiedad por la que ordenar.
OrderDirection
string
asc o desc según el orden de clasificación.
Page
int
La página actual (empezando por 0).
PageSize
int
El tamaño de página seleccionado.
Properties
string[]
Una matriz de propiedades que se muestran en la tabla.
Search
string
Una cadena de búsqueda proporcionada por el usuario.
TotalCount
int
El número total de registros antes del filtrado o la paginación.
Ejemplo
Recuperar los datos mostrados
Puede que desee permitir que el usuario actúe sobre el conjunto actual de datos mostrados. Para ello, utilice Get-UDElement en el objeto de entrada del que desee recuperar los datos y obtenga la tabla por Id. Una vez que tenga el elemento, puede utilizar la propiedad Data del elemento para obtener una matriz de las filas mostradas actualmente.
Paginación
De forma predeterminada, la paginación está deshabilitada y las tablas crecerán según el número de filas de datos que proporcione. Puede habilitar la paginación utilizando el cmdlet -ShowPagination (alias -Paging). Puede configurar el tamaño de página utilizando el cmdlet -PageSize.
Deshabilitar el tamaño de página Todo
De forma predeterminada, el selector de tamaño de página ofrece una opción para mostrar todas las filas. Si desea impedir que los usuarios hagan esto, utilice el cmdlet -DisablePageSizeAll.
Ubicación de la paginación
Puede cambiar la ubicación del control de paginación utilizando el parámetro -PaginationLocation. Acepta top, bottom y both.
Tamaños de página
El tamaño de página, de forma predeterminada, se establece en 5. Los usuarios pueden ajustar el número de filas por página utilizando el desplegable Filas por página. Puede ajustar el tamaño de página predeterminado utilizando el parámetro -PageSize. Para ajustar los valores disponibles en el desplegable Filas por página, puede pasar una matriz de enteros al parámetro -PageSizeOptions.
Ordenación
Para habilitar la ordenación de una tabla, utilice el parámetro -ShowSort. Cuando habilite la ordenación, podrá hacer clic en los encabezados de la tabla para ordenarla haciendo clic en los encabezados. De forma predeterminada, la ordenación múltiple está habilitada. Para ordenar por varias columnas, mantenga pulsada la tecla Mayús y haga clic en el encabezado de una columna.
Puede controlar qué columnas se pueden ordenar utilizando New-UDTableColumn y el parámetro -ShowSort.
Deshabilitar la eliminación de la ordenación
De forma predeterminada, la ordenación de una tabla tiene 3 estados: sin ordenar, ascendente y descendente. Si desea deshabilitar el estado sin ordenar, utilice el parámetro -DisableSortRemove de New-UDTable.
Selección
Datos de tabla estáticos
Las tablas admiten la selección de filas. Puede crear un controlador de eventos para el parámetro OnRowSelected a fin de recibir cuándo se selecciona o se anula la selección de una nueva fila, o puede utilizar Get-UDElement para recuperar el conjunto actual de filas seleccionadas.
El siguiente ejemplo crea una tabla con la selección de filas habilitada. Se muestra un aviso al hacer clic en la fila o al hacer clic en el botón GET Rows.
La variable $EventData para el evento -OnRowSelected incluirá todas las columnas como propiedades y una propiedad selected que indica si la fila se ha seleccionado o se ha anulado su selección.
Por ejemplo, los datos de la tabla de servicios tendrían este aspecto.
Tablas dinámicas (en el servidor)
Cuando se utiliza la selección junto con -LoadData, el -OnRowSelected $EventData contendrá los ID de las filas y no todos los datos de la fila. Seguirá indicando si la fila se ha seleccionado o se ha anulado su selección.
Filas contraíbles
Puede incluir información adicional en la tabla utilizando el parámetro -OnRowExpand de New-UDTable. Acepta un ScriptBlock que puede utilizar para devolver componentes adicionales.
Exportación
Las tablas admiten la exportación de los datos que contienen. Puede exportar como CSV, XLSX, JSON o PDF. Puede definir qué columnas incluir en una exportación y elegir exportar solo la página actual o todos los datos de la tabla.
Columnas ocultas
Las columnas ocultas le permiten incluir datos que no se muestran en la tabla pero que sí se incluyen en los datos exportados.
Lo siguiente oculta la columna StartType al usuario pero la incluye en la exportación.
Exportación en el servidor
Puede controlar la funcionalidad de exportación con un bloque de script de PowerShell. Esto resulta útil al exportar desde orígenes en el servidor, como tablas de SQL Server.
En este ejemplo, tengo una tabla SQL que contiene podcasts. Al exportar, recibirá información sobre el estado actual de la tabla para poder personalizar qué datos se exportan.
Personalizar las opciones de exportación
Puede decidir qué opciones de exportación presentar a sus usuarios utilizando el cmdlet -ExportOption. El siguiente ejemplo solo mostraría la opción de exportación CSV.
Personalizar las etiquetas
Puede utilizar el parámetro -TextOption junto con el cmdlet New-UDTableTextOption para establecer los campos de texto dentro de la tabla.
Actualizar con un botón
Parámetro Data
Puede actualizar una tabla de forma externa colocándola dentro de una región dinámica y utilizando Sync-UDElement.
Este ejemplo crea un botón para actualizar la tabla.
Parámetro LoadData
Si utiliza el parámetro -LoadData, puede sincronizar la tabla directamente. Esto tiene la ventaja de mantener el estado de la tabla, como la página y el filtrado, después de la actualización.
Mostrar el botón de actualización
Puede utilizar el parámetro -ShowRefresh para proporcionar un botón de actualización en las tablas del servidor.
Colores de fila alternos
Puede utilizar un tema para crear una tabla con colores de fila alternos.
Estilos de fila personalizados
Utilice el parámetro -OnRowStyle para aplicar estilo a las filas en función de su contenido. Devuelva un hashtable con estilos CSS para la fila.
API
Véase también
Última actualización
¿Te fue útil?