For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tabel

Tabeller viser sæt af data. Tabellerne kan tilpasses fuldt ud.

Tabeller viser oplysninger på en måde, der er nem at overskue, så brugerne kan lede efter mønstre og indsigter. Tabellerne kan være integreret i primært indhold, f.eks. kort.

Simpel tabel

Et simpelt eksempel uden dikkedarer. Tabelkolonner defineres ud fra dataene.

Tabel med brugerdefinerede kolonner

Definer brugerdefinerede kolonner til Deres tabel.

Tabel med brugerdefineret gengivelse af kolonner

Definer kolonnegengivelse. Sortering og eksport fungerer stadig for tabellen.

Bredde på tabelkolonne

Kolonnebredden kan defineres ved hjælp af parameteren -Width. De kan også vælge at afkorte kolonner, der rækker ud over denne bredde.

Filtre

De kan konfigurere brugerdefinerede filtre pr. kolonne. Tabellen understøtter filtrene text, select, fuzzy , slider, range, date , number og autocomplete.

Statiske valgmuligheder for Select-filtre

Når De bruger behandling på serversiden, viser de tilgængelige filtre muligvis ikke det fulde udvalg af valgmuligheder, da select-rullemenuen kun har adgang til den aktuelle side med resultater. For at undgå dette kan De bruge parameteren -Options på New-UDTableColumn.

Søgning

For at aktivere søgning skal De bruge parameteren -ShowSearch på New-UDTable.

Når De bruger brugerdefinerede kolonner, skal De tilføje parameteren -IncludeInSearch til de kolonner, De vil medtage i søgningen.

Tabel med behandling på serversiden

Behandl data på serveren, så De kan udføre sideopdeling, filtrering, sortering og søgning i systemer som SQL. For at implementere en tabel på serversiden skal De bruge parameteren -LoadData. Denne parameter accepterer en ScriptBlock. Variablen $EventData indeholder oplysninger om tabellens tilstand. De kan bruge cmdlets til at behandle dataene ud fra disse oplysninger.

$EventData-struktur

Objektet $EventData indeholder følgende egenskaber.

Egenskabsnavn
Type
Beskrivelse

Filtre

Hashtable[] @{ id = 'fieldName'

value = 'filterValue' }

En liste over filterværdier. Hver hashtable har en egenskab Id og en egenskab Value.

OrderBy

Hashtable @{ field = "fieldName" }

Egenskabsnavn, der skal sorteres efter.

OrderDirection

string

asc eller desc afhængigt af sorteringsrækkefølgen.

Page

int

Den aktuelle side (starter med 0).

PageSize

int

Den valgte sidestørrelse.

Properties

string[]

En matrix af egenskaber, der vises i tabellen.

Søgning

string

En søgestreng, der er angivet af brugeren.

TotalCount

int

Det samlede antal poster før filtrering eller sideinddeling.

Eksempel

Hentning af viste data

De vil måske give brugeren mulighed for at foretage en handling på det aktuelle sæt af viste data. Det gør De ved at bruge Get-UDElement i det inputobjekt, De vil hente dataene fra, og hente tabellen via Id. Når De har elementet, kan De bruge egenskaben Data for elementet til at hente en matrix med de rækker, der vises i øjeblikket.

Sideinddeling

Som standard er sideinddeling deaktiveret, og tabeller vokser ud fra, hvor mange rækker data De angiver. De kan aktivere sideinddeling ved hjælp af cmdletten -ShowPagination (alias -Paging). De kan konfigurere sidestørrelsen ved hjælp af cmdletten -PageSize.

Deaktiver sidestørrelsen All

Som standard giver sidestørrelsesvælgeren en mulighed for at vise alle rækker. Hvis De vil forhindre brugere i at gøre dette, skal De bruge cmdletten -DisablePageSizeAll.

Placering af sideinddeling

De kan ændre placeringen af sideinddelingskontrolelementet ved hjælp af parameteren -PaginationLocation. Den accepterer top, bottom og both.

Placering af sideinddeling

Sidestørrelser

Sidestørrelsen er som standard angivet til 5. Brugere kan justere antallet af rækker pr. side ved hjælp af rullemenuen Rows per page. De kan justere standardsidestørrelsen ved hjælp af parameteren -PageSize. Hvis De vil justere de værdier, der er tilgængelige i rullemenuen Rows per page, kan De bruge en matrix af heltal, der overføres til parameteren -PageSizeOptions.

