For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Spring til indhold

Sider

En app kan bestå af en eller flere sider. En side kan have et bestemt navn og en URL. De kan definere en URL, der accepterer en eller flere variabler i URL'en, for at definere en dynamisk side.

Oprettelse af en ny side

Klik på knappen Create App Page i app-editoren.

Når siden er blevet oprettet, vises den på fanen med sider.

For at opdatere indholdet af en side skal De klikke på knappen Edit Code.

Som et eksempel kunne De tilføje en knap til Deres side.

New-UDPage -Name 'Users' -Url '/users' -Content {
    New-UDButton -Text 'What page is this?' -OnClick {
        Show-UDToast $UDPage
    }
} -AutoInclude

Sider føjes automatisk til apps med parameteren -AutoInclude. Kald blot New-UDApp i roden af Deres apps PS1-fil.

New-UDApp 

Grundlæggende side

En grundlæggende side kan defineres med cmdletten New-UDPage. De kan navigere til denne side ved at besøge /appURL'en for Deres dashboard.

$Pages = @()
$Pages += New-UDPage -Name 'App' -Content {
    New-UDTypography -Text 'App'
}

New-UDApp -Title 'Pages' -Pages $Pages

App med flere sider

Apps kan have flere sider, og disse sider kan defineres ved at sende en matrix af UDPages til New-UDApp

De ønsker måske at organisere Deres app i flere PS1-filer. De kan gøre dette ved hjælp af sider.

Side med en brugerdefineret URL

En side kan have en brugerdefineret URL ved hjælp af parameteren -Url. De kan gå til denne side ved at besøge URL'en /db for Deres app.

Side med variabler i URL

De kan definere en side med variabler i URL'en for at oprette sider, der tilpasser sig ud fra den URL.

Forespørgselsstrengparametre

Forespørgselsstrengparametre overføres til sider og andre slutpunkter som en hashtable-variabel kaldet $Query.

Hvis De f.eks. besøgte en side med følgende parameter for forespørgselsstrengen: http://localhost:5000/dashboard/Page1?test=123

De har adgang til denne værdi ved hjælp af følgende syntaks:

Rollebaseret adgang

Denne funktion kræver en licens.

De kan forhindre brugere i at få adgang til sider ud fra deres rolle ved hjælp af parameteren -Role for sider. De kan konfigurere roller og rollepolitikker på Sikkerhedssiden.

Sidehoved

Følgende indstillinger er tilgængelige til tilpasning af headeren.

Placering

Brug parameteren -HeaderPosition til at justere headerens funktionsmåde.

  • absolute\fixed - Forbliver øverst på siden, selv når der rulles

  • relative - Forbliver øverst på siden. Ikke synlig ved rulning.

Farver

De kan justere headerens farver ved at angive parametrene -HeaderColor og -HeaderBackgroundColor. Disse farver tilsidesætter temafarverne.

De kan tilpasse navigationen på en side ved hjælp af parametrene -Navigation og -NavigationLayout. Navigation defineres ved hjælp af komponenten List. Navigationslayouts er enten permanente eller midlertidige.

Brugerdefineret navigation

Brugerdefineret navigation kan defineres med en liste. Listeelementer kan indeholde underpunkter for at oprette rullemenuer i navigationen.

Dynamisk navigation

Dynamisk navigation kan bruges til at køre scripts under indlæsning af siden for at afgøre, hvilke navigationskomponenter der skal vises, ud fra variabler som brugeren, IP-adressen eller roller.

De kan generere dynamisk navigation ved hjælp af parameteren -LoadNavigation. Værdien af parameteren skal være en scriptblok, der udføres, når navigationen indlæses.

Rollebaseret adgang

De kan bruge dynamisk navigation til at oprette en navigationsmenu, der udnytter roller. Brug Protect-UDSection til at begrænse, hvem der har adgang til bestemte menupunkter. Sørg for, at De også medtager den samme rolle på siden.

Hvis De vil kontrollere roller i sider, kan De også bruge operatoren -In og variablen $Roles.

Layouts

Det permanente layout opretter en statisk navigationsskuffe i venstre side af siden. Den kan ikke skjules af brugeren.

Det midlertidige layout opretter en navigationsskuffe, der kan åbnes ved hjælp af en hamburgermenu i øverste venstre hjørne. Dette er standardindstillingen.

Vandret navigation

De kan bruge New-UDAppBar med en tom side til at oprette vandret navigation.

De kan vise et logo i navigationslinjen ved hjælp af parameteren -Logo.

Opsæt først en publiceret mappe for at hoste Deres logo.

Nu, når De opretter Deres side, kan De angive stien til logoet.

Logoet vises i øverste venstre hjørne.

For at tilpasse typografien for Deres logo kan De bruge et kaskadetypografiark og målrette element-id'et ud-logo.

Overskriftsindhold

De kan definere brugerdefineret indhold, der skal medtages i headeren, ved hjælp af parameteren -HeaderContent.

Dynamisk sidetitel

Sidetitler er statiske som standard, men De kan tilsidesætte denne funktionsmåde ved hjælp af -LoadTitle. Den kaldes, når siden indlæses. Det er nyttigt, når De definerer sider i flersprogede dashboards.

Statiske sider

Statiske sider giver bedre ydeevne ved ikke at udføre PowerShell for at indlæse sidens indhold. Dette kan være nyttigt, når der vises data, der ikke kræver dynamisk PowerShell-udførelse. Sideindholdet opbygges, når dashboardet startes.

Statiske sider har ikke adgang til brugerspecifikke data. Dette omfatter variabler som:

  • $Headers

  • $User

  • $Roles

De kan stadig medtage dynamiske områder på sider. Disse dynamiske områder har adgang til brugerdata. Genindlæsning af eksemplet nedenfor opdaterer den dato og det klokkeslæt, der er angivet på siden.

API

Se også

Sidst opdateret

Var dette nyttigt?