Share via

Ovládací prvek Breadcrumb

  • Článek

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.

Ovládací prvek Breadcrumb.

Description

Ovládací prvky Breadcrumb by měly být používány jako navigační pomůcka v aplikaci nebo webu. Označují umístění aktuální stránky v rámci hierarchie a pomáhají uživateli pochopit, kde se nachází ve vztahu ke zbytku této hierarchie. Ovládací prvek Breadcrumb také poskytuje přístup jedním kliknutím k vyšším úrovním této hierarchie.

Tato komponenta kódu poskytuje obálku kolem ovládacího prvku Fluent UI Breadcrumb pro použití v aplikacích plátna a vlastních stránkách.

Vlastnosti

Hlavní vlastnosti

Vlastnost Description
SelectedKey Označuje vybraný klíč. Toto bude aktualizováno prostřednictvím události OnChange, kdy uživatel interaguje s ovládacím prvkem.
Items Akční položky k vykreslení

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 popisu cesty
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é.
ItemClickable Nastavte na hodnotu false v případě, že na konkrétní položku popisu cesty nelze kliknout.

Příklad vzorce Power Fx:

Table(
    {
        ItemKey: "1",
        ItemDisplayName: "General",
        ItemClickable: true
    },
    {
        ItemKey: "2",
        ItemDisplayName: "Document",
        ItemClickable: true
    }
)

Vlastnosti stylu

Name 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
MaxDisplayedItems Určuje maximální počet popisků cesty, které se mají zobrazit před splynutím. Pokud je nula, vykreslí se celý popis cesty.
OverflowIndex Volitelný index, kde budou sbalené položky přetečení. Výchozí nastavení je nula.

Vlastnosti události

Name 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.

Protože se tento ovládací prvek používá pro navigaci, je třeba jako akci použít navigační funkci (ideálně na příslušnou obrazovku s načtenými souvisejícími daty).

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 1 */
    "1", false,
    
    /* Action for ItemKey 2 */
    "2", 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.

Příklad vzorce Power Fx:

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.