CSS: form-field ​

.instui-form-field — ֆորմայի դաշտի обթարկիչ՝ նշանը (label), նրա կառավարչական տարրերը և inline, required կամ readonly դասավորությունները։

Սխալի հաղորդագրությունը հանպատրաստվում է մինչև դաշտի կառավարչական տարրը դառնա :user-invalid (օգտատիրոջ փոխազդեցությունից հետո) կամ դուք ավելացնեք -invalid դասը։ Օգտագործեք -layout-inline՝ նշան(ը) տեղադրելու համար կառավարչական տարրերի կողքին և -layout-stacked՝ այն վերևում տեղադրելու համար։ Հայտնի արժեք է նաև իր սեփական gap նշանի, որը բաժանում է նշանը, կառավարչական տարրերը և հաղորդագրությունները; -gap-* spacing utility մոդիֆիկատորը միացրած դեպքում գրկում է այդ քանակը։

Source: form-field.css

Մուտքականություն ​

<label> տարրը包ակում է կառավարչական տարրը, այնպես որ նշանի տեքստը բնիկ կերպով անվանարկում է այն; պահանջվող աստղիկը զարդարական է և պետք է թաքցվի օգնական տեխնոլոգիաներից (aria-hidden), իսկ սխալի հաղորդագրությունը հայտնվում է երբ կառավարչական տարրը դառնում է :user-invalid կամ երբ ավելացվում է -invalid դասը։

Օգտագործում ​

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

Օրինակներ ​

html
<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>

Կառուցվածք ​

text
.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;

Մոդիֆիկատորներ ​

ՄոդիֆիկատորՆկարագիր
.-inlineInline դասավորություն (կարճ նամակ՝ -layout-inline).
.-invalidԱնվավեր (սխալ) վիճակ.
.-label-align-endՏեքստը հունիրով (end-align) ճշգրտել։
.-label-align-startՏեքստը սկսման կողմով (start-align) ճշգրտել։
.-layout-inlineInline դասավորություն՝ նշանը կառավարչական տարրերի կողքին։
.-layout-stackedԽրատված դասավորություն՝ նշանը կառավարչական տարրերի վերևում։
.-readonlyՄիակ ընթերցման (read-only) վիճակ.
.-v-align-bottomՏեղադրել նշանը կառավարիչ տարրերի հետ ստորին հավասարեցմամբ։
.-v-align-topՏեղադրել նշանը կառավարիչ տարրերի հետ վերին հավասարեցմամբ։

Մասեր ​

ՄասՆկարագիր
.controlsԿառավարչական տարածքը նշան(ի) կողքին կամ նրա տակ։
.labelԴաշտի նշանը (label)։

Պսևդո-էլեմենտներ ​

Պսևդո-էլեմենտՆկարագիր
::afterՑույց է տալիս զարդարական՝ պահանջվող դաշտի աստղիկը նշանի տեքստի ետևում, երբ դաշտը պարտադիր է։

Փոփոխական վիճակներ ​

ՎիճակՆկարագիր
:required—

Ցուցիչներ սպառված ​

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 — Տվյալ դաշտի խորհուրդը, սխալը և հաջողության հաղորդագրությունները արտապատկերում է։
  • form-field-group — Խմբագրում է կապված դաշտերը միասին՝ ընդհանուր legend-ով։