Skip to content

CSS: progress

.instui-progress · stabil — En determinerad förloppsindikator med en färgad mätare, olika storlekar och en valfri värdetext.

.value är en syskon till .bar, båda barn till roten — vilket speglar hur progress-circle nästlar sin egen .value-del. InstUI har inget indeterminerat läge; :indeterminate är en pantoken-endast bästa gissning (nativt <progress> utan ett value-attribut), som animerar .bar som ett glidande segment och döljer .value eftersom det inte finns något meningsfullt nummer att visa. <meter> har inget indeterminerat läge, så det påverkas inte.

Source: progress.css

Tillgänglighet

Använd det inbyggda <progress>-elementet för ett nollbaserat intervall för uppgiftens slutförande och <meter> när minimum inte är noll. Ge något av elementen ett åtkomligt namn genom att nästla det i en <label> eller genom att associera en separat <label> med matchande for- och id-värden.

Användning

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

Exempel

Nested label

html
<label>
  Uploading Document: <progress class="instui-progress -color-brand" value="70">70%</progress>
</label>

External label

html
<label for="storage-used">Storage used</label>
<meter id="storage-used" class="instui-progress -color-warning" min="20" value="40" max="60">50%</meter>

Struktur

// Variant: nested-label

text
label
  .instui-progress
    .bar
    .value

// Variant: external-label

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

Modifierare

ModifierareBeskrivning
.-color-brandVarumärkesmätarens färg.
.-color-dangerFärg för faromätaren.
.-color-infoFärg för informationsmätare.
.-color-inverseFör mörka bakgrunder.
.-color-primary-inverseMätarfärg på mörk bakgrund (primär invers)
.-color-successFärg för framgångsmätaren.
.-color-warningVarningsmätarens färg.
.-meter-color-alertFöråldrad — use .-color-warning.
.-meter-color-brandFöråldrad — use .-color-brand.
.-meter-color-dangerFöråldrad — use .-color-danger.
.-meter-color-infoFöråldrad — use .-color-info.
.-meter-color-successFöråldrad — use .-color-success.
.-meter-color-warningFöråldrad — use .-color-warning.
.-render-value-insideRenderar .value inuti spåret, justerat till dess början, istället för bredvid det; styla det för läsbarhet ovanpå mätarens färg.
.-should-animateInteraction — Animate meter changes over half a second.
.-size-largeStor. Långformigt alias för -size-lg.
.-size-lgStor.
.-size-mdMedium (standard).
.-size-mediumMedium (standard). Långformigt alias för -size-md.
.-size-smLiten.
.-size-smallLiten. Långformigt alias för -size-sm.
.-size-x-smallExtra liten. Långformigt alias för -size-xs.
.-size-xsExtra liten.

Delar

DelBeskrivning
.barDen ifyllda mätarlisten.
.valueVärdetexten bredvid listen.

Pseudo-element

Pseudo-elementBeskrivning
:::indeterminateAnpassad, inte en del av InstUI. Gäller endast en nativ <progress> som saknar sitt value-attribut; animerar .bar som ett glidande segment och döljer .value.
::afterRitar spårets nedre regel som ett eget lager ovanpå mätaren, så att hela kanten och den nedre kanten förblir oberoende över teman.

Tillstånd

TillståndBeskrivning
:indeterminate

Anpassade egenskaper

EgenskapTypStandardBeskrivning
--max<number>Det maximala framstegsvärdet (standard 100).
--min<number>Det minsta mätarvärdet (standard 0).
--value<number>Det aktuella framstegsvärdet.
--value-max<number>@alias {@link --max} Det maximala framstegsvärdet (standard 100).
--value-now<number>@alias Alias för --value.

Animeringar

AnimationBeskrivning
pantoken-progress-indeterminate

Förbrukade tokens

TokenTypVärde
--instui-color-background-brand<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-color-background-error<color>#E62429
--instui-color-background-info<color>#2B7ABC
--instui-color-background-success<color>#03893D
--instui-color-background-warning<color>#CF4A00
--instui-component-progress-bar-border-color<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-component-progress-bar-border-color-inverse<color>LightDarklight-dark(#ffffff, #6A7883)
--instui-component-progress-bar-border-radius<length>0.5rem
--instui-component-progress-bar-font-family[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-progress-bar-font-weight<integer>400
--instui-component-progress-bar-large-height<length>2rem
--instui-component-progress-bar-line-height<percentage>125%
--instui-component-progress-bar-medium-height<length>1.5rem
--instui-component-progress-bar-medium-value-font-size<length>1rem
--instui-component-progress-bar-meter-color-brand-inverse<color>LightDarklight-dark(#ffffff, #10141A)
--instui-component-progress-bar-small-height<length>1rem
--instui-component-progress-bar-text-color<color>LightDarklight-dark(#576773, #AAB0B5)
--instui-component-progress-bar-text-color-inverse<color>LightDarklight-dark(#ffffff, #1C222B)
--instui-component-progress-bar-track-bottom-border-color<color>#00000000
--instui-component-progress-bar-track-bottom-border-color-inverse<color>#00000000
--instui-component-progress-bar-track-bottom-border-width<length>0.0625rem
--instui-component-progress-bar-track-color<color>#00000000
--instui-component-progress-bar-track-color-inverse<color>#00000000
--instui-component-progress-bar-value-padding<length>0.5rem
--instui-component-progress-bar-x-small-height<length>0.5rem

Webbläsarstöd

  • Begränsar mätardelens regler med at-regeln @scope; webbläsare utan stöd för @scope ignorerar dessa begränsade regler.

Relaterat