Moderner Schieberegler in Canvas-Apps

Ermöglichen Sie Benutzern, einen numerischen Wert auszuwählen, indem Sie einen Ziehpunkt entlang eines Titels ziehen.

Beschreibung

Mit dem modernen Schieberegler-Steuerelement können Benutzer einen Wert zwischen mindestens und maximal festlegen, indem sie einen Ziehpunkt entlang eines Titels ziehen. Das Steuerelement unterstützt horizontale und vertikale Ausrichtung.

Verwenden Sie dieses Steuerelement, wenn Benutzer einen Wert aus einem fortlaufenden Bereich auswählen möchten, z. B.:

• Lautstärke- oder Helligkeitssteuerelemente
• Budget- oder Preisbereichsauswahl
• Mengenauswahl
• Bewertungs- oder Zufriedenheitsskalen

Die wichtigsten Eigenschaften für dieses Steuerelement sind "Default", "Min", "Max", "Value" (Ausgabe) und "OnChange".

Allgemeines

Default – Der Anfangswert des Schiebereglers, bevor der Benutzer eine Änderung vorgibt. Setzt diesen Wert zurück, wenn Reset er ausgelöst wird. Der Standardwert ist 50.

Min – Der Mindestwert, den der Benutzer festlegen kann. Der Standardwert ist 0.

Max – Der Maximalwert, den der Benutzer festlegen kann. Der Standardwert ist 100.

Sichtbar – Gibt an, ob das Steuerelement angezeigt oder ausgeblendet ist.

Verhalten

OnChange – Aktionen, die ausgeführt werden sollen, wenn der Benutzer den Schiebereglerwert ändert. Dient Self.Value zum Lesen des aktuellen Werts.

DisplayMode – Ob das Steuerelement Benutzereingaben (Bearbeiten) zulässt, zeigt nur Daten (Ansicht) an oder ist deaktiviert (deaktiviert).

LayoutDirection – Die Ausrichtung des Schiebereglertitels. Akzeptiert LayoutDirection Enumerationswerte:

Größe und Position

X – Abstand zwischen dem linken Rand des Steuerelements und dem linken Rand des übergeordneten Containers (Bildschirm, wenn kein übergeordneter Container).

Y – Abstand zwischen dem oberen Rand des Steuerelements und dem oberen Rand des übergeordneten Containers (Bildschirm, wenn kein übergeordneter Container).

Breite – Abstand zwischen den linken und rechten Rändern des Steuerelements. Der Standardwert ist 200.

Höhe – Abstand zwischen den oberen und unteren Rändern des Steuerelements. Der Standardwert ist 35.

Stil und Design

BasePaletteColor – Die Basisfarbe, die das Design verwendet, um die Farbpalette des Steuerelements zu generieren. Ändern Sie diesen Wert, um eine andere Designfarbe auf die Schiebereglerspur und den Ziehpunkt anzuwenden.

Größe – Die visuelle Größe des Schiebereglerziehpunkts und der Spur. Akzeptiert SliderSize Enumerationswerte:

Accessibility

AccessibleLabel – Bezeichnung, die Sprachausgaben lesen. Beschreiben Sie den Zweck des Schiebereglers (z. B "Volume". ). Legen Sie diese Eigenschaft immer fest, damit Hilfstechnologien das Steuerelement identifizieren können.

ContentLanguage – Die Anzeigesprache für den Steuerelementinhalt, falls anders als die App-Sprache.

QuickInfo – Erläuternder Text, der angezeigt wird, wenn der Benutzer auf das Steuerelement zeigt. Hilfreich für sehberechtigte Benutzer, die zusätzlichen Kontext zu dem Zweck des Schiebereglers benötigen.

Ausgabeeigenschaften

Wert – Der aktuelle Wert des Schiebereglers, der aktualisiert wird, wenn der Benutzer den Ziehpunkt zieht. Verwenden Sie diesen Wert in Formeln, um die aktuelle Position des Schiebereglers zu lesen (z. B Slider1.Value. ).

Beispiele

Budgetauswahl mit einer Bezeichnung

Dieses Beispiel zeigt einen horizontalen Schieberegler, mit dem Benutzer ein monatliches Budget festlegen können. Eine Bezeichnung wird in Echtzeit aktualisiert, während der Benutzer den Ziehpunkt zieht.

- BudgetSlider:
    Control: ModernSlider@1.0.0
    Properties:
      Default: =500
      Min: =0
      Max: =10000
      LayoutDirection: =LayoutDirection.Horizontal
      Size: =SliderSize.Medium
      AccessibleLabel: ="Monthly budget"
      Tooltip: ="Drag to set your monthly budget"
      Width: =300
      Height: =35

- BudgetLabel:
    Control: ModernText@1.0.0
    Properties:
      Size: =14
      Text: |-
        ="Budget: $" & BudgetSlider.Value

Schieberegler für vertikale Lautstärke

In diesem Beispiel wird ein vertikaler Schieberegler für ein Lautstärkesteuerelement verwendet und der ausgewählte Wert in eine Variable geschrieben.

- VolumeSlider:
    Control: ModernSlider@1.0.0
    Properties:
      Default: =30
      Min: =0
      Max: =100
      LayoutDirection: =LayoutDirection.Vertical
      Size: =SliderSize.Small
      AccessibleLabel: ="Volume"
      Width: =35
      Height: =200

Neueste Updates

Die aktualisierte Version des modernen Schieberegler-Steuerelements umfasst die folgenden Verbesserungen und Verhaltensänderungen.

Eigenschaftsumbenennungen

Aufzählungsformatänderungen

Fehlerbehebungen und Verbesserungen

• Separater Standardwert und Wert: Default Legt den Anfangswert fest; Value ist jetzt eine dedizierte schreibgeschützte Ausgabeeigenschaft. Diese Änderung entspricht dem Muster, das von Zahleneingaben und anderen modernen Steuerelementen verwendet wird, wodurch Formeln vorhersehbarer werden.
• QuickInfo-Unterstützung: Neue Tooltip Eigenschaft zeigt erläuternden Text beim Daraufzeigen an.
• Aktualisierte Enumerationen: LayoutDirection und Size verwenden jetzt eingegebene Power Fx-Enumerationen, verbessern IntelliSense und reduzieren Formelfehler.

Optimale Verfahren

• Legen Sie aussagekräftige Min- und Max-Werte fest. Ein Schieberegler von 0 bis 100 eignet sich gut für Prozentsätze, aber für Dollarbeträge oder Mengen verwenden Sie einen Bereich, der der erwarteten Eingabe entspricht, damit jede Ziehbewegung reaktionsfähig ist.
• Stellen Sie immer ein AccessibleLabel bereit. Bildschirmsprachausgaben verwenden diese Eigenschaft, um den Zweck des Schiebereglers für Benutzer mit Sehbehinderungen zu beschreiben.
• Koppeln Sie den Schieberegler mit einer Beschriftung , die den aktuellen Wert anzeigt (z. B "Budget: $" & Slider1.Value. ). Benutzer können die genaue Zahl sehen, ohne von der Griffposition zu erraten.
• Verwenden Sie die vertikale Ausrichtung sparsam. Horizontale Schieberegler sind den meisten Benutzern vertraut. Reservieren Sie vertikale Schieberegler für Fälle, in denen die Metapher übereinstimmt, z. B. Volume-Fader.

Siehe auch

• Übersicht über moderne Steuerelemente
• Größen- und Standorteigenschaften