CommandBar valdiklis (peržiūra)

Valdiklis, naudojamas įvesties komandoms.

Pastaba.

Visą instrukciją ir šaltinio kodą galima rasti „GitHub“ kodo komponentų saugykloje.

Aprašą

CommandBar yra paviršius, kuriame yra komandos, veikiančios lango, skydelio ar pirminio regiono, kuriame jis yra, turinį.

Šis kodo komponentas suteikia aplankalą „Fluent UI CommandBar“ valdikliui, kad jį būtų galima naudoti drobių programose ir pasirinktiniuose puslapiuose.

Ypatybės

Raktų ypatybės

Ypatybė	Aprašą
Items	Atvaizduotini veiksmo elementai

Elementų struktūra

Kiekvienas elementas naudoja šią schemą komponento duomenims vizualizuoti.

Pavadinimą	Aprašą
ItemDisplayName	Rodomas komandų juostos elemento pavadinimas.
ItemKey	Raktas, naudojamas norint nurodyti, kuris elementas pasirinktas, ir įtraukiant antrinius elementus. Raktai turi būti unikalūs.
ItemEnabled	Jei parinktis išjungta, nustatoma kaip Klaidinga.
ItemVisible	Jei parinktis nematoma, nustatoma kaip Klaidinga.
ItemChecked	Nustatoma kaip Teisinga, jei parinktis pažymėta (pvz., numatytieji mygtukai komandų juostoje).
ItemSplit	Nustatykite kaip teisingą, jei parinktį galima spustelėti ir naudoti kaip iškeliamąjį meniu.
ItemIconName	Naudotina „Fluent UI“ piktograma (žr. „Fluent UI“ piktogramos)
ItemIconColor	Spalva, kuria atvaizduotina piktograma (pvz., pavadinta, rgb ar hex reikšmė).
ItemIconOnly	Nerodyti teksto žymos – tik piktograma.
ItemOverflow	Nustatyti kaip teisingą perpildos elgsenai
ItemOverflow	Atvaizduoti perpildos elementų parinktį.
ItemFarItem	Atvaizduoti parinktį komandų juostos tolimųjų elementų grupėje.
ItemHeader	Atvaizduoti elementą kaip skyriaus antraštę. Jei yra elementų, kurių ItemParentKey nustatytas šio elemento raktui, jie įtraukiami į šį skyrių kaip semantiškai sugrupuoti elementai.
ItemTopDivider	Atvaizduoti skyriklį šio skyriaus viršuje.
ItemDivider	Rodyti elementą kaip skyriaus skyriklį arba, jei elementas yra antraštė (ItemHeader = teisinga), tada valdyti, ar skyriaus apačioje turi būti rodomas skyriklis.
ItemParentKey	Parinkties atvaizdavimas kaip antrinio kitos parinkties elemento.

Pastaba.

• ItemIconColor perrašys komponento temos reikšmę ir nepaisys kitų būsenos spalvų (pvz., išjungta).
• ItemHeader ir ItemDivider turi būti nustatytas kaip teisingas, kad būtų pateiktas kaip daliklis. Jei nustatyta kaip klaidinga, bus tikimasi kitų reikšmių ir bus atvaizduojama kaip tuščia.

Pavyzdžiui

Power Fx formulės pavyzdys baziniam Items:

Table(
    {
        ItemKey: "new",
        ItemDisplayName: "New",
        ItemIconName: "Add"
    },
    {
        ItemKey: "edit",
        ItemDisplayName: "Edit",
        ItemIconName: "Edit"
    },{
        ItemKey: "delete",
        ItemDisplayName: "Delete",
        ItemIconName: "Delete"
    },{
        ItemKey: "refresh",
        ItemDisplayName: "Refresh",
        ItemIconName: "refresh"
    },{
        ItemKey: "help",
        ItemDisplayName: "Help",
        ItemIconName: "help"
    }
)
  

Stiliaus ypatybės

Ypatybė	Aprašą
Theme	Priima JSON eilutę, sugeneruotą naudojant „Fluent UI“ temų dizaino įrankį (windows.net). Palikus tuščią, bus naudojama numatytoji tema, apibrėžta „Power Apps“. Norėdami gauti pagalbos, kaip tai sukonfigūruoti, žr. temos
AccessibilityLabel	Ekrano skaitytuvo „aria“ žyma

Įvykio ypatybės

Ypatybė	Aprašą
InputEvent	Įvykis, kuris bus siunčiamas į valdiklį. Pvz., SetFocus.

Elgsena

Palaiko SetFocus kaip InputEvent.

„On Select“ veikimo konfigūravimas

Naudokite Switch() formulę komponento OnSelect ypatybėje, kad sukonfigūruotumėte konkrečius kiekvieno elemento veiksmus naudodami valdiklio pasirinktą ItemKey kaip perjungimo reikšmę.

Pakeiskite false reikšmes atitinkamomis Power Fx kalbos išraiškomis.

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 'new' (e.g., Patch function) */
    "new", false,
    
    /* Action for 'edit' (e.g., Patch function) */
    "edit", false,
    
    /* Action for 'delete' (e.g., Remove function ) */
    "delete", false,
    
    /* Action for 'refresh' (e.g., Refresh function) */
    "refresh", false,
    
    /* Action for 'help' (e.g., email support with the Office 365 connector ) */
    "help", false,
  
    /* Default action */
        false
  )

Valdiklio fokusavimo nustatymas

Kai rodomas naujas dialogo langas ir numatytoji įvesties vieta turi būti valdiklis, reikės aiškiai nustatyti įvesties vietą.

Norėdami iškviesti įvesties įvykį, galite nustatyti konteksto kintamąjį, kuris susijęs su įvesties įvykio ypatybe, eilutėje, kuri prasideda SetFocus ir po kurios eina atsitiktinis elementas, norint užtikrinti, kad programa tai aptiks kaip pakeitimą.

Power Fx formulės pavyzdys:

UpdateContext({ ctxResizableTextareaEvent:"SetFocus" & Text(Rand()) }));

Konteksto kintamasis ctxResizableTextareaEvent tada būtų susietas su įvykio įvedimo ypatybe.

Apribojimai

Šį kodo komponentą galima naudoti tik drobės programose ir pasirinktiniuose puslapiuose.

Daugiau pastabų dėl apribojimų žr. Komponentų dizaino problemos.