Udostępnij przez

Kontrolka Dialog (eksperymentalna)

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Formant używany do grupowania zawartości.

Kontolka Dialog.

Ważne

  • To jest funkcja objęta programem eksperymentalnym.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

opis

Okno dialogowe (Dialog) to tymczasowe wyskakujące okienko, na stronie lub w aplikacji, na których użytkownicy mają się skoncentrować. Jest głównie używany do potwierdzenia działań, takich jak usuwanie pliku, lub do prośby o możliwość wyboru.

Ten składnik kanwy imituje styl i zachowanie formantu Wyszukiwanie przy interfejsie użytkownika Dialog Fluent UI. Zapoznaj się z dokumentacją, aby poznać najlepsze praktyki.

Wyświetl składnik w repozytorium GitHub zestawu Kreatora

Właściwości

Właściwości klucza

Właściwości opis
Buttons Zestaw danych definiujący przyciski (więcej informacji znajdziesz w temacie Właściwości przycisku).
Title Tekst wyświetlany w sekcji tytułu.
OverlayColor Kolor wyświetlany w obszarze pochyłym.
DialogWidth Szerokość Dialog (nie należy mylić z szerokością kontrolki, która powinna obejmować szerokość aplikacji).
DialogHeight Wysokość Dialog (nie mylić z wysokością kontrolki, która powinna obejmować wysokość aplikacji).
SubTitle Tekst wyświetlany pod tytułem.

Właściwości przycisków

Właściwości opis
Label Etykieta wyświetlana na przycisku.
ButtonType Wyliczenie, które określa wygląd przycisku. Wybierz spośród Standard i Primary. 
Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Właściwości stylu

Właściwości opis
Theme Obiekt motywu. Dowiedz się więcej o motywach.

Więcej informacji na temat formatowania można znaleźć w sekcji Treść panelu Format wPanelu.

Właściwości zdarzenia

Właściwości opis
OnCloseSelect Wyrażenie akcji wykonywane po wybraniu przycisku zamknięcia.
OnButtonSelect Wyrażenie akcji, które jest wykonywane po wybraniu jednego z przycisków akcji.

Zachowanie

Konfigurowanie widoczności Dialog

Spraw, aby kontrolka Dialog (lub powierzchnia, na której się znajduje) stała się widoczna, gdy zmienna logiczna (true/false) przyjmie wartość true. Przypisz tę zmienną do właściwości widoczności okna dialogowego. Aby ukryć okno dialogowe po jego wyświetleniu, zaktualizuj zmienną we właściwości reset, uruchamianą po wybraniu ikony zamykania.

Następująca Formuła Power Fx do otwierania okna dialogowego w formule akcji na innym komponencie gdzieś w aplikacji (na przykład właściwość OnSelect przycisku):

UpdateContext({ showHideDialog: true })

Następującą formułę Power Fx do zamknięcia dialogu, we właściwości OnCloseSelect okienka dialogowego:

UpdateContext({ showHideDialog: false })

Przypisz zmienną do Visible właściwości sesji dialogowej:

showHideDialog

Skonfiguruj akcje przycisków

We właściwości OnButtonSelect okna dialogowego podaj akcje w warunku If() lub Switch() na podstawie wartości tekstowej Self.SelectedButton.Label, aby zdefiniować akcję. W zależności od akcji warto także zamknąć dialog po zakończeniu akcji.

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

Ograniczenia

Tego składnika kanwy można używać tylko w aplikacjach kanwy i na stronach niestandardowych.

  • Last updated on