Facepile valdiklis (peržiūra)

[Šis straipsnis yra negalutinio leidimo dokumentacija ir gali keistis.]

Valdiklis, naudojamas vaizdams rodyti ir atlikti su jais veiksmus.

Pastaba.

Visą instrukciją ir šaltinio kodą galima rasti „GitHub“ kodo komponentų saugykloje.

Svarbu

• Tai yra peržiūros versijos funkcija.
• Peržiūros funkcijos nėra skirtos naudoti gamybai ir gali būti apribotas jų funkcionalumas. Šias funkcijas galima naudoti prieš oficialų išleidimą, kad klientai galėtų gauti ankstyvą prieigą ir pateikti atsiliepimų.

Aprašą

„Face pile“ (Facepile) rodomas asmenų sąrašas. Kiekvienas apskritimas atitinka asmenį, jame yra paveikslėlis arba inicialai. Dažnai šis valdiklis naudojamas bendrinant, kas turės prieigą prie konkretaus rodinio ar failo, arba priskiriant kam nors užduotį darbo eigoje.

Šis kodo komponentas suteikia aplankalą Fluent UI Facepile valdiklio jungčiai su mygtuku, skirtu naudoti drobės programose ir pasirinktiniuose puslapiuose.

Ypatybės

Pagrindinės ypatybės

Ypatybė	Aprašą
Items	Atvaizduotini veiksmo elementai. Pirmasis elementas laikomas šakniniu elementu.
PersonaSize	Ekrane rodomo asmens dydis
OverflowButtonType	Pasirinkti, kurį mygtuko Perpildyti tipą rodyti ir ar jis bus rodomas, ar ne
MaxDisplayablePersonas	Didžiausias „Facepile“ rodomų asmenų skaičius Penki yra numatytasis ir rekomenduojamas skaičius
ImageShouldFadeIn	Ar pasirodantis vaizdas turėtų turėti Ryškėjimo efektą
ShowAddButton	Ar mygtukas Įtraukti turėtų būti rodomas „Facepile“ komponente
OverflowButtonLabel	Mygtuko Perpildyti „Aria“ žyma
AddbuttonAriaLabel	Mygtuko Įtraukti „Aria“ žyma

Items Apgyvendinimo įstaigos

Pavadinimą	Aprašą
ItemPersonaName	Rodomas asmens vardas
ItemPersonaKey	Raktas identifikuoja konkretų elementą Raktas turi būti unikalus
ItemPersonaImage	„Dataverse“ lentelės vaizdo stulpelis, kuriame yra asmens vaizdas (profilio paveikslėlis)
ItemPersonaImageInfo	Asmens vaizdo (profilio paveikslėlio) URL arba „Base64“ turinys
ItemPersonaPresence	Pasirinktinai – asmens buvimui apibrėžti
IsImage	Ar asmens vaizdas (ItemPersonaImage) yra „Dataverse“ lentelės vaizdo stulpelis. Ši ypatybė leidžia komponentui generuoti vaizdą pagal tipą (URL arba vaizdas). Tiesa, jei vaizdą reikia nurodyti iš Dataverse lentelės ir klaidingą, jei tai URL arba Base64, kuris turi būti nukreiptas iš ItemPersonaImageInfo ypatybės
ItemPersonaClickable	Ar asmenį turi būti įmanoma spustelėti

„Power Fx“ formulės pavyzdys Items (naudoja „Office 365“ vartotojų jungtį)

Sugeneruokite Items rinkinį su nuotraukomis naudodami „Office 365“ vartotojų jungtį

Vartotojų sąrašas gali būti gautas iš bet kurio duomenų šaltinio, tačiau vaizdas turi būti pateiktas komponentui. Jei jūsų duomenų šaltinyje nėra vartotojams skirtų vaizdų, galite naudoti funkciją AddColumns() Power Fx , kad į sąrašą įtrauktumėte teisingus atributus ir nuskaitytumėte vartotojo vaizdą iš naudotojų ID arba pagrindinių vartotojų vardų sąrašo, kuris susiejamas su aktyviu jūsų vartotoju Microsoft Entra.

Sugeneruokite rinkinį UserPersonas naudodami „Office 365“ vartotojų jungtį pagal toliau pateiktą kodo pavyzdį, tada rinkinį perduokite į valdiklio Items ypatybę.

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

Pastaba.

Laukas IsImage nustatytas kaip klaidingas, nes ItemPersonaImageInfo gauta iš vaizdo URL. Norėdami atvaizduoti „Dataverse“ vaizdo laukus, nustatykite IsImage lauką kaip teisingą ir naudokite ItemPersonaImage norėdami verčiau perduoti vaizdo reikšmę.

Naudojimas

Stiliaus ypatybės

Ypatybė	Aprašą
Theme	Priima JSON eilutę, sugeneruotą naudojant „Fluent UI“ temų dizaino įrankį (windows.net). Palikus tuščią, bus naudojama numatytoji tema, apibrėžta „Power Apps“. Palikus tuščią, bus naudojama numatytoji tema, apibrėžta „Power Apps“. Norėdami gauti pagalbos, kaip tai sukonfigūruoti, žr. temos
AccessibilityLabel	Ekrano skaitytuvo „aria“ žyma

Įvykio ypatybės

Ypatybė	Aprašą
InputEvent	Įvykis, kuris bus siunčiamas į valdiklį. Pavyzdžiui, SetFocus.

Elgsena

Palaiko SetFocus kaip InputEvent.

„On Select“ veikimo konfigūravimas

Naudokite Switch() formulę komponento OnSelect ypatybėje, kad sukonfigūruotumėte konkrečius kiekvieno elemento veiksmus naudodami valdiklio pasirinktą ItemPersonaKey kaip perjungimo reikšmę.

„Power Fx“ formulės OnSelectFacepile ypatybėje pavyzdys:

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

Apribojimai

Šį kodo komponentą galima naudoti tik drobės programose ir pasirinktiniuose puslapiuose.