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

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

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

नोट

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

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

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

विवरण

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

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

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

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

मुख्य गुण

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

Items तालिका गुण

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

नाम	विवरण
ItemLabel	चरण के लिए लेबल
ItemKey	यह इंगित करने के लिए उपयोग की जाने वाली कुंजी कि कौन सा आइटम/चरण चयनित है. कुंजियाँ अद्वितीय होनी चाहिए.
ParentItemKey	ऑप्शनल. माता-पिता की आइटम कुंजी, जिसका उपयोग उपचरणों के प्रतिपादन के लिए किया जाता है.
ItemState	चरण की स्थिति निर्दिष्ट करना. निम्नलिखित समर्थित राज्य उपलब्ध हैं: Current, NotStarted, CompletedUnsavedViewedNotCompletedErrorCurrentWithSubStepsSkippedWizardComplete
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 ));

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

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

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

सीमाएँ

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