Neidio i'r prif gynnwys Neidio i lywio dogfennau
Check
in English

Gosodiad

Rhowch rywfaint o strwythur i'ch ffurflenni - o fewnlin i lorweddol i weithrediadau grid arferol - gyda'n hopsiynau cynllun ffurflen.

Ffurflenni

Dylai pob grŵp o feysydd ffurf fyw mewn <form>elfen. Nid yw Bootstrap yn darparu unrhyw arddull rhagosodedig ar gyfer yr <form>elfen, ond mae rhai nodweddion porwr pwerus a ddarperir yn ddiofyn.

  • Newydd i ffurflenni porwr? Ystyriwch adolygu dogfennau'r ffurflen MDN i gael trosolwg a rhestr gyflawn o'r priodoleddau sydd ar gael.
  • <button>s o fewn <form>rhagosodiad i type="submit", felly ymdrechu i fod yn benodol a chynnwys type.

Gan fod Bootstrap yn berthnasol display: blockac width: 100%i bron bob un o'n rheolyddion ffurflenni, bydd ffurflenni yn pentyrru'n fertigol yn ddiofyn. Gellir defnyddio dosbarthiadau ychwanegol i amrywio'r gosodiad hwn ar sail per-fformiad.

Cyfleustodau

Cyfleustodau ymyl yw'r ffordd hawsaf o ychwanegu rhywfaint o strwythur at ffurflenni. Maent yn darparu grwpio sylfaenol o labeli, rheolyddion, testun ffurf dewisol, a negeseuon dilysu ffurf. Rydym yn argymell cadw at margin-bottomgyfleustodau, a defnyddio un cyfeiriad trwy gydol y ffurflen er cysondeb.

Mae croeso i chi adeiladu eich ffurflenni sut bynnag y dymunwch, gydag <fieldset>s, <div>s, neu bron unrhyw elfen arall.

html
<div class="mb-3">
  <label for="formGroupExampleInput" class="form-label">Example label</label>
  <input type="text" class="form-control" id="formGroupExampleInput" placeholder="Example input placeholder">
</div>
<div class="mb-3">
  <label for="formGroupExampleInput2" class="form-label">Another label</label>
  <input type="text" class="form-control" id="formGroupExampleInput2" placeholder="Another input placeholder">
</div>

Ffurf grid

Gellir adeiladu ffurflenni mwy cymhleth gan ddefnyddio ein dosbarthiadau grid. Defnyddiwch y rhain ar gyfer cynlluniau ffurf sy'n gofyn am sawl colofn, lled amrywiol, ac opsiynau alinio ychwanegol. Yn gofyn am $enable-grid-classesalluogi'r newidyn Sass (ymlaen yn ddiofyn).

html
<div class="row">
  <div class="col">
    <input type="text" class="form-control" placeholder="First name" aria-label="First name">
  </div>
  <div class="col">
    <input type="text" class="form-control" placeholder="Last name" aria-label="Last name">
  </div>
</div>

Gwteri

Trwy ychwanegu dosbarthiadau addasydd gwter , gallwch reoli lled y gwter i mewn yn ogystal â chyfeiriad y bloc. Mae hefyd yn ei gwneud yn ofynnol i'r $enable-grid-classesnewidyn Sass gael ei alluogi (ymlaen yn ddiofyn).

html
<div class="row g-3">
  <div class="col">
    <input type="text" class="form-control" placeholder="First name" aria-label="First name">
  </div>
  <div class="col">
    <input type="text" class="form-control" placeholder="Last name" aria-label="Last name">
  </div>
</div>

Gellir creu cynlluniau mwy cymhleth hefyd gyda'r system grid.

html
<form class="row g-3">
  <div class="col-md-6">
    <label for="inputEmail4" class="form-label">Email</label>
    <input type="email" class="form-control" id="inputEmail4">
  </div>
  <div class="col-md-6">
    <label for="inputPassword4" class="form-label">Password</label>
    <input type="password" class="form-control" id="inputPassword4">
  </div>
  <div class="col-12">
    <label for="inputAddress" class="form-label">Address</label>
    <input type="text" class="form-control" id="inputAddress" placeholder="1234 Main St">
  </div>
  <div class="col-12">
    <label for="inputAddress2" class="form-label">Address 2</label>
    <input type="text" class="form-control" id="inputAddress2" placeholder="Apartment, studio, or floor">
  </div>
  <div class="col-md-6">
    <label for="inputCity" class="form-label">City</label>
    <input type="text" class="form-control" id="inputCity">
  </div>
  <div class="col-md-4">
    <label for="inputState" class="form-label">State</label>
    <select id="inputState" class="form-select">
      <option selected>Choose...</option>
      <option>...</option>
    </select>
  </div>
  <div class="col-md-2">
    <label for="inputZip" class="form-label">Zip</label>
    <input type="text" class="form-control" id="inputZip">
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="gridCheck">
      <label class="form-check-label" for="gridCheck">
        Check me out
      </label>
    </div>
  </div>
  <div class="col-12">
    <button type="submit" class="btn btn-primary">Sign in</button>
  </div>
