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

Stepper

Steppere formidler fremdrift gennem nummererede trin. Den giver et arbejdsflow i stil med en guide.

Steppere viser fremdrift gennem en sekvens af logiske og nummererede trin. Steppere kan også bruges til navigation. Steppere kan vise en kortvarig feedbackmeddelelse, efter at et trin er gemt. Stepperen understøtter lagring af inputdata i stepperkonteksten. Den understøtter følgende kontrolelementer.

Stepper

New-UDStepper -Steps {
    New-UDStep -OnLoad {
        New-UDElement -tag 'div' -Content { "Step 1" }
        New-UDTextbox -Id 'txtStep1' -Value $EventData.Context.txtStep1
    } -Label "Step 1"
    New-UDStep -OnLoad {
        New-UDElement -tag 'div' -Content { "Step 2" }
        New-UDElement -tag 'div' -Content { "Previous data: $Body" }
        New-UDTextbox -Id 'txtStep2' -Value $EventData.Context.txtStep2
    } -Label "Step 2"
    New-UDStep -OnLoad {
        New-UDElement -tag 'div' -Content { "Step 3" }
        New-UDElement -tag 'div' -Content { "Previous data: $Body" }
        New-UDTextbox -Id 'txtStep3' -Value $EventData.Context.txtStep3
    } -Label "Step 3"
} -OnFinish {
    New-UDTypography -Text 'Nice! You did it!' -Variant h3
    New-UDElement -Tag 'div' -Id 'result' -Content {$Body}
}

Variablen $Body vil indeholde en JSON-streng, der indeholder stepperens aktuelle tilstand. De vil modtage oplysninger om de felter, der er defineret i stepperen, og oplysninger om det aktuelle trin, der er fuldført. JSON-strengen $Body vil have følgende format.

Validering af et trin

De kan validere et trin i en stepper ved at angive parameteren OnValidateStep. Scriptblokken modtager en $Body-variabel med JSON, der giver oplysninger om stepperens aktuelle tilstand. De skal returnere et valideringsresultat ved hjælp af New-UDValidationResult for at angive, om det aktuelle trins tilstand er gyldig.

JSON-payloaden vil have følgende format. Bemærk, at trin er 0-indekserede. Hvis De vil validere det første trin, skal De kontrollere, at trinnet er 0.

De er nødt til at konvertere JSON-strengen til et objekt, der kan arbejdes med i PowerShell, og derefter returnere valideringsresultatet.

Overspringning af trin

De kan sende brugeren til et bestemt trin i hændelseshandleren OnValidateStep. Brug New-UDValidationResult -ActiveStep-parameteren til at flytte brugeren til et hvilket som helst trin, efter der er klikket på næste. Trinindekser er 0-baserede.

Dette eksempel flytter brugeren til det sidste trin, efter at det første trin er fuldført.

Deaktiver forrige knap

De kan deaktivere den forrige knap ved hjælp af parameteren -DisablePrevious for New-UDValidationResult .

Dette eksempel deaktiverer det forrige trin, når brugeren går fremad i stepperen.

Lodrette steppers

De kan oprette en lodret stepper ved at angive parameteren -Orientation til vertical.

API

Sidst opdateret

Var dette nyttigt?