Jaa

SubwayNav Valvonta (esiversio)

  • Artikkeli

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Ohjausobjekti, jolla opastetaan käyttäjiä prosessin läpi.

Muistiinpano

Täydellinen dokumentaatio ja lähdekoodi löytyvät koodikomponenttien GitHub-säilöstä.

SubwayNavin ohjausobjekti.

Tärkeä

  • Tämä on esiversiotoiminto.
  • Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Description

SubwayNav-ohjausobjektin avulla voit visualisoida ohjatussa toiminnossa tarvittavat vaiheet. Ohjattu toiminto on osa, joka opastaa käyttäjiä saavuttamaan asennus- tai luontitehtävän valmiiksi määritetyt vaiheet.

Tämä koodikomponentti sisältää paketoijan haarallisen version Office 365 -järjestelmänvalvojan ohjausobjektistaSubwayNav.

Tärkeä

Älä avaa bugeja Admin Controls -tiimin kanssa – lähetä ongelmat aina Creator Kitin Github-säilöön osoitteessa aka.ms/creatorkit/bugi.

Tärkeimmät ominaisuudet

Name Description
Items Hahmonnettavien kohteiden (osavaiheet) taulukko (katso Items-taulukkorakenne alla).
WizardCompleteorError Näytetään nimellä SubwayNav-tila

Items Taulukon ominaisuudet

Jokaisen Items-syötetaulukon objektin on hahmonnettava oikein seuraavilla ominaisuuksilla:

Name Description
ItemLabel Vaiheen selite
ItemKey Avaimen avulla ilmaistaan, mikä kohde/vaihe valitaan. Avaimien on oltava yksilöiviä.
ParentItemKey Valinnainen. Ylätason ItemKey, jota käytetään alivaiheiden hahmontamiseen.
ItemState Määritetään vaiheen tila. Seuraavat tuetut tilat ovat saatavilla:
Current, NotStarted, Completed, Unsaved, ViewedNotCompleted, Error,, CurrentWithSubSteps, Skipped WizardComplete
ItemDisabled Valinnainen. Onko vaihe poistettu käytöstä.
ItemVisuallyDisabled Valinnainen. Onko vaihe visuaalisesti poistettu käytöstä.

Lisäominaisuudet

Name Description
AccessibilityLabel Näytönlukuohjelman aria-otsikko.
InputEvent Ohjausobjektiin lähetettävä tapahtuma. Esimerkiksi SetFocus. Lisätietoja alla.
Theme Hyväksyy Fluent UI Theme Designer (windows.net) -sovelluksella luodun JSON-merkkijonon. Tämän kentän jättäminen tyhjäksi käyttää Power Appsin määrittämää oletusteemaa.

Esimerkki:

  • Tukee SetFocus-tapahtumaa InputEvent-tapahtumana.

Esimerkki Nimikkeiden ominaisuuden syötekokoelman arvosta:

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

Saadaksesi käyttäjän valitun vaiheen, käytä OnSelect- tai OnChange -ominaisuutta SubwayNav-ohjausobjektilta.

Esimerkkikoodi:

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

Esimerkkejä alivaiheen skenaarioista

Alla on esimerkkinimikkeiden kokoelmaesimerkki, joka määrittää, miten alikohteet on linkitetään pää- ja ylävaiheisiin ParentItemKey-avaimen avulla.

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

Tulosrakenne

Kunkin kohteen (vaiheen) tila muuttuu, kun valitsemme tai siirrymme eri vaiheeseen sisäisesti, erityisesti Current ja CurrentWithSubStep. Nykyinen tila voidaan määrittää käyttämällä Tulos-ominaisuutta, jota kutsutaan nimellä Steps.

Esimerkkikoodi (viitattu SubwayNav-ohjausobjektista):

Self.Steps

Esimerkkikoodi (viittaa toisen ohjausobjektin vaiheisiin):

SubwayNav1.Steps

Rajoitukset

Tätä koodikomponenttia voidaan käyttää vain pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla.