CSS: form-field-group

.instui-form-field-group — Μια ομάδα <fieldset> με legend, διάταξη σε στήλη ή inline, και ρυθμιζόμενο διάκενο.

Καθορίζει το δικό του gap ανάμεσα στα πεδία, ρυθμιζόμενο με τους τροποποιητές -col-spacing-*/-row-spacing-* παρακάτω — προτιμήστε αυτούς αντί να αλυσσοποιείτε έναν γενικό τροποποιητή διάκενου -gap-*, που αντικαθιστά την ενσωματωμένη τιμή εξ ολοκλήρου.

Source: form-field-group.css

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

Αποδίδει ένα εγγενές <fieldset> με <legend>, έτσι ώστε το κείμενο του legend να ονοματοδοτεί ολόκληρη την ομάδα για βοηθητικές τεχνολογίες.

Χρήση

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

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

<fieldset class="instui-form-field-group -layout-columns -col-spacing-medium">
  <legend>Shipping address</legend>
  <label class="instui-form-field">
    <span class="label">First name</span>
    <span class="controls"><input class="instui-text-input"></span>
  </label>
  <label class="instui-form-field">
    <span class="label">Last name</span>
    <span class="controls"><input class="instui-text-input"></span>
  </label>
  <label class="instui-form-field">
    <span class="label">City</span>
    <span class="controls"><input class="instui-text-input"></span>
  </label>
  <label class="instui-form-field">
    <span class="label">State</span>
    <span class="controls">
      <select class="instui-simple-select">
        <option>CA</option>
        <option>NY</option>
        <option>TX</option>
      </select>
    </span>
  </label>
  <div class="instui-form-field-messages">
    <span class="instui-form-field-message -type-hint">All fields are used for delivery only.</span>
  </div>
</fieldset>

Δομή

.instui-form-field-group.-layout-columns.-col-spacing-medium
  legend
  form-field (component)
  form-field-messages (component)

flowchart TD n0[".instui-form-field-group.-layout-columns.-col-spacing-medium"]:::cssdoc-root n1("legend"):::cssdoc-part n2(["form-field"]):::cssdoc-component n3(["form-field-messages"]):::cssdoc-component n0 --> n1 n0 --> n2 n0 --> n3 click n2 "/api/css/form-field.md" click n3 "/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;

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

Τροποποιητής	Περιγραφή
.-col-spacing-large	Μεγάλο κενό στηλών.
.-col-spacing-medium	Μεσαίο κενό στηλών.
.-col-spacing-none	Κανένα κενό στηλών.
.-col-spacing-small	Μικρό κενό στηλών.
.-layout-aligned	Στοίχιση των παιδικών πεδίων σε κοινό πλέγμα.
.-layout-columns	Διάταξη των παιδικών πεδίων σε στήλες.
.-layout-inline	Διάταξη των παιδικών πεδίων inline, σε σειρά.
.-required	Σημειώνει την ομάδα ως απαιτούμενη.
.-row-spacing-large	Μεγάλο κενό γραμμών.
.-row-spacing-medium	Μεσαίο κενό γραμμών.
.-row-spacing-none	Κανένα κενό γραμμών.
.-row-spacing-small	Μικρό κενό γραμμών.
.-v-align-bottom	Κάτω στοίχιση των πεδίων.
.-v-align-middle	Μεσαία στοίχιση των πεδίων.
.-v-align-top	Πάνω στοίχιση των πεδίων.

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

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

Συνθήκες

Τύπος	Ερώτημα	Περιγραφή
supports	(grid-template-columns: subgrid)	—

Καταναλωμένα 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-text-color	<color>	LightDarklight-dark(#273540, #ffffff)
--instui-spacing-space-lg	<length>	1rem
--instui-spacing-space-md	<length>	0.75rem
--instui-spacing-space-sm	<length>	0.5rem

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

• Η λειτουργία -layout-aligned χρησιμοποιεί CSS subgrid πίσω από ένα φύλακα @supports; όπου το subgrid δεν υποστηρίζεται, τα πεδία επιστρέφουν στην δική τους στοιβαζόμενη διάταξη.

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

• form-field
• form-field-messages

Σχετιζόμενα

• form-field — Το μεμονωμένο πεδίο που επαναλαμβάνει αυτή η ομάδα.
• radio-input-group — Ομαδοποιεί εισόδους ραδιοφώνου κάτω από ένα legend.