Spinner moderne kontrolelement i lærredsapps

Viser tilstanden i bevægelse, f.eks. indlæsning af en side eller tabel.

Beskrivelse

Brug det moderne kontrolelement Spinner til at få vist indlæsningsscenarier, hvor en handling er i gang. Kontrolelementet kommunikerer en ubestemt ventetid, og du viser eller skjuler den baseret på appens indlæsningstilstand. Nøgleegenskaberne for dette kontrolelement er Label, Appearance og LabelPosition.

Spinneren er et kontrolelement, der kun vises. Hvis du vil have status, som du kan måle som en procentdel, skal du bruge det moderne kontrolelement Statuslinje.

Bemærkning

I denne artikel beskrives det opdaterede moderne kontrolelement Spinner. Du kan få oplysninger om, hvad der er ændret fra den tidligere version, under Seneste opdateringer.

Generelt

Label – navnet ud for skalafeltet, f.eks "Loading records...". . Mærkatens slot modtager den formatering, der er relateret til den tekst, der er knyttet til skalafeltet.

AccessibleLabel – Mærkat, der læses af skærmlæsere. Når det ikke er angivet, bruger kontrolelementet værdien Label . Beskriv den igangværende handling, f.eks "Loading customer records". .

Visible – om kontrolelementet vises eller er skjult. Angiv denne egenskab til en boolesk værdi, der repræsenterer indlæsningstilstanden.

Adfærd

OnChange – handlinger, der skal udføres, når en egenskab for skalafeltet ændres.

DisplayMode – om kontrolelementet tillader brugerinput (Edit), kun viser data (View) eller er deaktiveret (Disabled). Skalafeltet accepterer ikke brugerinput, så denne egenskab påvirker primært udseendet af visualiseringen.

Størrelse og placering

LabelPosition – etikettens placering i forhold til skalafeltet. Accepterer optællingsværdier SpinnerLabelPosition : SpinnerLabelPosition.Before, SpinnerLabelPosition.After (standard), SpinnerLabelPosition.Aboveeller SpinnerLabelPosition.Below.

X – afstanden mellem kontrolelementets venstre kant og den venstre kant af den overordnede objektbeholder (skærm, hvis der ikke er nogen overordnet objektbeholder).

Y – afstanden mellem kontrolelementets øverste kant og den øverste kant af den overordnede objektbeholder (skærm, hvis der ikke er nogen overordnet objektbeholder).

Width – afstanden mellem kontrolelementets venstre og højre kant.

Height – afstanden mellem kontrolelementets øverste og nederste kant.

Typografi og tema

Udseende – udseendet af skalafeltet. Angiv som Primær (standard) for appens brandfarver eller Inverteret til brug på mørke baggrunde.

BasePaletteColor – den farvepalet, der anvendes på et kontrolelement. Denne egenskab påvirker alle kontrolelementets overflader, der gengiver en temafarve.

Font – navnet på den serie af skrifttyper, som etiketten vises i.

Size – skriftstørrelsen for navneteksten som et tal. Hvis værdien er null eller nul, styrer det valgte Fluent-tema skriftstørrelsen.

Color – farven på etiketteksten.

FontWeight – navnetekstens vægt. Accepterer optællingsværdier: , , FontWeight.SemiboldFontWeight.Normal (standard) eller FontWeight.Lighter. FontWeight.BoldFontWeight

Kursiv – om navneteksten vises med kursiv.

Understregning – om en linje vises under navneteksten.

Gennemstreget – om en linje vises via navneteksten.

Yderligere egenskaber

Værktøjstip – forklarende tekst, der vises, når brugeren holder markøren over kontrolelementet.

ContentLanguage – visningssproget for kontrolelementindholdet, hvis det er forskelligt fra appsproget.

Eksempel

I følgende YAML-eksempel vises en indlæsningsspinner med mærkaten placeret nedenfor:

- LoadingSpinner:
    Control: ModernSpinner@1.1.0
    Properties:
      Label: ="Loading customer records..."
      AccessibleLabel: ="Loading customer records"
      Size: =14
      LabelPosition: =SpinnerLabelPosition.Below
      Width: =400

Du binder typisk skalafeltets egenskab til en indlæsningsvariabel Visible , som du angiver før og efter en datahandling, så skalafeltet kun vises, mens arbejdet er i gang:

Set(varIsLoading, true);
ClearCollect(colCustomers, Customers);
Set(varIsLoading, false)

Seneste opdateringer

Den opdaterede version af det moderne kontrolelement Spinner indeholder følgende forbedringer og ændringer af funktionsmåden.

Omdøbninger af egenskaber

Følgende egenskaber omdøbes. Opdater alle formler i din app, der refererer til de gamle egenskabsnavne.

Forrige egenskab Ny egenskab
FontSize Size
FontColor Color
FontItalic Italic
FontUnderline Underline
FontStrikethrough Strikethrough

Fejlrettelser og forbedringer

  • Opdaterede optællinger: LabelPosition Bruger nu den angivne SpinnerLabelPosition optælling i stedet for strengværdier, hvilket forbedrer IntelliSense og reducerer formelfejl. FontWeight bruger optællingen FontWeight og Appearance accepterer de primære og inverterede værdier.
  • Understøttelse af værktøjstip: Ny Tooltip egenskab viser forklarende tekst, når der peges.
  • Ensartede skrifttypeegenskaber: Egenskaber for navneskrifttype er nu i overensstemmelse med andre moderne kontrolelementer. Brug Font, Size, ColorItalic, Underlineog Strikethrough.

Se også