Facepile नियंत्रण (पूर्वावलोकन)

[यह आलेख रिलीज़-पूर्व दस्तावेज़ है और परिवर्तन के अधीन है.]

छवियों को प्रदर्शित करने और उनके साथ सहभागिता करने के लिए उपयोग किया जाने वाला नियंत्रण.

नोट

पूर्ण दस्तावेज़ीकरण और स्रोत कोड GitHub कोड घटक रिपॉजिटरी में मिला.

महत्त्वपूर्ण

• यह एक पूर्वावलोकन सुविधा है.
• पूर्वावलोकन सुविधाएँ उत्पादन में उपयोग के लिए नहीं होती हैं और इनकी कार्यक्षमता प्रतिबंधित हो सकती हैं. यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.

विवरण

फ़ेस पाइल (Facepile) व्यक्तियों की सूची प्रदर्शित करता है. प्रत्येक वृत्त एक व्यक्ति का प्रतिनिधित्व करता है और इसमें उनकी छवि या आद्याक्षर होते हैं. अक्सर इस नियंत्रण का उपयोग यह साझा करते समय किया जाता है कि किसी विशिष्ट दृश्य या फ़ाइल तक किसकी पहुंच है, या किसी कार्यप्रवाह के भीतर किसी को कार्य सौंपते समय.

यह कोड घटक कैनवास ऐप्स और कस्टम पृष्ठों में उपयोग के लिए एक बटन से सीमित Fluent UI Facepile नियंत्रण के लिए एक आवरण प्रदान करता है.

विशेषता

मुख्य गुण

गुण	विवरण
Items	रेंडर करने के लिए क्रिया आइटम. पहली वस्तु को मूल वस्तु माना जाता है.
PersonaSize	स्क्रीन पर दिखने वाले व्यक्तित्व का आकार
OverflowButtonType	यह चुनने के लिए कि किस प्रकार का ओवरफ़्लो बटन प्रदर्शित होना है और प्रदर्शित होना है या नहीं
MaxDisplayablePersonas	फेसपाइल में प्रकट होने वाले व्यक्तित्व की अधिकतम संख्या पांच डिफ़ॉल्ट और अनुशंसित संख्या है
ImageShouldFadeIn	क्या छवि को प्रदर्शित होने के दौरान फेड इन प्रभाव होना चाहिए
ShowAddButton	क्या फेसपाइल घटक में जोड़ें बटन दिखाई देना चाहिए
OverflowButtonLabel	ओवफ़्लो बटन के लिए आरिया लेबल
AddbuttonAriaLabel	जोड़े बटन के लिए आरिया लेबल

Items गुण

नाम	विवरण
ItemPersonaName	व्यक्ति का डिस्प्ले नाम
ItemPersonaKey	कुंजी विशिष्ट आइटम की पहचान करती है यह कुंजी अनूठी होना चाहिए.
ItemPersonaImage	Dataverse तालिका का छवि कॉलम जिसमें व्यक्ति की छवि (प्रोफाइल पिक्चर) है
ItemPersonaImageInfo	व्यक्तित्व छवि की Url या Base64 सामग्री (प्रोफ़ाइल पिक्चर)
ItemPersonaPresence	वैकल्पिक - व्यक्तित्व की उपस्थिति को परिभाषित करने के लिए
IsImage	क्या व्यक्तित्व छवि (ItemPersonaImage) Dataverse तालिका का छवि स्तंभ है. यह संपत्ति घटक को प्रकार (Url या छवि) के आधार पर छवि प्रस्तुत करने की अनुमति देती है. यदि छवि को Dataverse टेबल से संदर्भित करने की आवश्यकता है तो सही और यदि यह एक यूआरएल या बेस 64 है जिसे ItemPersonaImageInfo प्रॉपर्टी से संदर्भित किया जाना है तो गलत
ItemPersonaClickable	व्यक्तित्व क्लिक करने योग्य होना चाहिए या नहीं

उदाहरण Items के लिए Power Fx सूत्र (Office 365 उपयोगकर्ता कनेक्टर का उपयोग करता है)

Office 365 उपयोगकर्ता कनेक्टर का उपयोग करके फ़ोटो के साथ Items संग्रह जेनरेट करें

उपयोगकर्ताओं की सूची किसी भी डेटा स्रोत से आ सकती है, लेकिन छवि घटक को प्रदान की जानी चाहिए. यदि आपके डेटा स्रोत में उपयोगकर्ताओं के लिए छवियां नहीं हैं, तो आप सूची में सही विशेषताओं को जोड़ने और उपयोगकर्ता की छवि को पुनः प्राप्त करने के लिए AddColumns() Power Fx फ़ंक्शन का उपयोग कर सकते हैं, उपयोगकर्ता आईडी या उपयोगकर्ता प्रिंसिपल नामों की सूची से जो आपके सक्रिय उपयोगकर्ता से मेल खाते हैं। Microsoft Entra

नीचे दिए गए नमूना कोड को संदर्भित करके, और फिर नियंत्रण के Items गुण में संग्रह पास करके, Office 365 उपयोगकर्ता कनेक्टर का उपयोग करके UserPersonas नामक संग्रह बनाएँ.

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

नोट

IsImage फ़ील्ड को गलत पर सेट किया गया है क्योंकि ItemPersonaImageInfo एक छवि Url से आ रहा है. Dataverse इमेज फ़ील्ड रेंडर करने के लिए, IsImage फ़ील्ड को सही पर सेट करें और इसके बजाय छवि मान पास करने के लिए ItemPersonaImage का इस्तेमाल करें.

उपयोग

स्टाइल के गुण

गुण	विवरण
Theme	Fluent UI थीम डिज़ाइनर (windows.net) का उपयोग करके उत्पन्न JSON स्ट्रिंग को स्वीकार करता है. इसे खाली छोड़ने से Power Apps द्वारा परिभाषित डिफ़ॉल्ट थीम का उपयोग किया जाएगा. इसे खाली छोड़ने से Power Apps द्वारा परिभाषित डिफ़ॉल्ट थीम का उपयोग किया जाएगा. इसे कॉन्फ़िगर करने का तरीका देखने के लिए, थीमिंग देखें.
AccessibilityLabel	स्क्रीन पढ़ने वालों का आरिया-लेबल

इवेंट गुण

गुण	विवरण
InputEvent	नियंत्रण को भेजने के लिए एक इवेंट. उदाहरण के लिए, SetFocus.

व्यवहार

SetFocus के रूप में InputEvent का समर्थन करता है.

ऑन सेलेक्ट व्यवहार को कॉन्फ़िगर करें

नियंत्रण के चयनित ItemPersonaKey को स्विच मान के रूप में संदर्भित करके प्रत्येक आइटम के लिए विशिष्ट क्रियाओं को कॉन्फ़िगर करने के लिए घटक के OnSelect गुण में स्विच() सूत्र का उपयोग करें.

उदाहरण Facepile के OnSelect गुण में Power Fx फ़ॉर्मूला:

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

सीमाएँ

इस कोड घटक का उपयोग केवल कैनवास ऐप और कस्टम पृष्ठों में ही किया जा सकता है.