Dialog kontroll (experimentell)

[Den här artikeln är en förhandsversion av dokumentationen och kan komma att ändras.]

En kontroll som används för att gruppera innehåll.

Dialog-kontroll.

Important

  • Det här är en experimentell funktion.
  • Förhandsgranskningsfunktioner ska inte användas i produktion, och funktionerna kan vara begränsade. Dessa funktioner är tillgängliga före en officiell release så att kunderna kan få tidig tillgång och ge feedback.

Beskrivning

En dialogruta (dialog) är ett tillfälligt popup-fönster som fokuserar på sidan eller programmet och kräver att personer interagerar med den. Den används främst för att bekräfta åtgärder, till exempel för ta bort en fil eller be folk göra ett val.

Den här komponenten imiterar stilen och funktionssättet i Fluent UI Dialog-kontrollen. Bästa praxis finns i dokumentationen.

Visa komponenten på GitHub-lagringsplatsen för skaparpaketet.

Egenskaper

Nyckelegenskaper

Fastighet Beskrivning
Buttons En datauppsättning som definierar knapparna (läs mer i Knappegenskaper).
Title Text som visas i rubrikavsnittet.
OverlayColor Färgen som visas i det överlappande området.
DialogWidth Dialogens bredd (inte att förväxlas med kontrollbredden, som ska sträcka sig över programbredden).
DialogHeight Dialogens höjd (inte att förväxlas med kontrollhöjden, som ska sträcka sig över programhöjden).
SubTitle Text som visas under rubriken.

Egenskaper för knapp

Fastighet Beskrivning
Label Etiketten som visas på knappen.
ButtonType Enumeration som bestämmer knappens stil. Välj mellan Standard och Primary. 
Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Stilegenskaper

Fastighet Beskrivning
Theme Temaobjekt. Läs mer om tema.

Lär dig mer om formatering i avsnittet Formatera panelinnehåll i Panel.

Händelseegenskaper

Fastighet Beskrivning
OnCloseSelect Åtgärdsuttryck som körs när stängningsknappen är markerad.
OnButtonSelect Åtgärdsuttrycket körs när en av åtgärdsknapparna väljs.

Behavior

Konfigurera dialogsynlighet

Gör själva Dialog kontrollen (eller den yta den finns i) synlig när en variabel av boolesk typ (sant/falskt) ändras till sant. Tilldela den variabeln till dialogrutans visibility-egenskap. För att dölja dialogrutan efter att den har visats, uppdatera variabeln på reset-egenskapen som utlöses när stängningsikonen väljs.

Följande visar Power Fx-formeln för att öppna dialogrutan i en åtgärdsformel på en annan komponent någonstans i programmet (till exempel OnSelect-egenskapen för en knapp):

UpdateContext({ showHideDialog: true })

Följande är Power Fx-formeln för att stänga dialogen i OnCloseSelect-egenskapen i dialogen:

UpdateContext({ showHideDialog: false })

Tilldela variabeln till Visible-egenskapen för dialogen:

showHideDialog

Konfigurera knappåtgärder

I egenskapen OnButtonSelect i dialogen, tillhandahåll åtgärder i en If() eller Switch() villkor baserat på Self.SelectedButton.Label textvärde för att specificera åtgärden. Beroende på åtgärden kan det vara meningsfullt att även stänga dialogen när åtgärden har slutförts.

    If( Self.SelectedButton.Label = "Send", 
        Notify("Email Sent")
    );
    UpdateContext({ showHideDialog: false })

Limitations

Den här arbetsytekomponenten kan endast användas i arbetsyteappar och på anpassade sidor.

  • Last updated on