CommandBar nadzor (predogled)

Kontrolnik, ki se uporablja za vnos ukazov.

opomba,

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

Kontrolnik CommandBar.

Description

CommandBar je površina, ki vsebuje ukaze, ki delujejo na vsebini okna, plošče ali nadrejenega območja, nad katerim se nahaja.

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 mora biti nastavljen na true, da se upodobi kot razdelilnik. Č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.

  • Last updated on