Sortering

For at aktivere sortering for en tabel, brug parameteren -ShowSort. Når De aktiverer sortering, kan De klikke på tabeloverskrifterne for at sortere tabellen ved at klikke på overskrifterne. Som standard er multisortering aktiveret. For at sortere efter flere kolonner, hold shift nede, og klik på en kolonneoverskrift.

De kan styre, hvilke kolonner der kan sorteres, ved hjælp af New-UDTableColumn og parameteren -ShowSort.

Deaktiver fjernelse af sortering

Som standard har sorteringen af en tabel 3 tilstande. Usorteret, stigende og faldende. Hvis De vil deaktivere den usorterede tilstand, skal De bruge parameteren -DisableSortRemove på New-UDTable.

Valg

Statiske tabeldata

Tabeller understøtter markering af rækker. De kan oprette en hændelseshandler for parameteren OnRowSelection for at modtage meddelelse, når en ny række markeres eller afmarkeres, eller De kan bruge Get-UDElement til at hente det aktuelle sæt af markerede rækker.

Følgende eksempel opretter en tabel med rækkevalg aktiveret. En toast vises, når der klikkes på rækken, eller når der klikkes på knappen GET Rows.

Rækkevalg

Variablen $EventData for hændelsen -OnRowSelection indeholder alle kolonnerne som egenskaber og egenskaben selected, der angiver, om rækken blev valgt eller fravalgt.

Dataene i tjenestetabellen ville f.eks. se sådan ud.

Dynamiske (på serversiden) tabeller

Når De bruger markering og -LoadData, vil hændelsesdataene for -OnRowSelection være id'erne for rækkerne og ikke hele rækkens data. Det angiver stadig, hvor rækken er blevet markeret eller afmarkeret.

Sammenklappelige rækker

De kan medtage yderligere oplysninger i tabellen ved hjælp af parameteren -OnRowExpand på New-UDTable. Den accepterer en ScriptBlock, som De kan bruge til at returnere yderligere komponenter.

Eksport

Tabeller understøtter eksport af dataene i tabellen. De kan eksportere som CSV, XLSX, JSON eller PDF. De kan definere, hvilke kolonner der skal medtages i en eksport, og vælge kun at eksportere den aktuelle side eller alle dataene i tabellen.

Skjulte kolonner

Skjulte kolonner giver Dem mulighed for at medtage data, der ikke vises i tabellen, men som medtages i de eksporterede data.

Følgende skjuler kolonnen StartType for brugeren, men medtager den i eksporten.

Eksport på serversiden

De kan styre eksportfunktionaliteten med en PowerShell-scriptblok. Dette er nyttigt ved eksport fra kilder på serversiden som SQL Server-tabeller.

I dette eksempel har jeg en SQL-tabel, der indeholder podcasts. Ved eksport modtager De oplysninger om tabellens aktuelle tilstand, så De kan tilpasse, hvilke data der eksporteres.

Tilpasning af eksportindstillinger

De kan bestemme, hvilke eksportmuligheder der skal præsenteres for Deres brugere, ved hjælp af cmdletten -ExportOption. Følgende eksempel ville kun vise CSV-eksportmuligheden.

Tilpasning af etiketter

De kan bruge parameteren -TextOption sammen med cmdletten New-UDTableTextOption til at angive tekstfelter i tabellen.

Opdater med en knap

Data-parameter

De kan opdatere en tabel eksternt ved at placere tabellen i en dynamisk region og bruge Sync-UDElement.

Dette eksempel opretter en knap til at opdatere tabellen.

LoadData-parameter

Hvis De bruger parameteren -LoadData, kan De synkronisere tabellen direkte. Dette har den fordel, at tabellens tilstand bevares, f.eks. siden og filtreringen, efter opdateringen.

Vis opdateringsknap

De kan bruge parameteren -ShowRefresh til at angive en opdateringsknap til tabeller på serversiden.

Alternerende rækkefarver

De kan bruge et tema til at oprette en tabel med skiftende rækkefarver.

Brugerdefinerede rækketypografier

Tabel med brugerdefineret rækketypografi

Brug parameteren -OnRowStyle til at formatere rækkerne ud fra rækkeindholdet. Returner en hashtable med CSS-typografier til rækken.

API

Se også

Sidst opdateret

Var dette nyttigt?