Facepile Kontroll (förhandsversion)

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

En kontroll som används för att visa och interagera med bilder.

Anmärkning

Fullständig dokumentation och källkod finns i lagringsplatsen för GitHub-kodkomponenter.

Facepile-kontroll.

Important

  • Det här är en förhandsgranskningsfunktion.
  • 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

Facepile (Facepile) visas en lista med personer. Varje cirkel representerar en person och innehåller deras bild eller initialer. Ofta används den här kontrollen när du delar vem som har åtkomst till en viss vy eller fil, eller när du tilldelar någon en uppgift i ett arbetsflöde.

Den här kodkomponenten fungerar som reglage runt Fluent UI Facepile kontroll bunden till en knapp för användning i canvas-program och anpassade sidor.

Egenskaper

Nyckelegenskaper

Fastighet Beskrivning
Items Åtgärdspunkterna som ska återges. Det första objektet betraktas som rotobjektet.
PersonaSize Storleken på den persona som ska visas på skärmen
OverflowButtonType Välj vilken typ av överflödesknapp som ska visas och om den ska synas
MaxDisplayablePersonas Maximalt antal Persona som ska visas i Facepile
Fem är standardnumret och rekommenderade nummer
ImageShouldFadeIn Om bilden ska ha en fade in-effekt medan den visas
ShowAddButton Om Lägg till knapp ska visas i Facepile-komponent
OverflowButtonLabel Aria-etikett för överflödesknapp
AddbuttonAriaLabel Aria-etikett för knappen lägg till

Items Egenskaper

Namn Beskrivning
ItemPersonaName Visningsnamn för personen
ItemPersonaKey Nyckeln identifierar det specifika objektet
Nycklarna måste vara unika
ItemPersonaImage Bildkolumnen i Dataverse tabellen som innehåller Personabild (profilbild)
ItemPersonaImageInfo URL- eller Base64-innehåll i Personabild (profilbild)
ItemPersonaPresence Valfritt – Så här definierar du personnärvaro
IsImage Om personabilden(ItemPersonaIndage) är en bildkolumn i Dataverse-tabellen.
Med den här egenskapen kan komponenten rendera bilden baserat på typen (Url eller Bild). Sant om bildreferensen behövs från en Dataverse-tabell, och falskt om det är en URL eller Base64 som ska hämtas från egenskapen ItemPersonaImageInfo.
ItemPersonaClickable Om persona ska vara klickbar eller inte

Exempelformel Power Fx för Items (använder Office 365 användare anslutningsprogram)

Skapa Items samling med bilder med hjälp av Office 365 Users-kopplingen

En lista över användare kan komma från alla datakälla, men bilden måste tillhandahållas till komponenten. Om din datakälla inte har bilder för användarna kan du använda AddColumns() Power Fx funktion för att lägga till rätt attribut till listan och hämta användarens bild, från en lista med användar-ID eller användarnamn som mappas till en aktiv användare i din Microsoft Entra.

Skapa en samling kallad UserPersonas med hjälp av Office 365 Users-kopplare, genom att hänvisa till nedanstående exempelkod, och skicka sedan in samlingen i Items-egenskapen för kontrollen.

ClearCollect(
    UserPersonas,
    AddColumns(
       // Get first 10 users who have email ID - optional
        Filter(
            Office365Users.SearchUser({top: 10}),
            Mail <> Blank()
        ),
        "ItemPersonaKey",
        Mail,
        "ItemPersonaName",
        DisplayName,
        "IsImage",
        false,
        "ItemPersonaImageInfo",
        //Get base64 image data
        Substitute(
            JSON(
                Office365Users.UserPhotoV2(Id),
                JSONFormat.IncludeBinaryData
            ),
            """",
            ""
        ),
        "ItemPersonaPresence",
        "Away",
        "ItemPersonaClickable",
        true
    )
);

Anmärkning

Fältet IsImage anges som falskt eftersom ItemPersonaImageInfo kommer från en bild-URL. Om du vill återge Dataverse bildfälten, ställ in fältet IsImage till sant och använd ItemPersonaImage för att skicka bildvärdet istället.

Usage

Stilegenskaper

Fastighet Beskrivning
Theme Godkänner en JSON-sträng som genereras med Fluent UI temadesigner (windows.net). Om du lämnar detta tomt kommer standardtemat som definieras av Power Apps att användas. Om du lämnar detta tomt kommer standardtemat som definieras av Power Apps att användas. Se tema för vägledning om hur du konfigurerar.
AccessibilityLabel Aria-etikett för skärmläsare

Händelseegenskaper

Fastighet Beskrivning
InputEvent En händelse att skicka till styrningen. Till exempel SetFocus.

Behavior

Stödjer SetFocus som en InputEvent.

Konfigurera beteendet vid val

Använd formeln Switch() i komponentens OnSelect egenskap om du vill konfigurera specifika åtgärder för respektive objekt genom att hänvisa till kontrollens markerade ItemPersonaKey som växelvärde.

Exempelformel Power Fx i OnSelect-egenskapen för Facepile:

  Switch( Self.EventName,
    /* Define action when persona clicked */
    "PersonaEvent", 
    Notify("Persona clicked: " & Self.Selected.ItemPersonaKey);
    ,
    
    /* Define logic when the add button clicked */
    "AddButtonEvent", 
    Notify("Add button was clicked");
    ,
  
    /* Define logic when overflow button clicked*/
    "OverFlowButtonEvent",
    Notify("Overflow button clicked");
  )

Limitations

Den här kodkomponenten kan endast användas i arbetsyteappar och anpassade sidor.

  • Last updated on