Delen via

Breadcrumb controle

  • Artikel

Een besturingselement dat wordt gebruikt om te navigeren.

Notitie

Volledige documentatie en broncode vindt u in de GitHub-opslagplaats voor codeonderdelen.

Besturingselement Breadcrumb.

Omschrijving

Breadcrumb besturingselementen moeten worden gebruikt als navigatiehulpmiddel in uw app of site. Ze geven de locatie van de huidige pagina binnen een hiërarchie aan en helpen de gebruiker te begrijpen waar ze zich bevinden ten opzichte van de rest van die hiërarchie. Een breadcrumb biedt ook toegang met één klik tot hogere niveaus van die hiërarchie.

Dit codeonderdeel biedt een wrapper rond het besturingselement Fluent UI Breadcrumb voor gebruik in canvas-apps en aangepaste pagina's.

Eigenschappen

Belangrijke eigenschappen

Eigenschappen Omschrijving
SelectedKey Dit geeft de geselecteerde sleutel aan. Dit wordt bijgewerkt via de gebeurtenis OnChange wanneer de gebruiker interactie heeft met het besturingselement.
Items De actie-items die moeten worden weergegeven

Items eigenschappen

Elk item gebruikt het onderstaande schema om gegevens in het onderdeel te visualiseren.

Name Omschrijving
ItemDisplayName De weergavenaam van het breadcrumb-item.
ItemKey De toets die moet worden gebruikt om aan te geven welk item is geselecteerd en bij het toevoegen van subitems. De toetsen moeten uniek zijn.
ItemClickable Stel in op false als het specifieke breadcrumb-item niet klikbaar is.

Voorbeeld van Power Fx-formule:

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

Stijleigenschappen

Name Omschrijving
Theme Accepteert een JSON-tekenreeks die is gegenereerd met Ontwerper van Fluent UI Theme (windows.net). Als u dit leeg laat, wordt het standaardthema gebruikt dat door Power Apps is gedefinieerd. Zie Themagebruik voor richtlijnen voor configureren.
AccessibilityLabel Arialabel voor schermlezers
MaxDisplayedItems Het maximum aantal breadcrumbs dat mag worden weergegeven vóór samenvoeging. Indien nul, worden alle breadcrumbs weergegeven.
OverflowIndex Optionele index waar overloopitems worden samengevouwen. Deze waarde wordt standaard ingesteld op nul.

Eigenschappen van gebeurtenis

Name Omschrijving
InputEvent Een gebeurtenis waarnaar het besturingselement moet worden verzonden Bijvoorbeeld SetFocus. Zie hieronder.

Gedrag

Ondersteunt SetFocus als een InputEvent.

"OnSelect"-gedrag configureren

Gebruik de formule Switch() in de eigenschap OnSelect van het onderdeel om specifieke acties voor elk item te configureren door te verwijzen naar de geselecteerde ItemKey van het besturingselement als de schakelwaarde.

Vervang de false-waarden met geschikte expressies in de Power Fx-taal.

Omdat dit besturingselement wordt gebruikt voor navigatie, is het een logische actie om navigatiefuncties te gebruiken (idealiter naar een relevant scherm met de gerelateerde gegevens geladen).

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 1 */
    "1", false,
    
    /* Action for ItemKey 2 */
    "2", false,
  
    /* Default action */
        false
  )

Focus op het besturingselement instellen

Wanneer een nieuw dialoogvenster wordt weergegeven en de standaardfocus op het besturingselement moet liggen, is een expliciete ingestelde focus nodig.

Als u de input-gebeurtenis wilt aanroepen, kunt u een contextvariabele die aan de eigenschap Input Event is gebonden, instellen op een tekenreeks die begint met SetFocus en gevolgd door een willekeurig element om ervoor te zorgen dat de app het als een wijziging detecteert.

Voorbeeld van Power Fx-formule:

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

De contextvariabele ctxResizableTextareaEvent is dan gebonden aan de eigenschap InputEvent.

Beperkingen

Dit codeonderdeel kan alleen worden gebruikt in canvas-apps en aangepaste pagina's.