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

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

  • आलेख

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

एक नियंत्रण जिसका उपयोग उपयोगकर्ताओं को किसी प्रक्रिया के माध्यम से मार्गदर्शन करने के लिए किया जाता है।

नोट

पूर्ण दस्तावेज़ीकरण और स्रोत कोड GitHub कोड घटक भंडार में पाया गया। ...

सबवेनेव नियंत्रण.

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

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

विवरण

SubwayNav नियंत्रण आपको किसी दिए गए विज़ार्ड के लिए आवश्यक चरणों को देखने की अनुमति देता है। विज़ार्ड एक घटक है जो उपयोगकर्ताओं को सेटअप या निर्माण कार्य को पूरा करने के लिए पूर्वनिर्धारित चरणों को पूरा करने के लिए मार्गदर्शन करता है।

यह कोड घटक Office 365 Admin Control के फोर्क्ड संस्करण के चारों ओर एक आवरण प्रदान करता है। SubwayNav

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

व्यवस्थापक नियंत्रण टीम के साथ बग न खोलें - हमेशा क्रिएटर किट गिटहब रिपॉजिटरी में aka.ms/creatorkit/bug पर समस्याएँ सबमिट करें।

मुख्य गुण

नाम विवरण
Items प्रस्तुत करने के लिए आइटम (चरण) की तालिका (नीचे तालिका स्कीमा देखें)। Items
WizardCompleteorError "सबवेनेव स्थिति" के रूप में दिखाया गया

Items तालिका गुण

Items इनपुट तालिका में प्रत्येक ऑब्जेक्ट को सही ढंग से रेंडर करने के लिए निम्नलिखित गुणों का उपयोग करना चाहिए:

Name विवरण
ItemLabel चरण के लिए लेबल
ItemKey यह बताने के लिए उपयोग की जाने वाली कुंजी कि कौन सा आइटम/चरण चयनित है। कुंजियाँ अद्वितीय होनी चाहिए.
ParentItemKey ऑप्शनल. पैरेंट की ItemKey, जिसका उपयोग उपचरणों को रेंडर करने के लिए किया जाता है।
ItemState चरण की स्थिति निर्दिष्ट करना. निम्नलिखित समर्थित राज्य उपलब्ध हैं:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error, CurrentWithSubSteps, Skipped, WizardComplete
ItemDisabled ऑप्शनल. क्या चरण अक्षम है.
ItemVisuallyDisabled ऑप्शनल. क्या चरण दृश्यतः अक्षम है.

अतिरिक्त गुण

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

उदाहरण

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

आइटम संपत्ति के लिए इनपुट संग्रह मान का उदाहरण:

Table(
    { ItemKey:"1", ItemLabel:"Step 1", ItemState:"Current" },
    { ItemKey:"2", ItemLabel:"Step 2", ItemState:"Completed" },
    { ItemKey:"3", ItemLabel:"Step 3", ItemState:"Unsaved" },
    { ItemKey:"4", ItemLabel:"Step 4", ItemState:"ViewedNotCompleted" },
    { ItemKey:"5", ItemLabel:"Step 5", ItemState:"Error" },
    { ItemKey:"6", ItemLabel:"Step 6", ItemState:"WizardComplete" }
)

उपयोगकर्ता द्वारा चयनित चरण प्राप्त करने के लिए, OnSelect नियंत्रण के OnChange या SubwayNav गुण का उपयोग करें।

उदाहरण कोड:

Notify( Concatenate(Self.Selected.ItemLabel, " selected and its status is ", Self.Selected.ItemState ));

उपचरण परिदृश्यों के लिए उदाहरण

नीचे एक नमूना आइटम संग्रह उदाहरण दिया गया है जो परिभाषित करता है कि उप-चरणों को ParentItemKey का उपयोग करके मुख्य/मूल चरण के साथ कैसे जोड़ा जाना चाहिए।

Table(
    { ItemKey:"1", ItemLabel:"Step 1", ItemState:"Current" },
    { ItemKey:"2", ItemLabel:"Step 2 have sub-steps", ItemState:"WizardComplete" },
    { ItemKey:"3", ItemLabel:"Sub Step 2.1", ParentItemKey:"2", ItemState:"Error" },
    { ItemKey:"4", ItemLabel:"Sub Step 2.2", ParentItemKey:"2", ItemState:"WizardComplete" }, 
    { ItemKey:"5", ItemLabel:"Sub Step 3.1", ParentItemKey:"8", ItemState:"ViewedNotCompleted" }, 
    { ItemKey:"6", ItemLabel:"Sub Step 3.2", ParentItemKey:"8", ItemState:"Unsaved" }, 
    { ItemKey:"7", ItemLabel:"Sub Step 3.2", ParentItemKey:"8", ItemState:"Unsaved" }, 
    { ItemKey:"8", ItemLabel:"Step 3 too have sub-steps", ItemState:"Unsaved" }, 
    { ItemKey:"9", ItemLabel:"Step 4", ItemState:"Error" }, 
    { ItemKey:"10", ItemLabel:"Step 5", ItemState:"WizardComplete" }
)

आउटपुट स्कीमा

प्रत्येक आइटम (चरण) की स्थिति तब बदलती है जब हम अलग-अलग चरण का चयन करते हैं या उन पर जाते हैं, यह आंतरिक रूप से होता है, विशेष रूप से Current & CurrentWithSubStep। वर्तमान स्थिति को Steps नामक आउटपुट गुण का उपयोग करके निर्धारित किया जा सकता है।

उदाहरण कोड ( SubwayNav नियंत्रण से संदर्भित):

Self.Steps

उदाहरण कोड (किसी अन्य नियंत्रण से चरणों का संदर्भ देते हुए):

SubwayNav1.Steps

सीमाएँ

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