Facepile vezérlő (előzetes verzió)

[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]

A képek megjelenítésére és az azokkal való interakciókra használt vezérlő.

Feljegyzés

A teljes dokumentáció és a forráskód a GitHub kódösszetevő-adattárban található.

Fontos

• Ez egy előnézeti funkció.
• Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.

Description

Az arcok halmaza (Facepile) a személyek listáját jeleníti meg. Az egyes körök egy-egy személyt ábrázolnak, és tartalmazzák azok képét vagy kezdőbetűit. Ez a vezérlő általában akkor használatos, amikor megosztja, hogy ki férhet hozzá egy adott nézethez vagy fájlhoz, vagy amikor valakihez feladatot rendel hozzá a munkafolyamaton belül.

Ez a kódösszetevő egy burkolót biztosít a Fluent UI Facepile vezérlő körül, amely egy gombhoz van rendelve a vászonalapú alkalmazásokban és egyéni oldalakon való használatra.

Tulajdonságok

Fő tulajdonságok

Tulajdonság	Description
Items	A renderelendő műveleti elemek. Az első elem a gyökérszintű elem.
PersonaSize	A képernyőn megjelenő általános személy mérete
OverflowButtonType	Kiválasztani, hogy melyik Túlcsordulás gomb jelenjen meg, illetve hogy egyáltalán megjelenjen-e vagy sem
MaxDisplayablePersonas	A Facepile által megjelenített általános személyek maximális száma Az alapértelmezett és ajánlott szám az öt
ImageShouldFadeIn	Azt adja meg, hogy a képnek megjelenéskor legyen-e Áttűnés effektusa
ShowAddButton	Azt adja meg, hogy a Hozzáadás gomb megjelenjen-e a Facepile-összetevőben
OverflowButtonLabel	Akadálymentességi címke a Túlcsordulás gombhoz
AddbuttonAriaLabel	Akadálymentességi címke a Hozzáadás gombhoz

Items Tulajdonságok

Name	Description
ItemPersonaName	Az általános személy megjelenítendő neve
ItemPersonaKey	A kulcs azonosítja az adott elemet A kulcsnak egyedinek kell lennie
ItemPersonaImage	A Dataverse-tábla azon Kép oszlopa, amely az általános személy képét (profilképét) tartalmazza
ItemPersonaImageInfo	Az általános személy képének (profilképének) URL-címe vagy Base64-tartalma
ItemPersonaPresence	Nem kötelező – az általános személy jelenlétének meghatározásához
IsImage	Azt határozza meg, hogy az általános személy képe (ItemPersonaImage) a Dataverse-tábla egyik Kép oszlopa vagy sem. Ez a tulajdonság lehetővé teszi, hogy az összetevő a típus (URL vagy Kép) alapján renderelje a képet. True (igaz) abban az esetben, ha a képet a & false táblából kell hivatkozni, abban az esetben, ha ez egy URL-cím vagy Base64, amelyre az ItemPersonaImageInfo tulajdonságból Dataverse kell hivatkozni
ItemPersonaClickable	Azt adja meg, hogy az általános személyre rá lehet-e kattintani

Példa Power Fx képletre az Items elemhez (az Office 365 Users összekötőt használja)

Hozzon létre Items kollekciót képekkel az Office 365 Users összekötő használatával

A felhasználók listája bármely adatforrásból származhat, de a képet meg kell adni az összetevőnek. Ha a adatforrás nem tartalmaz képeket a felhasználók számára, az AddColumns() Power Fx függvénnyel hozzáadhatja a megfelelő attribútumokat a listához, és lekérheti a felhasználó képét a felhasználói azonosítók vagy egyszerű felhasználónevek listájából, amelyek az Ön aktív felhasználójára vannak leképezve Microsoft Entra.

Hozzon létre egy UserPersonas nevű kollekciót az Office 365 Users összekötő használatával, az alábbi mintakódot alapul véve, majd továbbítsa a kollekciót a vezérlő Items tulajdonságába.

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
    )
);

Feljegyzés

Az IsImage mező értéke hamis, mert az ItemPersonaImageInfo egy kép URL-címéből származik. A Dataverse-képmezők rendereléséhez állítsa az IsImage mező értékét igazra, majd használja az ItemPersonaImage lehetőséget a képérték továbbításához.

Felhasználás

Stílus tulajdonságai

Tulajdonság	Description
Theme	A Fluent UI tématervező (windows.net) segítségével létrehozott JSON-sztringet fogad el. Ha üresen hagyja az adott témát, a Power Apps által alapértelmezett téma jelenik meg. Ha üresen hagyja az adott témát, a Power Apps által alapértelmezett téma jelenik meg. Lásd a téma témakört, ha tudni szeretné, hogyan lehet ezt beállítani.
AccessibilityLabel	Képernyőolvasói területcímke

Esemény tulajdonságai

Tulajdonság	Description
InputEvent	A vezérlőnek küldendő esemény. Például: SetFocus.

Viselkedésmód

Támogatja a SetFocus-t mint InputEvent.

Konfigurálja a Kiválasztáskor viselkedést

A Switch() képlettel az összetevő OnSelect tulajdonságában úgy konfigurálhat egyéni műveleteket az egyes elemekhez, hogy a vezérlő kiválasztott ItemPersonaKey értékére hivatkozik a váltási érték tekintetében.

Példa Power Fx képletre az OnSelect tulajdonságban a Facepile vonatkozásában:

  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");
  )

Korlátozások

Ez a kódösszetevő csak vászonalapú alkalmazásokban és egyéni oldalakon használható.