Udostępnij przez


Kontrolka Siatka usługi Persona (Wersja zapoznawcza)

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

Kontrolka przeznaczona do wyświetlania informacji sformatowanych.

Notatka

Pełna dokumentacja i kod źródłowy znajdują się w repozytorium składników kodu GitHub..

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • 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.

Kontrolka Persona

opis

Persona to wizualna reprezentacja osoby w różnych produktach, zazwyczaj pokazująca obraz przesłany przez daną osobę. Kontrolka może służyć do pokazywania stanu online osoby.

Cała kontrolka zawiera awatar danej osoby (przekazany obraz lub ilustrację inicjałów osoby na kolorze tła), jej imię i nazwisko lub identyfikator oraz status online.

Kontrolka osoby jest używana w kontrolkach PeoplePicker i Facepile.

Ten składnik kodu udostępnia otokę kontrolki Fluent UI Persona, który ma być używana na kanwie i na stronach niestandardowych. Zapoznaj się z dokumentacją składnika, aby poznać najlepsze praktyki.

Właściwości klucza

Właściwości opis
ImageUrl Adres URL obrazu, który ma zostać użyty. Użyj obrazu o kwadratowych proporcjach, który jest wystarczająco duży, aby zmieścił się w obszarze obrazu.
ImageInitials Inicjały użytkownika do wyświetlenia w obszarze obrazu w przypadku, gdy nie ma obrazu.
Text Tekst podstawowy do wyświetlenia, zwykle imię i nazwisko osoby.
SecondaryText Tekst pomocniczy do wyświetlenia, zwykle rola użytkownika.
TertiaryText Kolejny tekst pomocniczy do wyświetlenia, zwykle stan użytkownika. Tekst trzeciorzędny jest wyświetlany tylko w przypadku użycia size72 lub size100.
OptionalText Opcjonalny tekst do wyświetlenia, zazwyczaj niestandardowy zestaw wiadomości. Opcjonalny tekst jest wyświetlany tylko w przypadku korzystania z size100.
ImageAlt Alternatywny tekst dla obrazu.
HidePersonaDetails Określa, czy nie mają być renderowane szczegóły persony, a tylko renderowany obraz/inicjały persony.
PersonaSize Rozmiar osoby wyświetlanej na ekranie.
Presence Obecność osoby do wyświetlenia. Obecność nie jest wyświetlana, jeśli nie jest zdefiniowana. Można wybrać tylko jedną wartość: away, blocked, busy, dnd, none, offline lub online.

Właściwości stylu

Właściwości opis
Theme Akceptuje ciąg JSON generowany przy użyciu Projektanta motywów interfejsu użytkownika (windows.net). Jeśli to pole pozostanie puste, zostanie użyty motyw domyślny zdefiniowany przez Power Apps. Dowiedz się więcej o motywach.
AccessibilityLabel Czytnik ekranu aria-label.

Przykład

Oto kilka przykładowych wartości dla składnika Persona:

Właściwości Wartość
Text „Megan Brown”
SecondaryText „Inżynier oprogramowania”
TertiaryText „Na spotkaniu”
OptionalText „Dostępna o 16:00”
HidePersonaDetails fałsz
ImageUrl User().Image
PersonaSize PowerCAT.Persona.PersonaSize.Size100
Presence PowerCAT.Persona.Presence.Online

Ograniczenia

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