CSS: progress ​

.instui-progress · stable — Określony pasek postępu z kolorowym miernikiem, rozmiarami i opcjonalną etykietą wartości.

.value jest rodzeństwem .bar, oboje potomkami root — odzwierciedlając sposób, w jaki progress-circle zagnieżdża swoją część .value. InstUI nie ma stanu nieokreślonego; :indeterminate to jedynie najlepsze przypuszczenie pantoken (natywny <progress> bez atrybutu value), animujące .bar jako przesuwający się segment i ukrywające .value, ponieważ nie ma sensownej liczby do pokazania. <meter> nie ma stanu nieokreślonego, więc pozostaje niezmieniony.

Source: progress.css

Dostępność ​

Użyj natywnego <progress> dla zakresu ukończenia zadania zaczynającego się od zera, a <meter> gdy minimalna wartość jest różna od zera. Nadaj któremukolwiek elementowi nazwę dostępną, umieszczając go wewnątrz <label> lub kojarząc oddzielny <label> przez dopasowanie wartości for i id.

Użycie ​

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

Przykłady ​

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>

Struktura ​

// 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;

Modyfikatory ​

ModyfikatorOpis
.-color-brandKolor wskaźnika marki.
.-color-dangerKolor wskaźnika ostrzegawczego (danger).
.-color-infoKolor wskaźnika informacyjnego.
.-color-inverseDla ciemnych teł.
.-color-primary-inverseKolor wskaźnika na ciemnym tle (primary inverse).
.-color-successKolor wskaźnika sukcesu.
.-color-warningKolor wskaźnika ostrzeżenia.
.-meter-color-alertPrzestarzałe — use .-color-warning.
.-meter-color-brandPrzestarzałe — use .-color-brand.
.-meter-color-dangerPrzestarzałe — use .-color-danger.
.-meter-color-infoPrzestarzałe — use .-color-info.
.-meter-color-successPrzestarzałe — use .-color-success.
.-meter-color-warningPrzestarzałe — use .-color-warning.
.-render-value-insideRenderuje .value wewnątrz toru, wyrównany do jego początku, zamiast obok niego; ostyluj go tak, aby był czytelny na tle koloru miernika.
.-should-animateInteraction — Animate meter changes over half a second.
.-size-largeDuży. Pełna nazwa -size-lg.
.-size-lgDuży.
.-size-mdŚredni (domyślny).
.-size-mediumŚredni (domyślny). Długa aliasowa forma -size-md.
.-size-smMały.
.-size-smallMały. Pełna nazwa -size-sm.
.-size-x-smallBardzo mały. Pełna nazwa -size-xs.
.-size-xsBardzo mały.

Części ​

CzęśćOpis
.barWypełniony pasek miernika.
.valueTekst wartości obok paska.

Pseudo-elementy ​

Pseudo-elementOpis
:::indeterminateNiestandardowe, nie jest częścią InstUI. Dotyczy tylko natywnego <progress> pozbawionego atrybutu value; animuje .bar jako przesuwający się segment i ukrywa .value.
::afterRysuje dolną linię toru jako oddzielną warstwę nad miernikiem, dzięki czemu pełna obwódka i dolna obwódka pozostają niezależne w różnych motywach.

Stany ​

StanOpis
:indeterminate—

Własne właściwości ​

WłaściwośćTypDomyślnyOpis
--max<number>—Maksymalna wartość postępu (domyślnie 100).
--min<number>—Minimalna wartość wskaźnika (domyślnie 0).
--value<number>—Bieżąca wartość postępu.
--value-max<number>—@alias {@link --max} Maksymalna wartość postępu (domyślnie 100).
--value-now<number>—@alias Alias dla --value.

Animacje ​

AnimacjaOpis
pantoken-progress-indeterminate—

Zużyte tokeny ​

TokenTypWartość
--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

Wsparcie przeglądarek ​

  • Ogranicza reguły części miernika przy użyciu dyrektywy at-rule @scope; przeglądarki bez obsługi @scope ignorują te reguły o ograniczonym zasięgu.

Powiązane ​