CSS: progress

.instui-progress · stable — Bar kemajuan tertentu dengan meter berwarna, saiz, dan label nilai pilihan.

.value adalah adik-beradik kepada .bar, kedua-duanya anak kepada root — mencerminkan bagaimana progress-circle menyarang bahagian .value sendiri. InstUI tiada keadaan tak tentu; :indeterminate ialah anggaran terbaik khusus pantoken (native <progress> tanpa atribut value), menganimasikan .bar sebagai segmen gelongsor dan menyembunyikan .value kerana tiada nombor bermakna untuk dipaparkan. <meter> tiada keadaan tak tentu, jadi ia tidak terjejas.

Source: progress.css

Aksesibiliti

Gunakan <progress> natif untuk julat penyelesaian tugas berasaskan sifar dan <meter> apabila nilai minima bukan sifar. Beri nama boleh diakses kepada mana-mana elemen dengan menyarungkannya dalam <label> atau mengaitkan <label> berasingan melalui padanan nilai for dan id.

Penggunaan

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

Contoh

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;

Pemodifikasi

Pemodifikasi	Penerangan
.-color-brand	Warna meter jenama.
.-color-danger	Warna meter bahaya.
.-color-info	Warna meter maklumat.
.-color-inverse	Untuk latar gelap.
.-color-primary-inverse	Warna meter untuk latar gelap (invers utama).
.-color-success	Warna meter kejayaan.
.-color-warning	Warna meter amaran.
.-meter-color-alert	Usang — use .-color-warning.
.-meter-color-brand	Usang — use .-color-brand.
.-meter-color-danger	Usang — use .-color-danger.
.-meter-color-info	Usang — use .-color-info.
.-meter-color-success	Usang — use .-color-success.
.-meter-color-warning	Usang — use .-color-warning.
.-render-value-inside	Memaparkan .value di dalam trek, sejajar dengan permulaannya, bukan di sebelahnya; gayakan untuk keterbacaan di atas warna meter.
.-should-animate	Interaction — Animate meter changes over half a second.
.-size-large	Besar. Alias bentuk panjang bagi -size-lg.
.-size-lg	Besar.
.-size-md	Sederhana (lalai).
.-size-medium	Sederhana (lalai). Alih panjang untuk -size-md.
.-size-sm	Kecil.
.-size-small	Kecil. Alias bentuk panjang bagi -size-sm.
.-size-x-small	Sangat kecil. Alias bentuk panjang bagi -size-xs.
.-size-xs	Sangat kecil.

Bahagian

Bahagian	Penerangan
.bar	Bar meter yang terisi.
.value	Teks nilai di sebelah bar.

Pseudo-elemen

Pseudo-elemen	Penerangan
:::indeterminate	Tersuai, bukan sebahagian InstUI. Digunakan hanya pada native <progress> yang tiada atribut value; menganimasikan .bar sebagai segmen gelongsor dan menyembunyikan .value.
::after	Melukis garis bawah trek sebagai lapisan sendiri di atas meter, supaya sempadan penuh dan sempadan bawah kekal berasingan merentas tema.

Keadaan

Keadaan	Penerangan
:indeterminate	—

Hartanah tersuai

Sifat	Jenis	Lalai	Penerangan
--max	<number>	—	Nilai progres maksimum (lalai 100).
--min	<number>	—	Nilai meter minima (lalai 0).
--value	<number>	—	Nilai kemajuan semasa.
--value-max	<number>	—	@alias {@link --max} Nilai progres maksimum (lalai 100).
--value-now	<number>	—	@alias Alias untuk --value.

Animasi

Animasi	Penerangan
pantoken-progress-indeterminate	—

Token digunakan

Token	Jenis	Nilai
--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

Sokongan pelayar

• Melakukan skop peraturan bahagian meter dengan at-rule @scope; pelayar tanpa sokongan @scope mengabaikan peraturan berskop tersebut.

Berkaitan

• progress-circle — Bentuk bulat bagi kemajuan tertentu yang sama.