</form>

Ffurf llorweddol

Creu ffurfiau llorweddol gyda'r grid trwy ychwanegu'r .rowdosbarth i ffurfio grwpiau a defnyddio'r .col-*-*dosbarthiadau i nodi lled eich labeli a'ch rheolyddion. Gwnewch yn siŵr eich bod yn ychwanegu .col-form-labelat eich <label>s hefyd fel eu bod wedi'u canoli'n fertigol gyda'u rheolyddion ffurf cysylltiedig.

Ar adegau, efallai y bydd angen i chi ddefnyddio cyfleustodau ymyl neu padin i greu'r aliniad perffaith hwnnw sydd ei angen arnoch chi. Er enghraifft, rydym wedi dileu'r padding-topar ein label mewnbynnau radio pentyrru i alinio'r llinell sylfaen testun yn well.

Radios
html
<form>
  <div class="row mb-3">
    <label for="inputEmail3" class="col-sm-2 col-form-label">Email</label>
    <div class="col-sm-10">
      <input type="email" class="form-control" id="inputEmail3">
    </div>
  </div>
  <div class="row mb-3">
    <label for="inputPassword3" class="col-sm-2 col-form-label">Password</label>
    <div class="col-sm-10">
      <input type="password" class="form-control" id="inputPassword3">
    </div>
  </div>
  <fieldset class="row mb-3">
    <legend class="col-form-label col-sm-2 pt-0">Radios</legend>
    <div class="col-sm-10">
      <div class="form-check">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios1" value="option1" checked>
        <label class="form-check-label" for="gridRadios1">
          First radio
        </label>
      </div>
      <div class="form-check">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios2" value="option2">
        <label class="form-check-label" for="gridRadios2">
          Second radio
        </label>
      </div>
      <div class="form-check disabled">
        <input class="form-check-input" type="radio" name="gridRadios" id="gridRadios3" value="option3" disabled>
        <label class="form-check-label" for="gridRadios3">
          Third disabled radio
        </label>
      </div>
    </div>
  </fieldset>
  <div class="row mb-3">
    <div class="col-sm-10 offset-sm-2">
      <div class="form-check">
        <input class="form-check-input" type="checkbox" id="gridCheck1">
        <label class="form-check-label" for="gridCheck1">
          Example checkbox
        </label>
      </div>
    </div>
  </div>
  <button type="submit" class="btn btn-primary">Sign in</button>
</form>

Maint label ffurf llorweddol

Byddwch yn siwr i ddefnyddio .col-form-label-smneu .col-form-label-lgat eich <label>s neu <legend>au i ddilyn yn gywir maint .form-control-lga .form-control-sm.

html
<div class="row mb-3">
  <label for="colFormLabelSm" class="col-sm-2 col-form-label col-form-label-sm">Email</label>
  <div class="col-sm-10">
    <input type="email" class="form-control form-control-sm" id="colFormLabelSm" placeholder="col-form-label-sm">
  </div>
</div>
<div class="row mb-3">
  <label for="colFormLabel" class="col-sm-2 col-form-label">Email</label>
  <div class="col-sm-10">
    <input type="email" class="form-control" id="colFormLabel" placeholder="col-form-label">
  </div>
</div>
<div class="row">
  <label for="colFormLabelLg" class="col-sm-2 col-form-label col-form-label-lg">Email</label>
  <div class="col-sm-10">
    <input type="email" class="form-control form-control-lg" id="colFormLabelLg" placeholder="col-form-label-lg">
  </div>
</div>

Maint colofn

Fel y dangoswyd yn yr enghreifftiau blaenorol, mae ein system grid yn caniatáu ichi osod unrhyw nifer o .cols o fewn .row. Byddant yn rhannu'r lled sydd ar gael yn gyfartal rhyngddynt. Gallwch hefyd ddewis is-set o'ch colofnau i gymryd mwy neu lai o le, tra bod y .cols sy'n weddill yn rhannu'r gweddill yn gyfartal, gyda dosbarthiadau colofn penodol fel .col-sm-7.

