Stepper

Stepper stellen den Fortschritt durch numerierte Schritte dar. Sie bieten einen assistentenähnlichen Workflow.

Stepper stellen den Fortschritt durch eine Folge logischer und numerierter Schritte dar. Sie können auch zur Navigation verwendet werden. Stepper können nach dem Speichern eines Schritts eine kurzzeitige Rückmeldung anzeigen. Der Stepper unterstützt das Speichern von Eingabedaten im Stepper-Kontext. Er unterstützt die folgenden Steuerelemente.

• Autocomplete
• Checkbox
• Date Picker
• Radio
• Select
• Slider
• Switch
• Textbox
• Time Picker
• Upload

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}
}

Die Variable $Body enthält eine JSON-Zeichenfolge mit dem aktuellen Zustand des Steppers. Sie erhalten Informationen über die im Stepper definierten Felder sowie Informationen über den aktuellen abgeschlossenen Schritt. Die JSON-Zeichenfolge $Body hat das folgende Format.

{
    context: {
        txtStep1: "value1",
        txtStep2: "value2",
        txtStep3: "value3"
    },
    currentStep: 0
}

Validieren eines Schritts

Sie können einen Schritt in einem Stepper validieren, indem Sie den Parameter OnValidateStep angeben. Der Skriptblock erhält eine Variable $Body mit JSON, das Informationen über den aktuellen Zustand des Steppers bereitstellt. Sie müssen mit New-UDValidationResult ein Validierungsergebnis zurückgeben, um anzugeben, ob der aktuelle Schrittzustand gültig ist.

Die JSON-Nutzlast hat das folgende Format. Beachten Sie, dass Schritte bei 0 beginnen. Wenn Sie den ersten Schritt validieren möchten, prüfen Sie, ob der Schritt 0 ist.

{
    context: {
        field1: "value1" 
    },
    currentStep: 0
}

Sie müssen die JSON-Zeichenfolge in ein Objekt konvertieren, um in PowerShell damit zu arbeiten, und anschließend das Validierungsergebnis zurückgeben.

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}
} -OnValidateStep {
    $Context = $EventData
    if ($Context.CurrentStep -eq 0 -and $Context.Context.txtStep1 -eq 'bad')
    {
        New-UDValidationResult 
    }
    else
    {
        New-UDValidationResult -Valid 
    }
}

Schritte überspringen

Sie können den Benutzer im Ereignishandler OnValidateStep zu einem bestimmten Schritt leiten. Verwenden Sie den Parameter -ActiveStep von New-UDValidationResult, um den Benutzer nach dem Klick auf Weiter zu einem beliebigen Schritt zu bewegen. Schrittindizes beginnen bei 0.

Dieses Beispiel bewegt den Benutzer nach Abschluss des ersten Schritts zum letzten Schritt.

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}
} -OnValidateStep {
    $Context = $EventData
    if ($Context.CurrentStep -eq 0 -and $Context.Context.txtStep1 -eq 'bad')
    {
        New-UDValidationResult 
    }
    else
    {
        New-UDValidationResult -Valid -ActiveStep 2
    }
}

Zurück-Schaltfläche deaktivieren

Sie können die Zurück-Schaltfläche mit dem Parameter -DisablePrevious von New-UDValidationResult deaktivieren.

Dieses Beispiel deaktiviert den vorherigen Schritt, wann immer sich der Benutzer im Stepper vorwärts bewegt.

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}
} -OnValidateStep {
    New-UDValidationResult -Valid -DisablePrevious
}

Vertikale Stepper

Sie können einen vertikalen Stepper erstellen, indem Sie den Parameter -Orientation auf vertical setzen.

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}
} -Orientation 'vertical'

API

• New-UDStepper
• New-UDStep
• New-UDValidationResult