Dynamische Bereiche

Mit New-UDDynamic können Sie einen dynamischen Bereich definieren. Seiten selbst sind von Natur aus dynamisch. Das bedeutet, dass bei jedem Laden einer Seite das PowerShell-Skript für diese Seite ausgeführt wird. Manchmal möchten Sie vielleicht einen Abschnitt einer Seite neu laden statt die ganze Seite. In diesem Fall sollten Sie dynamische Bereiche verwenden.

Einfacher dynamischer Bereich

Dieser dynamische Bereich wird neu geladen, wenn auf die Schaltfläche geklickt wird.

New-UDApp -Title "Hello, World!" -Content {
    New-UDDynamic -Id 'date' -Content {
        New-UDTypography -Text "$(Get-Date)"
    }

    New-UDButton -Text 'Reload Date' -OnClick { Sync-UDElement -Id 'date' }
}

Reload on button click

Argumentliste

An den dynamischen Bereich kann ein Array von Argumenten übergeben werden.

New-UDDynamic -Id 'dynamic_01' -Content {
    New-UDTypography -Text "This is an $($ArgumentList[0]) an $($ArgumentList[1]) in a UDDynamic"
} -ArgumentList @('example of', 'arguments list') 

Verwendung der Argumentliste

Sie können Sync-UDElement verwenden, um die Argumentwerte zu ändern.

 New-UDDynamic -id DynamicRegion -ArgumentList 5,'hello' -content {
  foreach($item in $argumentList){
      New-UDTypography -Variant h3 -Text "Item: $item"
  }
 }

 New-UDButton -Text "Sync Dynamic" -onclick {
  Sync-UDElement -id DynamicRegion -ArgumentList 10,'World'
 }

Automatische Aktualisierung

Dynamische Bereiche ermöglichen die automatische Aktualisierung von Komponenten nach einer bestimmten Zeitspanne. Bei der automatischen Aktualisierung wird der gesamte Skriptblock des Bereichs ausgeführt.

Wenn Sie mehrere zusammengehörige Komponenten haben, die dieselben Daten verwenden, sollten Sie diese in denselben dynamischen Bereich einfügen, um die Leistung zu verbessern.

    New-UDDynamic -Id 'date' -Content {
        New-UDTypography -Text "$(Get-Date)" -Variant h3
        New-UDTypography -Text "$(Get-Random)" -Variant h3
    } -AutoRefresh -AutoRefreshInterval 1

Auto refresh dynamic region

Ladekomponente

Manchmal kann das Aktualisieren einer dynamischen Komponente einige Zeit in Anspruch nehmen. Zum Beispiel, wenn Sie die REST-API eines anderen Dienstes oder Daten abfragen. Dynamische Bereiche unterstützen die Konfiguration der Komponente, die angezeigt wird, während der Bereich neu geladen wird. Standardmäßig wird nichts angezeigt. Dies kann jede beliebige App-Komponente sein.

    New-UDDynamic -Content {
        Start-Sleep -Seconds 3
        New-UDTypography -Text "Done!"
    } -LoadingComponent {
        New-UDProgress -Circular
    }

Loading component for dynamic region

API

New-UDDynamic

Siehe auch

• Devolutions Academy – User status/refresh user details