html
<div class="row g-3">
  <div class="col-sm-7">
    <input type="text" class="form-control" placeholder="City" aria-label="City">
  </div>
  <div class="col-sm">
    <input type="text" class="form-control" placeholder="State" aria-label="State">
  </div>
  <div class="col-sm">
    <input type="text" class="form-control" placeholder="Zip" aria-label="Zip">
  </div>
</div>

Auto-sizing

Mae'r enghraifft isod yn defnyddio cyfleustodau flexbox i ganoli'r cynnwys yn fertigol a newidiadau .coliddo .col-autofel bod eich colofnau ond yn cymryd cymaint o le ag sydd ei angen. Mewn ffordd arall, mae maint y golofn ei hun yn seiliedig ar y cynnwys.

@
html
<form class="row gy-2 gx-3 align-items-center">
  <div class="col-auto">
    <label class="visually-hidden" for="autoSizingInput">Name</label>
    <input type="text" class="form-control" id="autoSizingInput" placeholder="Jane Doe">
  </div>
  <div class="col-auto">
    <label class="visually-hidden" for="autoSizingInputGroup">Username</label>
    <div class="input-group">
      <div class="input-group-text">@</div>
      <input type="text" class="form-control" id="autoSizingInputGroup" placeholder="Username">
    </div>
  </div>
  <div class="col-auto">
    <label class="visually-hidden" for="autoSizingSelect">Preference</label>
    <select class="form-select" id="autoSizingSelect">
      <option selected>Choose...</option>
      <option value="1">One</option>
      <option value="2">Two</option>
      <option value="3">Three</option>
    </select>
  </div>
  <div class="col-auto">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="autoSizingCheck">
      <label class="form-check-label" for="autoSizingCheck">
        Remember me
      </label>
    </div>
  </div>
  <div class="col-auto">
    <button type="submit" class="btn btn-primary">Submit</button>
  </div>
</form>

Yna gallwch chi ailgymysgu hynny unwaith eto gyda dosbarthiadau colofn maint-benodol.

@
html
<form class="row gx-3 gy-2 align-items-center">
  <div class="col-sm-3">
    <label class="visually-hidden" for="specificSizeInputName">Name</label>
    <input type="text" class="form-control" id="specificSizeInputName" placeholder="Jane Doe">
  </div>
  <div class="col-sm-3">
    <label class="visually-hidden" for="specificSizeInputGroupUsername">Username</label>
    <div class="input-group">
      <div class="input-group-text">@</div>
      <input type="text" class="form-control" id="specificSizeInputGroupUsername" placeholder="Username">
    </div>
  </div>
  <div class="col-sm-3">
    <label class="visually-hidden" for="specificSizeSelect">Preference</label>
    <select class="form-select" id="specificSizeSelect">
      <option selected>Choose...</option>
      <option value="1">One</option>
      <option value="2">Two</option>
      <option value="3">Three</option>
    </select>
  </div>
  <div class="col-auto">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="autoSizingCheck2">
      <label class="form-check-label" for="autoSizingCheck2">
        Remember me
      </label>
    </div>
  </div>
  <div class="col-auto">
    <button type="submit" class="btn btn-primary">Submit</button>
  </div>
</form>

Ffurflenni mewnol

Defnyddiwch y .row-cols-*dosbarthiadau i greu cynlluniau llorweddol ymatebol. Trwy ychwanegu dosbarthiadau addasydd gwteri , bydd gennym gwteri i gyfeiriadau llorweddol a fertigol. Ar fannau gwylio symudol cul, mae'r rhain yn .col-12helpu i bentyrru'r rheolyddion ffurflen a mwy. Mae'n .align-items-centeralinio'r elfennau ffurf i'r canol, gan wneud yr .form-checkaliniad yn iawn.

@
html
<form class="row row-cols-lg-auto g-3 align-items-center">
  <div class="col-12">
    <label class="visually-hidden" for="inlineFormInputGroupUsername">Username</label>
    <div class="input-group">
      <div class="input-group-text">@</div>
      <input type="text" class="form-control" id="inlineFormInputGroupUsername" placeholder="Username">
    </div>
  </div>

  <div class="col-12">
    <label class="visually-hidden" for="inlineFormSelectPref">Preference</label>
    <select class="form-select" id="inlineFormSelectPref">
      <option selected>Choose...</option>
      <option value="1">One</option>
      <option value="2">Two</option>
      <option value="3">Three</option>
    </select>
  </div>

  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" id="inlineFormCheck">
      <label class="form-check-label" for="inlineFormCheck">
        Remember me
      </label>
    </div>
  </div>

  <div class="col-12">
    <button type="submit" class="btn btn-primary">Submit</button>
  </div>
</form>