इसके माध्यम से साझा किया गया

Picker नियंत्रण

  • आलेख

खोज अनुभव प्रदान करने के लिए उपयोग किया जाने वाला नियंत्रण.

नोट

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

पिकर नियंत्रण.

विवरण

पिकर का उपयोग एक बड़ी सूची से एक या अधिक आइटम, जैसे टैग या फ़ाइलें चुनने के लिए किया जाता है.

पिकर कोड घटक Fluent UI पिकर मेनू घटकों को कैनवास ऐप्स और कस्टम पेज के अंदर उपयोग होने की अनुमति देते हैं.

टैग पिकर कोड घटक निम्नलिखित विशेषताएं प्रदान करता है:

  1. चुने गए टैग के लिए एक इनपुट संग्रह से जुड़ता है.
  2. सुझाए गए टैग के लिए एक इनपुट संग्रह से जुड़ता है.
  3. उपयोगकर्ताओं को सुझावों में से चयन करने या मुक्त-पाठ टैग दर्ज करने की अनुमति देता है.
  4. एक बदलाव पर इवेंट तब बढ़ाता है जब कोई उपयोगकर्ता टैग जोड़ता या हटाता है.
  5. प्रोग्रामैटिक फ़ोकस सेट करने की अनुमति देता है.

डेटासेट

टैग पिकर में निम्नलिखित इनपुट डेटासेट होते हैं, जिनके बारे में विस्तार से मुख्य गुण बाद में इस लेख में वर्णित किया गया है.

  • Tags
    • TagsDisplayName
  • Suggestions
    • SuggestionsDisplayName
    • SuggestionSubDisplayName

Suggestions डेटासेट को SearchTerm आउटपुट गुण का उपयोग करके फ़िल्टर किया जाना चाहिए, उदाहरण के लिए:

Search(colSuggestions,TagPicker.SearchTerm,"name")

विशेषता

मुख्य गुण

गुण विवरण
Items टैग्स का एक संग्रह (तालिका). घटक के ऐड या रिमूव इवेंट्स (निम्नलिखित OnChange इवेंट सेक्शन में वर्णित) के रेज़रिंग के प्रत्युत्तर में टैग जोड़ने या हटाने के लिए ऐप ज़िम्मेदार है.
Suggestions_Items सुझावों का एक संग्रह (तालिका).
TagMaxWidth रेंडरिंग के समय टैग की अधिकतम चौड़ाई. अतिप्रवाह पाठ को पदलोप चिह्न के साथ छोटा कर दिया जाएगा और एक होवर टूलटिप पूर्ण पाठ दिखाता है.
AllowFreeText मान टाइप करते समय, पहले सुझाव का स्वचालित रूप से चयन न करें, ताकि पूर्व-निर्धारित सूची में से चयन करने के बजाय एक निःशुल्क पाठ प्रविष्टि प्रदान की जा सके।
SearchTermToShortMessage जब शब्द MinimumSearchTermLength से कम हो, तब प्रदर्शित होने वाला संदेश.
HintText जब कोई खोज शब्द न दिया गया हो, तब पिकर के अंदर प्रदर्शित होने वाला संदेश.
NoSuggestionsFoundMessage सुझाव संग्रह में कोई परिणाम न होने पर प्रदर्शित होने वाला संदेश.
MinimumSearchTermLength सुझावों के फ़्लाईआउट को ट्रिगर करने के लिए वर्णों की न्यूनतम संख्या.
MaxTags टैग्स की वह अधिकतम संख्या, जो जोड़ी जा सकती है. इस नंबर के बाद, टैग पिकर तब तक फिर से केवल केवल-उत्तर रहेगा, जब तक कोई टैग हटा नहीं दिया जाता.
Error सही जब लाल त्रुटि सीमा प्रदर्शित की जानी चाहिए.

Items गुण

गुण विवरण
TagsDisplayName डिस्प्ले नाम टैग रखने वाले कॉलम के नाम पर सेट करें.

Suggestions गुण

गुण विवरण
SuggestionsDisplayName सुझाव डिस्प्ले नाम रखने वाले कॉलम के नाम पर सेट करें.
SuggestionsSubDisplayName (वैकल्पिक) पाठ की द्वितीयक पंक्ति रखने वाले स्तंभ के नाम पर सेट करें.

स्टाइल के गुण

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

इवेंट गुण

गुण विवरण
Input Event TagPicker पर भेजे गए इवेंट पर सेट करें

आउटपुट गुण

गुण विवरण
SearchTerm टैग पिकर में डाला गया पाठ जिसका उपयोग सुझाव डेटासेट को फ़िल्टर करने के लिए किया जा सकता है.
TagsDisplayName वह टेक्स्ट जिसका उपयोग नया टैग बनाने के लिए किया जाता है, जब On Change इवेंट सक्रिय हो
AutoHeight जब टैग पिकर कई पंक्तियों में रैप हो जाता है, तो ऑटो ऊंचाई गुण का उपयोग प्रतिक्रियाशील कंटेनर ऊंचाई की ऊंचाई को नियंत्रित करने के लिए किया जा सकता है.

व्यवहार

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

OnChange इवेंट

TagPickerघटक एक OnChange इवेंट बढ़ाता है, जब टैग जोड़े या हटाए जाते हैं. गुण इसके लिए उपयोग किए जाते हैं:

गुण विवरण
TagEvent इवेंट का नाम बढ़ाया गया
TagKey उस आइटम की कुंजी जिसने इवेंट उठाया है (यदि ईवेंट किसी टैग से संबंधित है)

इवेंट में इसके समान एक्सप्रेशन होना चाहिए:

If( TagPicker.TagEvent = "Add" && CountRows(Filter(colTags,name=TagPicker.TagsDisplayName)) = 0,
    Collect( colTags, { name:TagPicker.TagsDisplayName })
);

If( TagPicker.TagEvent="Remove",
 RemoveIf( colTags,name=Text(TagPicker.TagsDisplayName) )
);

सीमाएँ

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