Skip to content

CSS: progress

.instui-progress · stable — Μια προσδιορισμένη γραμμή προόδου με έγχρωμο μετρητή, μεγέθη και προαιρετική ετικέτα τιμής.

.value είναι αδελφικό στοιχείο του .bar, και τα δύο παιδιά της ρίζας — αντικατοπτρίζοντας το πώς το progress-circle εμφωλεύει το δικό του μέρος .value. Το InstUI δεν έχει ακαθόριστη κατάσταση· το :indeterminate είναι μια εκτίμηση μόνο για pantoken (native <progress> χωρίς το χαρακτηριστικό value), που κινούμενο κάνει το .bar να λειτουργεί ως κινούμενο τμήμα και κρύβει το .value επειδή δεν υπάρχει ουσιαστικός αριθμός για εμφάνιση. Το <meter> δεν έχει ακαθόριστη κατάσταση, οπότε δεν επηρεάζεται.

Source: progress.css

Προσβασιμότητα

Χρησιμοποιήστε native <progress> για εύρος ολοκλήρωσης εργασίας που ξεκινάει από μηδέν και <meter> όταν το ελάχιστο δεν είναι μηδέν. Δώστε σε οποιοδήποτε από τα στοιχεία προσβάσιμη ονομασία, εμβάλλοντάς το μέσα σε <label> ή συνδέοντας ένα ξεχωριστό <label> μέσω ταιριαστών τιμών for και id.

Χρήση

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

Παραδείγματα

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>

Δομή

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

Τροποποιητές

ΤροποποιητήςΠεριγραφή
.-color-brandΧρώμα μετρητή για το brand.
.-color-dangerΧρώμα μετρητή κινδύνου.
.-color-infoΧρώμα πληροφοριακού μετρητή.
.-color-inverseΓια σκούρα φόντα.
.-color-primary-inverseΧρώμα μετρητή για σκούρο φόντο (primary inverse).
.-color-successΧρώμα μετρητή επιτυχίας.
.-color-warningΧρώμα μετρητή προειδοποίησης.
.-meter-color-alertΚαταργημένο — use .-color-warning.
.-meter-color-brandΚαταργημένο — use .-color-brand.
.-meter-color-dangerΚαταργημένο — use .-color-danger.
.-meter-color-infoΚαταργημένο — use .-color-info.
.-meter-color-successΚαταργημένο — use .-color-success.
.-meter-color-warningΚαταργημένο — use .-color-warning.
.-render-value-insideΑποδίδει το .value μέσα στην τροχιά, ευθυγραμμισμένο στην αρχή της, αντί δίπλα της· στιλ για ευαναγνωσιμότητα πάνω από το χρώμα του μετρητή.
.-should-animateInteraction — Animate meter changes over half a second.
.-size-largeΜεγάλο. Μακροσκελής συνώνυμο του -size-lg.
.-size-lgΜεγάλο.
.-size-mdΜεσαίο (προεπιλογή).
.-size-mediumΜεσαίο (προεπιλογή). Μακροσκελής ψευδωνυμία του -size-md.
.-size-smΜικρό.
.-size-smallΜικρό. Μακροσκελής συνώνυμο του -size-sm.
.-size-x-smallΕξαιρετικά μικρό. Μακροσκελής συνώνυμο του -size-xs.
.-size-xsΕξαιρετικά μικρό.

Μέρη

ΜέροςΠεριγραφή
.barΗ γεμισμένη μπάρα του μετρητή.
.valueΤο κείμενο της τιμής δίπλα στην μπάρα.

Ψευδοστοιχεία

ΨευδοστοιχείοΠεριγραφή
:::indeterminateΠροσαρμοσμένο, δεν ανήκει στο InstUI. Ισχύει μόνο για ένα native <progress> που του λείπει το χαρακτηριστικό value; κινούμενο κάνει το .bar να λειτουργεί ως κινούμενο τμήμα και κρύβει το .value.
::afterΣχεδιάζει τον κάτω κανόνα της τροχιάς ως ξεχωριστό στρώμα πάνω από τον μετρητή, έτσι ώστε το πλήρες περίγραμμα και το κάτω περίγραμμα να παραμένουν ανεξάρτητα ανά θέμα.

Καταστάσεις

ΚατάστασηΠεριγραφή
:indeterminate

Προσαρμοσμένες ιδιότητες

ΙδιότηταΤύποςΠροεπιλογήΠεριγραφή
--max<number>Η μέγιστη τιμή προόδου (προεπιλογή 100).
--min<number>Η ελάχιστη τιμή μετρητή (προεπιλογή 0).
--value<number>Η τρέχουσα τιμή προόδου.
--value-max<number>@alias {@link --max} Η μέγιστη τιμή προόδου (προεπιλογή 100).
--value-now<number>@alias Ψευδώνυμο για το --value.

Κινήσεις (animations)

ΚίνησηΠεριγραφή
pantoken-progress-indeterminate

Καταναλωμένα tokens

TokenΤύποςΤιμή
--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

Υποστήριξη προγράμματος περιήγησης

  • Περιορίζει τους κανόνες του μέρους μετρητή με το at-rule @scope; τα προγράμματα περιήγησης χωρίς υποστήριξη @scope αγνοούν αυτούς τους περιορισμένους κανόνες.

Σχετιζόμενα

  • progress-circle — Η κυκλική μορφή της ίδιας προσδιορισμένης προόδου.