CSS: progress

.instui-progress · stabil — Eine determiniert arbeitende Fortschrittsanzeige mit gefärbtem Balken, Größen und optionalem Wert-Label.

.value ist ein Geschwister von .bar, beide Kinder der Wurzel — analog dazu, wie progress-circle seinen eigenen .value-Teil verschachtelt. InstUI kennt keinen unbestimmten Zustand; :indeterminate ist eine pantoken-eigene Schätzung (native <progress> ohne ein value-Attribut), animiert .bar als gleitendes Segment und versteckt .value, da es keine sinnvolle Zahl zum Anzeigen gibt. <meter> hat keinen unbestimmten Zustand und bleibt daher unbeeinflusst.

Source: progress.css

Barrierefreiheit

Verwenden Sie das native <progress> für einen nullbasierten Aufgabenabschlussbereich und <meter>, wenn der Minimalwert ungleich null ist. Geben Sie einem der beiden Elemente einen zugänglichen Namen, indem Sie es in ein <label> verschachteln oder ein separates <label> durch passende for- und id-Werte zuordnen.

Verwendung

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

Beispiele

Nested label

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

External label

<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

label
  .instui-progress
    .bar
    .value

// Variant: external-label

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;

Modifikatoren

Modifikator	Beschreibung
.-color-brand	Farbe der Markenanzeige.
.-color-danger	Farbe des Gefahrenmeters.
.-color-info	Farbe der Informationsanzeige.
.-color-inverse	Für dunkle Hintergründe.
.-color-primary-inverse	Farbe des Meters auf dunklem Hintergrund (primäres Invers).
.-color-success	Farbe des Erfolgsmessers.
.-color-warning	Farbe der Warnanzeige.
.-meter-color-alert	Veraltet — use .-color-warning.
.-meter-color-brand	Veraltet — use .-color-brand.
.-meter-color-danger	Veraltet — use .-color-danger.
.-meter-color-info	Veraltet — use .-color-info.
.-meter-color-success	Veraltet — use .-color-success.
.-meter-color-warning	Veraltet — use .-color-warning.
.-render-value-inside	Rendert .value innerhalb der Spur, am Anfang ausgerichtet, statt daneben; style es so, dass es über der Meter-Farbe gut lesbar ist.
.-should-animate	Interaction — Animate meter changes over half a second.
.-size-large	Groß. Langform-Alias von -size-lg.
.-size-lg	Groß.
.-size-md	Mittel (Standard).
.-size-medium	Medium (Standard). Langform-Alias von -size-md.
.-size-sm	Klein.
.-size-small	Klein. Langform-Alias von -size-sm.
.-size-x-small	Extra klein. Langform-Alias von -size-xs.
.-size-xs	Extra klein.

Teile

Teil	Beschreibung
.bar	Der gefüllte Meter-Balken.
.value	Der Wert-Text neben dem Balken.

Pseudo-Elemente

Pseudo-Element	Beschreibung
:::indeterminate	Benutzerdefiniert, nicht Teil von InstUI. Gilt nur für ein natives <progress>, dem das value-Attribut fehlt; animiert .bar als gleitendes Segment und versteckt .value.
::after	Zeichnet die untere Regel der Spur als eigene Ebene über dem Meter, sodass die vollständige Umrandung und die untere Umrandung über Themen hinweg unabhängig bleiben.

Zustände

Zustand	Beschreibung
:indeterminate	—

Benutzerdefinierte Eigenschaften

Eigenschaft	Typ	Standard	Beschreibung
--max	<number>	—	Der maximale Fortschrittswert (Standard 100).
--min	<number>	—	Der minimale Meterwert (Standard: 0).
--value	<number>	—	Der aktuelle Fortschrittswert.
--value-max	<number>	—	@alias {@link --max} Der maximale Fortschrittswert (Standard 100).
--value-now	<number>	—	@alias Alias für --value.

Animationen

Animation	Beschreibung
pantoken-progress-indeterminate	—

Verbrauchte Tokens

Token	Typ	Wert
--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

Browser-Unterstützung

• Bereichert die Regeln des Meter-Teils mit der @scope-At-Regel; Browser ohne @scope-Unterstützung ignorieren diese gekapselten Regeln.

Verwandt

• progress-circle — Die kreisförmige Variante derselben determinierten Fortschrittsanzeige.