Enghreifftiau a chanllawiau defnyddio ar gyfer arddulliau rheoli ffurflenni, opsiynau cynllun, a chydrannau arfer ar gyfer creu amrywiaeth eang o ffurfiau.
Trosolwg
Mae rheolyddion ffurflenni Bootstrap yn ehangu ar ein harddulliau ffurflen wedi'u hailgychwyn gyda dosbarthiadau. Defnyddiwch y dosbarthiadau hyn i optio i mewn i'w harddangosfeydd wedi'u teilwra i gael rendro mwy cyson ar draws porwyr a dyfeisiau.
Gwnewch yn siŵr eich bod yn defnyddio typepriodoledd priodol ar bob mewnbwn (ee, emailar gyfer cyfeiriad e-bost neu numberar gyfer gwybodaeth rifiadol) i fanteisio ar reolaethau mewnbwn mwy newydd fel dilysu e-bost, dewis rhif, a mwy.
Dyma enghraifft gyflym i ddangos arddulliau ffurf Bootstrap. Parhewch i ddarllen am ddogfennaeth ar ddosbarthiadau gofynnol, cynllun y ffurflen, a mwy.
Rheolaethau ffurf
Mae rheolyddion ffurf destunol - fel <input>s, <select>s, ac <textarea>s - wedi'u steilio gyda'r .form-controldosbarth. Yn gynwysedig mae arddulliau ar gyfer ymddangosiad cyffredinol, cyflwr ffocws, maint, a mwy.
Byddwch yn siwr i archwilio ein ffurflenni arferiad i ymhellach arddull <select>s.
Ar gyfer mewnbynnau ffeil, cyfnewidiwch .form-controlam .form-control-file.
Maintioli
Gosodwch uchder gan ddefnyddio dosbarthiadau fel .form-control-lga .form-control-sm.
Darllen yn unig
Ychwanegwch y readonlypriodoledd boolean ar fewnbwn i atal newid gwerth y mewnbwn. Mae mewnbynnau darllen yn unig yn ymddangos yn ysgafnach (yn union fel mewnbynnau anabl), ond yn cadw'r cyrchwr safonol.
Testun plaen darllen yn unig
Os ydych chi am gael <input readonly>elfennau yn eich ffurflen wedi'u steilio fel testun plaen, defnyddiwch y .form-control-plaintextdosbarth i dynnu'r arddull maes ffurf ddiofyn a chadw'r ymyl a'r padin cywir.
Ystod Mewnbynnau
Gosod mewnbynnau amrediad y gellir eu sgrolio'n llorweddol gan ddefnyddio .form-control-range.
Blychau siec a radios
Mae blychau ticio a radios rhagosodedig yn cael eu gwella gyda chymorth .form-check, dosbarth unigol ar gyfer y ddau fath mewnbwn sy'n gwella gosodiad ac ymddygiad eu helfennau HTML . Mae blychau ticio ar gyfer dewis un neu sawl opsiwn mewn rhestr, tra bod setiau radio ar gyfer dewis un opsiwn o blith llawer.
Cefnogir blychau ticio a radios anabl , ond i ddarparu not-allowedcyrchwr ar hofran y rhiant <label>, bydd angen i chi ychwanegu'r disabledpriodoledd i'r .form-check-input. Bydd y briodwedd anabl yn defnyddio lliw ysgafnach i helpu i nodi cyflwr y mewnbwn.
Mae blychau ticio a radios yn cael eu hadeiladu i gefnogi dilysu ffurflenni HTML a darparu labeli cryno, hygyrch. Fel y cyfryw, mae ein <input>s ac <label>s yn elfennau brodyr a chwiorydd yn hytrach nag o <input>fewn <label>. Mae hyn ychydig yn fwy ar lafar gan fod yn rhaid i chi nodi ida forphriodoleddau i gysylltu'r <input>a <label>.
Rhagosodedig (wedi'i bentyrru)
Yn ddiofyn, bydd unrhyw nifer o flychau ticio a radios sy'n frawd neu chwaer uniongyrchol yn cael eu pentyrru'n fertigol a'u gosod mewn gofod priodol gyda .form-check.
Mewn llinell
Grwpiwch flychau ticio neu radios ar yr un rhes lorweddol trwy ychwanegu .form-check-inlineat unrhyw .form-check.
Heb labeli
Ychwanegu .position-staticat fewnbynnau .form-checknad oes ganddynt unrhyw destun label. Cofiwch barhau i ddarparu rhyw fath o label ar gyfer technolegau cynorthwyol (er enghraifft, defnyddio aria-label).
Gosodiad
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.
Ffurfiwch grwpiau
Y .form-groupdosbarth yw'r ffordd hawsaf o ychwanegu rhywfaint o strwythur at ffurflenni. Mae'n darparu dosbarth hyblyg sy'n annog grwpio cywir o labeli, rheolyddion, testun cymorth dewisol, a negeseuon dilysu ffurf. Yn ddiofyn dim ond yn berthnasol margin-bottom, ond mae'n codi arddulliau ychwanegol yn ôl yr .form-inlineangen. Defnyddiwch ef gydag <fieldset>s, <div>s, neu bron unrhyw elfen arall.
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.
Ffurf rhes
Gallwch hefyd gyfnewid .rowam .form-row, amrywiad o'n rhes grid safonol sy'n diystyru'r cwteri colofn rhagosodedig am gynlluniau tynnach a mwy cryno.
Gellir creu cynlluniau mwy cymhleth hefyd gyda'r system grid.
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.
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.
Maint colofn
Fel y dangoswyd yn yr enghreifftiau blaenorol, mae ein system grid yn caniatáu ichi osod unrhyw nifer o .cols o fewn a .rowneu .form-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-7.
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.
Yna gallwch chi ailgymysgu hynny unwaith eto gyda dosbarthiadau colofn maint-benodol.
Defnyddiwch y .form-inlinedosbarth i arddangos cyfres o labeli, rheolyddion ffurf, a botymau ar un rhes lorweddol. Mae rheolaethau ffurf o fewn ffurflenni mewnol yn amrywio ychydig o'u cyflyrau rhagosodedig.
Rheolyddion yw display: flex, dymchwel unrhyw ofod gwyn HTML a'ch galluogi i ddarparu rheolaeth aliniad gyda bylchau a chyfleustodau flexbox .
Mae rheolyddion a grwpiau mewnbwn yn derbyn width: autoi ddiystyru'r rhagosodiad Bootstrap width: 100%.
Dim ond mewn pyrth gwylio sydd o leiaf 576px o led y mae rheolyddion yn ymddangos mewn llinell i gyfrif am olygfannau cul ar ddyfeisiau symudol.
Mae'n bosibl y bydd angen i chi fynd i'r afael â lled ac aliniad rheolyddion ffurflenni unigol â chyfleustodau bylchu (fel y dangosir isod). Yn olaf, gwnewch yn siŵr eich bod bob amser yn cynnwys rheolydd <label>gyda phob ffurflen, hyd yn oed os oes angen i chi ei guddio rhag ymwelwyr nad ydynt yn darllen sgrin gyda .sr-only.
Mae rheolaethau a dewisiadau ffurf personol hefyd yn cael eu cefnogi.
Dewisiadau eraill yn lle labeli cudd
Bydd technolegau cynorthwyol megis darllenwyr sgrin yn cael trafferth gyda'ch ffurflenni os na fyddwch yn cynnwys label ar gyfer pob mewnbwn. Ar gyfer y ffurflenni mewnol hyn, gallwch guddio'r labeli gan ddefnyddio'r .sr-onlydosbarth. Mae yna ddulliau amgen pellach o ddarparu label ar gyfer technolegau cynorthwyol, megis y aria-label, aria-labelledbyneu titlebriodoledd. Os nad oes un o'r rhain yn bresennol, gall technolegau cynorthwyol droi at ddefnyddio'r placeholdernodwedd, os yw'n bresennol, ond sylwer placeholderna chynghorir defnyddio yn lle dulliau labelu eraill.
Testun cymorth
Gellir creu testun cymorth lefel bloc mewn ffurflenni gan ddefnyddio .form-text(a elwid gynt .help-blockyn v3). Gellir gweithredu testun cymorth mewnol yn hyblyg gan ddefnyddio unrhyw elfen HTML mewnol a dosbarthiadau cyfleustodau fel .text-muted.
Cysylltu testun cymorth â rheolyddion ffurflen
Dylai testun cymorth gael ei gysylltu'n benodol â'r rheolaeth ffurf y mae'n ymwneud â defnyddio'r aria-describedbypriodoledd. Bydd hyn yn sicrhau bod technolegau cynorthwyol - megis darllenwyr sgrin - yn cyhoeddi'r testun cymorth hwn pan fydd y defnyddiwr yn canolbwyntio neu'n mynd i mewn i'r rheolydd.
Gellir steilio testun cymorth o dan y mewnbynnau gyda .form-text. Mae'r dosbarth hwn yn cynnwys display: blockac yn ychwanegu rhywfaint o ymyl uchaf i'w wahanu'n hawdd o'r mewnbynnau uchod.
Rhaid i'ch cyfrinair fod yn 8-20 nod o hyd, yn cynnwys llythrennau a rhifau, ac ni ddylai gynnwys bylchau, nodau arbennig nac emoji.
Gall testun mewnol ddefnyddio unrhyw elfen HTML mewnlin nodweddiadol (boed yn <small>, <span>, neu rywbeth arall) heb ddim mwy na dosbarth cyfleustodau.
Ffurflenni anabl
Ychwanegwch y disabledpriodoledd boolean ar fewnbwn i atal rhyngweithiadau defnyddwyr a gwneud iddo ymddangos yn ysgafnach.
Ychwanegwch y disabledpriodoledd i a <fieldset>i analluogi'r holl reolaethau o fewn.
Cafeat ag angorau
Yn ddiofyn, bydd porwyr yn trin pob rheolydd ffurf frodorol ( <input>, <select>ac <button>elfennau ) y tu mewn i a <fieldset disabled>yn anabl, gan atal rhyngweithiadau bysellfwrdd a llygoden arnynt. Fodd bynnag, os yw eich ffurflen hefyd yn cynnwys <a ... class="btn btn-*">elfennau, dim ond arddull o pointer-events: none. Fel y nodwyd yn yr adran am gyflwr anabl ar gyfer botymau (ac yn benodol yn yr is-adran ar gyfer elfennau angori), nid yw'r eiddo CSS hwn wedi'i safoni eto ac nid yw'n cael ei gefnogi'n llawn yn Internet Explorer 10, ac ni fydd yn atal defnyddwyr bysellfwrdd rhag bod gallu ffocysu neu actifadu'r dolenni hyn. Felly i fod yn ddiogel, defnyddiwch JavaScript wedi'i deilwra i analluogi dolenni o'r fath.
Cydweddoldeb traws-borwr
Er y bydd Bootstrap yn cymhwyso'r arddulliau hyn ym mhob porwr, nid yw Internet Explorer 11 ac isod yn cefnogi'r disabledpriodoledd ar <fieldset>. Defnyddiwch JavaScript wedi'i deilwra i analluogi'r set maes yn y porwyr hyn.
Dilysu
Rhowch adborth gwerthfawr y gellir ei weithredu i'ch defnyddwyr gyda dilysiad ffurflen HTML5 - ar gael yn ein holl borwyr a gefnogir . Dewiswch o adborth dilysu rhagosodedig y porwr, neu gweithredwch negeseuon wedi'u teilwra gyda'n dosbarthiadau adeiledig a JavaScript cychwynnol.
Ar hyn o bryd rydym yn argymell defnyddio arddulliau dilysu wedi'u teilwra, gan nad yw negeseuon dilysu rhagosodedig porwr brodorol yn cael eu hamlygu'n gyson i dechnolegau cynorthwyol ym mhob porwr (yn fwyaf nodedig, Chrome ar bwrdd gwaith a symudol).
Sut mae'n gweithio
Dyma sut mae dilysu ffurflenni yn gweithio gyda Bootstrap:
Cymhwysir dilysiad ffurflen HTML trwy ddau ffug-ddosbarth CSS, :invalida :valid. Mae'n berthnasol i <input>, <select>, ac <textarea>elfennau.
Mae Bootstrap yn cwmpasu :invalidac :validarddulliau i ddosbarth rhiant .was-validated, fel arfer yn berthnasol i'r <form>. Fel arall, mae unrhyw faes gofynnol heb werth yn ymddangos fel un annilys ar lwyth tudalen. Fel hyn, gallwch ddewis pryd i'w actifadu (yn nodweddiadol ar ôl ceisio cyflwyno ffurflen).
I ailosod ymddangosiad y ffurflen (er enghraifft, yn achos cyflwyniadau ffurflen deinamig gan ddefnyddio AJAX), tynnwch y .was-validateddosbarth o'r <form>eto ar ôl ei chyflwyno.
Fel wrth gefn, .is-invalida .is-validgellir defnyddio dosbarthiadau yn lle'r ffug-ddosbarthiadau ar gyfer dilysu ochr y gweinydd . Nid oes angen .was-validateddosbarth rhiant arnynt.
Oherwydd cyfyngiadau ar sut mae CSS yn gweithio, ni allwn (ar hyn o bryd) gymhwyso arddulliau i a <label>sy'n dod cyn rheolaeth ffurflen yn y DOM heb gymorth JavaScript arferol.
Mae pob porwr modern yn cefnogi'r API dilysu cyfyngiad , cyfres o ddulliau JavaScript ar gyfer dilysu rheolaethau ffurflen.
Gall negeseuon adborth ddefnyddio rhagosodiadau'r porwr (gwahanol ar gyfer pob porwr, ac anstyl trwy CSS) neu ein harddulliau adborth personol gyda HTML a CSS ychwanegol.
Gallwch ddarparu negeseuon dilysrwydd personol gyda setCustomValidityyn JavaScript.
Gyda hynny mewn golwg, ystyriwch y demos canlynol ar gyfer ein harddulliau dilysu ffurflenni arferol, dosbarthiadau ochr gweinydd dewisol, a rhagosodiadau porwr.
Arddulliau personol
Ar gyfer negeseuon dilysu ffurflen Bootstrap wedi'u teilwra, bydd angen i chi ychwanegu'r novalidatepriodoledd boolean at eich <form>. Mae hyn yn analluogi awgrymiadau cymorth adborth rhagosodedig y porwr, ond mae'n dal i ddarparu mynediad i'r APIs dilysu ffurflenni yn JavaScript. Ceisiwch gyflwyno'r ffurflen isod; bydd ein JavaScript yn rhyng-gipio'r botwm cyflwyno ac yn trosglwyddo adborth i chi.
Wrth geisio cyflwyno, byddwch yn gweld yr arddulliau :invalida'r :validarddulliau a ddefnyddir i reolaethau eich ffurflen.
Rhagosodiadau porwr
Dim diddordeb mewn negeseuon adborth dilysu personol neu ysgrifennu JavaScript i newid ymddygiadau ffurf? Da iawn, gallwch ddefnyddio rhagosodiadau'r porwr. Ceisiwch gyflwyno'r ffurflen isod. Yn dibynnu ar eich porwr ac OS, fe welwch arddull adborth ychydig yn wahanol.
Er na ellir steilio'r arddulliau adborth hyn gyda CSS, gallwch barhau i addasu'r testun adborth trwy JavaScript.
Ochr y gweinydd
Rydym yn argymell defnyddio dilysiad ochr y cleient, ond rhag ofn bod angen ochr y gweinydd arnoch, gallwch nodi meysydd ffurflen annilys a dilys gyda .is-invalida .is-valid. Sylwch fod .invalid-feedbacky dosbarthiadau hyn hefyd yn cael eu cefnogi.
Elfennau a gefnogir
Mae ein ffurflenni enghreifftiol yn dangos testunol brodorol <input>s uchod, ond mae arddulliau dilysu ffurflenni ar gael ar gyfer ein rheolaethau ffurflen arferol hefyd.
Cynghorion offer
Os yw cynllun eich ffurflen yn caniatáu hynny, gallwch gyfnewid y .{valid|invalid}-feedbackdosbarthiadau am .{valid|invalid}-tooltipddosbarthiadau i ddangos adborth dilysu mewn cyngor ag arddull. Gwnewch yn siŵr bod gennych riant position: relativearno ar gyfer lleoli awgrymiadau cymorth. Yn yr enghraifft isod, mae gan ein dosbarthiadau colofn hwn eisoes, ond efallai y bydd angen gosodiad arall ar eich prosiect.
Ffurflenni personol
I gael hyd yn oed mwy o gysondeb o ran addasu a thrawsborwyr, defnyddiwch ein helfennau ffurflen gwbl arferol i ddisodli rhagosodiadau'r porwr. Maent wedi'u hadeiladu ar ben marcio semantig a hygyrch, felly maent yn amnewidiadau cadarn ar gyfer unrhyw reolaeth ddiofyn ar ffurf.
Blychau siec a radios
Mae pob blwch siec a radio wedi'i lapio mewn a <div>gyda brawd neu chwaer <span>i greu ein rheolaeth arferol ac ar <label>gyfer y testun cysylltiedig. Yn strwythurol, dyma'r un dull â'n dull rhagosodedig .form-check.
Rydyn ni'n defnyddio'r dewisydd brodyr a chwiorydd ( ~) ar gyfer ein holl <input>daleithiau - fel - i :checkedarddullio ein dangosydd ffurf arfer yn gywir. O'i gyfuno â'r .custom-control-labeldosbarth, gallwn hefyd arddullio'r testun ar gyfer pob eitem yn seiliedig ar y <input>cyflwr.
Rydym yn cuddio'r rhagosodiad <input>gyda'r opacityac yn defnyddio'r .custom-control-labeli adeiladu dangosydd ffurflen arferol newydd yn ei le gyda ::beforea ::after. Yn anffodus ni allwn adeiladu un wedi'i deilwra o'r unig un <input>oherwydd nid yw CSS's contentyn gweithio ar yr elfen honno.
Yn y taleithiau wedi'u gwirio, rydym yn defnyddio eiconau SVG wedi'u mewnosod base64 o Open Iconic . Mae hyn yn rhoi'r rheolaeth orau i ni ar gyfer steilio a lleoli ar draws porwyr a dyfeisiau.
Blychau ticio
Gall blychau ticio personol hefyd ddefnyddio'r :indeterminatedosbarth ffug pan gânt eu gosod â llaw trwy JavaScript (nid oes priodoledd HTML ar gael i'w nodi).
Os ydych chi'n defnyddio jQuery, dylai rhywbeth fel hyn fod yn ddigon:
Radios
Mewn llinell
Anabl
Gall blychau ticio personol a radios fod yn anabl hefyd. Ychwanegwch y disabledpriodoledd boolean i'r <input>a bydd y dangosydd arferiad a disgrifiad label yn cael eu steilio'n awtomatig.
Dewiswch ddewislen
<select>Dim ond dosbarth wedi'i deilwra sydd ei angen ar fwydlenni personol, i .custom-selectsbarduno'r arddulliau arferol. Mae arddulliau personol wedi'u cyfyngu i <select>ymddangosiad cychwynnol yr s ac ni allant addasu'r <option>s oherwydd cyfyngiadau porwr.
Gallwch hefyd ddewis o ddetholiadau bach a mawr wedi'u teilwra i gyd-fynd â'n mewnbynnau testun o faint tebyg.
Cefnogir y multiplenodwedd hefyd:
Fel y mae'r sizenodwedd:
Amrediad
Creu rheolyddion personol <input type="range">gyda .custom-range. Mae'r trac (y cefndir) a'r bawd (y gwerth) ill dau wedi'u steilio i ymddangos yr un fath ar draws porwyr. Gan mai dim ond IE a Firefox sy'n cefnogi “llenwi” eu trac o'r chwith neu'r dde o'r bawd fel modd i ddangos cynnydd yn weledol, nid ydym yn ei gefnogi ar hyn o bryd.
Mae gan fewnbynnau amrediad werthoedd ymhlyg ar gyfer — mina , yn y drefn honno. Gallwch nodi gwerthoedd newydd ar gyfer y rhai sy'n defnyddio'r a phriodoleddau.max0100minmax
Yn ddiofyn, mae amrediad yn mewnbynnu “snap” i werthoedd cyfanrif. I newid hyn, gallwch chi nodi stepgwerth. Yn yr enghraifft isod, rydym yn dyblu nifer y camau trwy ddefnyddio step="0.5".
Porwr ffeil
Y mewnbwn ffeil yw'r mwyaf gnarly o'r criw ac mae angen JavaScript ychwanegol os hoffech chi eu cysylltu â swyddogaeth Dewiswch ffeil ... a thestun enw ffeil dethol.
Rydyn ni'n cuddio'r ffeil rhagosodedig <input>trwy opacityac yn lle hynny'n steilio'r <label>. Mae'r botwm yn cael ei gynhyrchu a'i leoli gyda ::after. Yn olaf, rydym yn datgan widthac heightar y <input>gofod priodol ar gyfer cynnwys amgylchynol.
Cyfieithu neu addasu'r llinynnau
Defnyddir y :lang()ffug-ddosbarth i ganiatáu cyfieithu’r testun “Pori” i ieithoedd eraill. Diystyru neu ychwanegu cofnodion at y $custom-file-textnewidyn Sass gyda'r tag iaith perthnasol a llinynnau lleol. Gellir addasu'r llinynnau Saesneg yr un ffordd. Er enghraifft, dyma sut y gallai rhywun ychwanegu cyfieithiad Sbaeneg (cod iaith Sbaeneg yw es):
Dyma ar lang(es)waith ar y mewnbwn ffeil wedi'i deilwra ar gyfer cyfieithiad Sbaeneg:
Bydd angen i chi osod iaith eich dogfen (neu is-goeden ohoni) yn gywir er mwyn i'r testun cywir gael ei ddangos. Gellir gwneud hyn gan ddefnyddio'r priodoledd ar yr elfenlang<html> neu'r Content-Languagepennawd HTTP , ymhlith dulliau eraill.