CSS: form-field

.instui-form-field — Ένας περιέκτης πεδίου φόρμας: μία ετικέτα, οι έλεγχοι της και διάταξη inline, required ή readonly.

Ένα μήνυμα σφάλματος παραμένει κρυφό μέχρι ο έλεγχος του πεδίου να είναι :user-invalid (μετά την αλληλεπίδραση του χρήστη) ή να προσθέσετε την κλάση -invalid. Χρησιμοποιήστε -layout-inline για να τοποθετήσετε την ετικέτα δίπλα στους ελέγχους και -layout-stacked για να την τοποθετήσετε από πάνω. Επίσης ορίζει το δικό του gap ανάμεσα στην ετικέτα, τους ελέγχους και τα μηνύματα· η αλυσίδωση ενός -gap-* modifier διάστιξης υπερισχύει αυτής της ενσωματωμένης τιμής.

Source: form-field.css

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

Το στοιχείο <label> τυλίγει τον έλεγχο, έτσι το κείμενο της ετικέτας το ονομάζει εγγενώς· ο αστερίσκος που δείχνει ότι είναι απαραίτητο είναι διακοσμητικός και πρέπει να αποκρύπτεται από βοηθητικές τεχνολογίες (aria-hidden), και το μήνυμα σφάλματος εμφανίζεται μόλις ο έλεγχος είναι :user-invalid ή προσθέσετε την κλάση -invalid.

Χρήση

@import "@pantoken/components/components.css";
@import "@pantoken/components/form-field.css";

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

<label class="instui-form-field">
  <span class="label">Email address</span>
  <span class="controls"><input class="instui-text-input" type="email" placeholder="[email protected]"></span>
  <div class="instui-form-field-messages">
    <span class="instui-form-field-message -type-hint">We'll never share it.</span>
    <span class="instui-form-field-message -type-error">Enter a valid email address.</span>
  </div>
</label>

Δομή

.instui-form-field
  .label
  .controls
    text-input (component)
  form-field-messages (component)

flowchart TD n0[".instui-form-field"]:::cssdoc-root n1(".label"):::cssdoc-part n2(".controls"):::cssdoc-part n3(["text-input"]):::cssdoc-component n4(["form-field-messages"]):::cssdoc-component n0 --> n1 n2 --> n3 n0 --> n2 n0 --> n4 click n3 "/api/css/text-input.md" click n4 "/api/css/form-field-messages.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

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

Τροποποιητής	Περιγραφή
.-inline	Inline διάταξη (συντομογραφία για -layout-inline).
.-invalid	Μη έγκυρη (κατάσταση σφάλματος).
.-label-align-end	Στοίχιση κειμένου ετικέτας στο τέλος.
.-label-align-start	Στοίχιση κειμένου ετικέτας στην αρχή.
.-layout-inline	Inline διάταξη: ετικέτα δίπλα στους ελέγχους.
.-layout-stacked	Στοίχιση σε στήλη: ετικέτα πάνω από τους ελέγχους.
.-readonly	Κατάσταση μόνο για ανάγνωση.
.-v-align-bottom	Στοίχιση της ετικέτας στο κάτω μέρος σε σχέση με τους ελέγχους.
.-v-align-top	Στοίχιση της ετικέτας στο επάνω μέρος σε σχέση με τους ελέγχους.

Μέρη

Μέρος	Περιγραφή
.controls	Η περιοχή ελέγχου δίπλα ή κάτω από την ετικέτα.
.label	Η ετικέτα του πεδίου.

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

Ψευδοστοιχείο	Περιγραφή
::after	Αποδίδει τον διακοσμητικό αστερίσκο που δείχνει ότι το πεδίο είναι απαραίτητο μετά το κείμενο της ετικέτας όταν το πεδίο είναι required.

Καταστάσεις

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

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

Token	Τύπος	Τιμή
--instui-component-form-field-layout-asterisk-color	<color>	LightDarklight-dark(#CF1F24, #FA917F)
--instui-component-form-field-layout-font-family	[ <font-family-name> | <generic-font-family> ]#	Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-form-field-layout-font-size	<length>	1rem
--instui-component-form-field-layout-font-weight	<integer>	400
--instui-component-form-field-layout-gap-inputs	<length>	0.75rem
--instui-component-form-field-layout-gap-primitives	<length>	0.5rem
--instui-component-form-field-layout-line-height	<length>	1.125rem
--instui-component-form-field-layout-readonly-text-color	<color>	LightDarklight-dark(#576773, #AAB0B5)
--instui-component-form-field-layout-text-color	<color>	LightDarklight-dark(#273540, #ffffff)

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

• Περιέχει τα στυλ του στοιχείου με τον CSS @scope at-rule· χρειάζεται πρόσφατη έκδοση Chromium, Firefox ή Safari.

Υποσυστατικά

• form-field-messages
• text-input

Σχετιζόμενα

• form-field-messages — Αποδίδει τα μηνύματα υπόδειξης, σφάλματος και επιτυχίας του πεδίου.
• form-field-group — Ομαδοποιεί σχετικά πεδία υπό κοινή legend.