Ovládací prvek Nav

Ovládací prvek používaný k navigaci.

Poznámka:

Úplná dokumentace a zdrojový kód jsou k dispozici v úložišti komponent kódu GitHubu.

Description

Navigační podokno (Nav) poskytuje odkazy na hlavní oblasti aplikace nebo webu.

Komponenta kódu Nav umožňuje použití komponenty nabídky Fluent UI Nav z aplikací plátna a vlastních stránek.

Poznámka:

Zdrojový kód komponenty a další informace jsou k dispozici v úložišti komponent kódu GitHubu.

Vlastnosti

Hlavní vlastnosti

Vlastnost	Description
Selected key	Klíč, který se má vybrat. Toto bude aktualizováno prostřednictvím události OnChange, kdy uživatel interaguje s ovládacím prvkem.
Items	Požadováno. Tabulka položek zdroje dat, která se má vykreslit.
Fields	Požadováno. Pole, která jsou zahrnuta z datové sady.

Vlastnosti Items

Každá položka používá níže uvedené schéma k vizualizaci dat v komponentě.

Name	Description
ItemDisplayName	Zobrazovaný název položky příkazu/karty/nabídky
ItemKey	Klíč používaný k označení vybrané položky a při přidávání dílčích položek. Klíče musí být jedinečné.
ItemEnabled	Pokud je tato možnost zakázána, nastavte ji na hodnotu false
ItemVisible	Pokud tato možnost není vidět, nastavte na hodnotu false
ItemIconName	Ikona Fluent UI, kterou chcete použít (viz Ikony uživatelského rozhraní Fluent)
ItemIconColor	Barva, jakou se má ikona vykreslit (například pojmenovaná, RGB nebo hexadecimální hodnota)
ItemIconOnly	Nezobrazovat textový popisek – pouze ikonu
ItemParentKey	Vykreslit možnost jako podřízenou položku jiné možnosti
ItemExpanded	Nastavte na hodnotu false, nebo true, pokud má skupina zůstat sbalená, nebo rozbalená.

Příklad:

Table(
  {
      ItemKey: "1",
      ItemDisplayName: "Home with Icon & Custom color",
      ItemIconName: "Home",
      ItemIconColor: "Green"
  },
  {
      ItemKey: "2",
      ItemDisplayName: "Documents",
      ItemExpanded: true
  },
  {
      ItemKey: "3",
      ItemDisplayName: "Contents"
  },
  {
      ItemKey: "4",
      ItemDisplayName: "Item Invisible",
      ItemVisible: false
  },
  {
      ItemKey: "5",
      ItemDisplayName: "Quick Reference Guide",
      ItemParentKey: "3",
      ItemIconName: "Document"
  }
)

Vlastnosti stylu

Vlastnost	Description
Theme	Přijímá řetězec JSON, který je generován pomocí návrháře motivů Fluent UI (windows.net). Ponecháte-li toto prázdné, použije se výchozí motiv definovaný Power Apps. Nápovědu ke konfiguraci naleznete v části motivy.
AccessibilityLabel	Popisek Aria pro čtečky obrazovky
CollapseByDefault	Nastavte na hodnotu True, nebo False (zapnuto nebo vypnuto), pokud má skupina Nav zůstat sbalená, nebo rozbalená. Je respektována vlastnost rozšíření na úrovni jednotlivých položek.

Vlastnosti události

Vlastnost	Description
InputEvent	Událost, která se má odeslat do ovládacího prvku. Např. SetFocus. Viz níže.

Chování

Podporuje SetFocus jako InputEvent.

Konfigurace chování při události 'On Select'

Použijte vzorec Switch() ve vlastnosti OnSelect komponenty pro konfiguraci konkrétních akcí spouštěných každou položkou, a to odkazem na vybraný ovládací prvek ItemKey jako hodnotu přepínače.

Hodnoty false nahraďte příslušnými výrazy v jazyce Power Fx.

  Switch( Self.Selected.ItemKey,

    /* Action for ItemKey 1 */
    "1", false,

    /* Action for ItemKey 2 */
    "2", false,

    /* Action for ItemKey 3 */
    "3", false,

    /* Action for ItemKey 4 */
    "4", false,

    /* Action for ItemKey 5 */
    "5", false,

    /* Default action */
        false
  )

Nastavení zaměření na ovládací prvek

Když se zobrazí nové dialogové okno a výchozí fokus by měl být na ovládacím prvku, bude potřeba explicitně nastavit fokus.

Chcete-li volat vstupní událost, můžete nastavit kontextovou proměnnou, která je vázána na vlastnost Input Event na řetězec začínající řetězcem SetFocus a následuje náhodný prvek, který zajistí, že to aplikace detekuje jako změnu.

Např.

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

Kontextová proměnná ctxResizableTextareaEvent pak může být vázána na vlastnost Input Event.

Omezení

Tuto komponentu kódu lze použít pouze v aplikacích plátna a vlastních stránkách.