Nav řízení
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. |
Items
vlastnosti
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.