Kontrolnik CommandBar (predogledna različica)

Kontrolnik, ki se uporablja za vnos ukazov.

opomba,

Celotno gradivo in izvirna koda sta na voljo v skladišču komponent kode storitve GitHub.

Description

CommandBar je površina, ki vsebuje ukaze za delovanje na vsebini okna, plošče ali nadrejene regije, nad katero leži.

Ta komponenta kode zagotavlja ovoj okoli kontrolnika Fluent UI CommandBar za uporabo v aplikacijah s platnom in straneh po meri.

Lastnosti

Lastnosti ključa

Lastnost	Description
Items	Elementi dejanj za upodabljanje

Struktura elementov

Vsak element uporablja naslednjo shemo za vizualizacijo podatkov v komponenti.

Imenu	Description
ItemDisplayName	Prikazano ime elementa ukazne vrstice.
ItemKey	Tipka, ki jo uporabite za označevanje izbranega elementa in pri dodajanju podelementov. Ključi morajo biti enolični.
ItemEnabled	Nastavite na »false«, če je možnost onemogočena.
ItemVisible	Nastavite na »false«, če možnost ni vidna.
ItemChecked	Nastavite na »true«, če je možnost označena (npr. razdeljeni gumbi v ukazni vrstici).
ItemSplit	Nastavite na »true«, če je možnost mogoče klikniti in uporabiti kot spustni pojavni meni.
ItemIconName	Ikona Fluent UI za uporabo (glejte ikone Fluent UI)
ItemIconColor	Barva za upodobitev ikone (npr. poimenovana, šestnajstiška ali rgb-vrednost).
ItemIconOnly	Ne prikaži oznake besedila – samo ikono.
ItemOverflow	Nastavljeno na »true« za način delovanja prekoračitev
ItemOverflow	Upodobite možnost v elementih prekoračitve.
ItemFarItem	Upodobite možnost v oddaljeni skupini elementov ukazne vrstice.
ItemHeader	Upodobi element kot glavo odseka. Če obstajajo elementi, ki imajo svoj ItemParentKey nastavljen na ključ tega elementa, potem so dodani kot semantično združeni elementi v tem razdelku.
ItemTopDivider	Upodobite delilnik na vrhu razdelka.
ItemDivider	Upodobi element kot delilnik odseka – ali če je element glava (ItemHeader = true), potem nadzira, ali naj se upodobi delilnik na dnu odseka.
ItemParentKey	Upodobi možnost kot podrejeni element druge možnosti.

opomba,

• ItemIconColor bo preglasil vrednost teme komponente in prezrl druge barve stanja (npr. onemogočeno).
• ItemHeader in ItemDivider morata biti nastavljena na »true«, da se upodobi kot delilnik. Če je nastavljeno na »false«, pričakuje druge vrednosti in bo upodobljeno prazno.

Primer

Primer formule Power Fx za osnovno kodo 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"
    }
)
  

Lastnosti sloga

Lastnost	Description
Theme	Sprejme niz JSON, ki je ustvarjen z oblikovalnikom tem Fluent UI Theme Designer (windows.net). Če pustite to polje prazno, bo uporabljena privzeta tema, določena za Power Apps. Glejte nastavitev tem za pomoč pri konfiguraciji.
AccessibilityLabel	Oznaka aria za bralnik zaslona

Lastnosti dogodkov

Lastnost	Description
InputEvent	Dogodek, ki bo poslan kontrolniku. Npr. SetFocus.

Način delovanja

Podpira SetFocus kot InputEvent.

Konfiguracija načina delovanja »ob izbiri«

Z uporabo formule Switch() v lastnosti komponente OnSelect lahko za vsak element konfigurirate posebna dejanja tako, da se za vrednost »preklopa« sklicujete na izbrano vrednost ItemKey kontrolnika.

Zamenjajte vrednosti false z ustreznimi izrazi v jeziku Power Fx.

  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
  )

Nastavitev fokusa na kontrolnik

Ko se prikaže novo pogovorno okno in mora biti privzeti fokus na kontrolniku, bo potreben izrecno nastavljen fokus.

Če želite klicati vhodni dogodek, lahko nastavite kontekstno spremenljivko, ki je vezana na lastnost vhodnega dogodka na niz, ki se začne z SetFocus in sledi naključni element, da zagotovite, da ga aplikacija zazna kot spremembo.

Primer formule za Power Fx:

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

Spremenljivka konteksta ctxResizableTextareaEvent bi bila nato vezana na lastnost Input Event property .

Omejitve

Ta komponenta kode se lahko uporablja samo v aplikacijah s platnom in na straneh po meri.

Oglejte si več opomb o omejitvah v razdelku izzivi oblikovanja komponente.