CSS: progress-circle

.instui-progress-circle · stable — En sirkulær fremdriftsring styrt av --value og --value-max egendefinerte egenskaper.

Ringen er en conic-gradient smultring malt på ::before og klippet med en radial-gradient-maske; --value delt på --value-max styrer buen. Legg til -should-animate og last inn interactions entry point for å animere den fra null ved mount. InstUI har ingen ubestemt (indeterminate) tilstand; :indeterminate er et pantoken-spesifikt beste gjetning (native <progress> uten et value-attributt), som spinner ringen med en fast bue og skjuler .value siden det ikke finnes noe meningsfylt tall å vise. <meter> har ingen ubestemt tilstand, så den påvirkes ikke.

Source: progress-circle.css

TIP

JS-forbedring — Denne komponentens CSS renderer og fungerer selvstendig; kombiner den med @pantoken/interactions for å legge til interaktiv oppførsel. Dens -should-animate modifikator styres av den oppførselen. Se modifier-tabellen nedenfor.

Tilgjengelighet

Bruk native <progress> for et null-basert fullføringsområde og <meter> når minimum ikke er null. Gi enten element et tilgjengelig navn ved å legge det inne i <label> eller assosiere en separat <label> gjennom samsvarende for og id verdier.

Bruk

@import "@pantoken/components/components.css";
@import "@pantoken/components/progress-circle.css";

Eksempler

Nested label

<label>
  Uploading Document: <progress class="instui-progress-circle -size-sm" value="70">70%</progress>
</label>

External label

<label for="score">Score</label>
<meter id="score" class="instui-progress-circle -color-success" min="20" value="40" max="60">50%</meter>

Struktur

// Variant: nested-label

label
  .instui-progress-circle
    .value

// Variant: external-label

label
.instui-progress-circle
  .value

flowchart TD subgraph sg0 ["nested-label"] n1["label"]:::cssdoc-root n2(".instui-progress-circle"):::cssdoc-part n3(".value"):::cssdoc-part end subgraph sg4 ["external-label"] n5["label"]:::cssdoc-root n6[".instui-progress-circle"]:::cssdoc-root n7(".value"):::cssdoc-part end n2 --> n3 n1 --> n2 n6 --> n7 classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Modifikatorer

Modifikator	Beskrivelse
.-color-brand	Farge for merke (brand) på måler.
.-color-danger	Farge for fare-måler.
.-color-info	Farge for informasjonsmåler.
.-color-primary-inverse	On-dark (primær invers) målerfarge.
.-color-success	Farge for suksess-måler.
.-color-warning	Farge for advarselsmåler.
.-meter-color-alert	Utdatert — use .-color-warning.
.-meter-color-brand	Utdatert — use .-color-brand.
.-meter-color-danger	Utdatert — use .-color-danger.
.-meter-color-info	Utdatert — use .-color-info.
.-meter-color-success	Utdatert — use .-color-success.
.-meter-color-warning	Utdatert — use .-color-warning.
.-shold-animate-on-mount	Alias — maps to .-should-animate.
.-should-animate	Interaction — Animate the meter, ring, and centered value into place on mount.
.-should-animate-on-mount	Alias — maps to .-should-animate.
.-size-large	Stor. Langformet alias for -size-lg.
.-size-lg	Stor.
.-size-md	Medium (standard).
.-size-medium	Medium (standard). Langform-alias for -size-md.
.-size-sm	Liten.
.-size-small	Liten. Langformet alias for -size-sm.
.-size-x-small	Ekstra liten. Langformet alias for -size-xs.
.-size-xs	Ekstra liten.

Deler

Del	Beskrivelse
.value	Verditeksten sentrert i ringens hull.

Pseudo-elementer

Pseudo-element	Beskrivelse
:::indeterminate	Egendefinert, ikke del av InstUI. Gjelder bare for en native <progress> som mangler sitt value-attributt; spinner ::before med en fast bue og skjuler .value.
::before	Tegner selve ringen: en conic-gradient-smultring klippet med en radial maske, hvis bue følger --value egenskapen.

Tilstander

Tilstand	Beskrivelse
:indeterminate	—

Egendefinerte egenskaper

Egenskap	Type	Standard	Beskrivelse
--animation-delay	<number>	—	Millisekunder å vente før start av mount-animasjonen (standard 0).
--max	<number>	—	Maksimal fremdriftsverdi (standard 100).
--min	<number>	—	Minimum målerverdi (standard 0).
--pantoken-pc-fill	<color>	—	Fargen på den fylte buen (måleren); -color-* modifikatorene setter den.
--pantoken-pc-stroke	<length>	—	Ringens strekbredde; -size-* modifikatorene setter den.
--pantoken-pc-track	<color>	—	Fargen på den utfylte banen.
--value	<number>	—	Den nåværende fremdriftsverdien; registrert med @property slik at den kan transitioneres.
--value-max	<number>	—	@alias {@link --max} Maksimal fremdriftsverdi (standard 100).
--value-now	<number>	—	@alias Alias for --value.

Animasjoner

Animasjon	Beskrivelse
pantoken-progress-circle-indeterminate	—

Forbrukte tokens

Token	Type	Verdi
--instui-component-progress-circle-color	<color>	LightDarklight-dark(#273540, #ffffff)
--instui-component-progress-circle-color-inverse	<color>	LightDarklight-dark(#ffffff, #1C222B)
--instui-component-progress-circle-font-family	[ <font-family-name> | <generic-font-family> ]#	Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-progress-circle-font-weight	<integer>	600
--instui-component-progress-circle-large-size	<length>	9em
--instui-component-progress-circle-large-stroke-width	<length>	0.875em
--instui-component-progress-circle-line-height	<percentage>	125%
--instui-component-progress-circle-medium-size	<length>	7em
--instui-component-progress-circle-medium-stroke-width	<length>	0.625em
--instui-component-progress-circle-meter-color-brand	<color>	LightDarklight-dark(#1D354F, #EEF4FD)
--instui-component-progress-circle-meter-color-brand-inverse	<color>	LightDarklight-dark(#ffffff, #6A7883)
--instui-component-progress-circle-meter-color-danger	<color>	#E62429
--instui-component-progress-circle-meter-color-danger-inverse	<color>	LightDarklight-dark(#ffffff, #6A7883)
--instui-component-progress-circle-meter-color-info	<color>	#2B7ABC
--instui-component-progress-circle-meter-color-info-inverse	<color>	LightDarklight-dark(#ffffff, #6A7883)
--instui-component-progress-circle-meter-color-success	<color>	#03893D
--instui-component-progress-circle-meter-color-success-inverse	<color>	LightDarklight-dark(#ffffff, #6A7883)
--instui-component-progress-circle-meter-color-warning	<color>	#CF4A00
--instui-component-progress-circle-meter-color-warning-inverse	<color>	LightDarklight-dark(#ffffff, #6A7883)
--instui-component-progress-circle-small-size	<length>	5em
--instui-component-progress-circle-small-stroke-width	<length>	0.5em
--instui-component-progress-circle-track-color	<color>	LightDarklight-dark(#ffffff, #10141A)
--instui-component-progress-circle-track-color-inverse	<color>	#00000000
--instui-component-progress-circle-x-small-size	<length>	3em
--instui-component-progress-circle-x-small-stroke-width	<length>	0.2em

Nettleserstøtte

• Registrerer de numeriske fremdriftsegenskapene med @property og maler med CSS mask og conic-gradient; der overganger på egendefinerte egenskaper ikke støttes, renderer ringen fortsatt men vil ikke animere.

Relatert

• progress — Den lineære stolpeformen av samme bestemte (determinate) fremdrift.