Dela via

Breadcrumb kontroll

  • Artikel

En kontroll som används för navigering.

Kommentar

Fullständig dokumentation och källkod finns i lagringsplatsen för GitHub-kodkomponenter.

Breadcrumb-kontroll.

Description

Breadcrumb Kontrollerna ska användas som navigeringshjälp i appen eller på webbplatsen. De visar platsen för den aktuella sidan i en hierarki och hjälper användaren att förstå var de befinner sig i förhållande till den övriga hierarkin. Ett spår ger också åtkomst med en enda klickning till högre nivåer i den hierarkin.

Den här kodkomponenten fungerar som en adapter runt kontrollen Fluent UI-spår för användning i arbetsyteappar och på anpassade sidor.

Egenskaper

Nyckelegenskaper

Property Description
SelectedKey Detta anger att nyckeln är markerad. Detta uppdateras via OnChange-händelsen när användaren interagerar med kontrollen.
Items Åtgärdsobjekten som ska återges

Items Egenskaper

Varje enskilt objekt använder följande schema för att visualisera data i komponenten.

Name Description
ItemDisplayName Visningsnamn för spårobjektet
ItemKey Den tangent som ska användas för att ange vilket objekt som har markerats och när du lägger till underobjekt. Nycklarna måste vara unika.
ItemClickable Ange som falskt om det specifika spårobjektet inte kan klickas på.

Exempel Power Fx formel:

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

Stilegenskaper

Name Description
Theme Godkänner en JSON-sträng som genereras med Fluent UI temadesigner (windows.net). Om du lämnar detta tomt används standardstandarden som definieras av Power Apps. Se tema för vägledning om hur du konfigurerar.
AccessibilityLabel Aria-etikett för skärmläsare
MaxDisplayedItems Det maximala antalet spår att visa före sammanslagning. Om noll återges alla spår.
OverflowIndex Valfritt index där spillobjekt döljs. Som standard är inställningen noll.

Händelseegenskaper

Name Description
InputEvent En händelse att skicka till kontrollen. T.ex. SetFocus. Se nedan.

Funktionssätt

Stödjer SetFocus som en InputEvent.

Konfigurera funktionssättet "Vid val"

Använd formeln Switch() i komponentens OnSelect egenskap om du vill konfigurera specifika åtgärder för respektive objekt genom att hänvisa till kontrollens markerade ItemKey som växelvärde.

Ersätt false-värdena med lämpliga uttryck i Power Fx-språket.

Eftersom denna kontroll används för navigering används navigeringsfunktionerna (helst fören relevant skärm med relaterade data inlästa).

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

Ange fokus på kontrollen

När en ny dialog visas och standardfokus ska vara på kontrollen behövs en explicit uppsättning fokus.

För att göra anrop till indatahändelse kan du ställa in en kontextvariabel som är bunden till egenskapen Input Event till en sträng som börjar med SetFocus och följs av ett slumpmässigt element för att säkerställa att programmet upptäcker det som en förändring.

Exempel Power Fx formel:

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

Sammanhangsvariabeln ctxResizableTextareaEvent kan sedan vara bundna till egenskapen Input Event.

Begränsningar

Den här kodkomponenten kan endast användas i arbetsyteappar och anpassade sidor.