general.html 29 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150
  1. ---
  2. title: Form controls
  3. layout: documentation
  4. doc-tab: form
  5. doc-subtab: general
  6. ---
  7. {% capture example %}
  8. <div class="field">
  9. <label class="label">Name</label>
  10. <div class="control">
  11. <input class="input" type="text" placeholder="Text input">
  12. </div>
  13. </div>
  14. <div class="field">
  15. <label class="label">Username</label>
  16. <div class="control has-icons-left has-icons-right">
  17. <input class="input is-success" type="text" placeholder="Text input" value="bulma">
  18. <span class="icon is-small is-left">
  19. <i class="fa fa-user"></i>
  20. </span>
  21. <span class="icon is-small is-right">
  22. <i class="fa fa-check"></i>
  23. </span>
  24. </div>
  25. <p class="help is-success">This username is available</p>
  26. </div>
  27. <div class="field">
  28. <label class="label">Email</label>
  29. <div class="control has-icons-left has-icons-right">
  30. <input class="input is-danger" type="text" placeholder="Email input" value="hello@">
  31. <span class="icon is-small is-left">
  32. <i class="fa fa-envelope"></i>
  33. </span>
  34. <span class="icon is-small is-right">
  35. <i class="fa fa-warning"></i>
  36. </span>
  37. </div>
  38. <p class="help is-danger">This email is invalid</p>
  39. </div>
  40. <div class="field">
  41. <label class="label">Subject</label>
  42. <div class="control">
  43. <div class="select">
  44. <select>
  45. <option>Select dropdown</option>
  46. <option>With options</option>
  47. </select>
  48. </div>
  49. </div>
  50. </div>
  51. <div class="field">
  52. <label class="label">Message</label>
  53. <div class="control">
  54. <textarea class="textarea" placeholder="Textarea"></textarea>
  55. </div>
  56. </div>
  57. <div class="field">
  58. <div class="control">
  59. <label class="checkbox">
  60. <input type="checkbox">
  61. I agree to the <a href="#">terms and conditions</a>
  62. </label>
  63. </div>
  64. </div>
  65. <div class="field">
  66. <div class="control">
  67. <label class="radio">
  68. <input type="radio" name="question">
  69. Yes
  70. </label>
  71. <label class="radio">
  72. <input type="radio" name="question">
  73. No
  74. </label>
  75. </div>
  76. </div>
  77. <div class="field is-grouped">
  78. <div class="control">
  79. <button class="button is-primary">Submit</button>
  80. </div>
  81. <div class="control">
  82. <button class="button is-link">Cancel</button>
  83. </div>
  84. </div>
  85. {% endcapture %}
  86. {% capture field_example %}
  87. <div class="field">
  88. <label class="label">Label</label>
  89. <div class="control">
  90. <input class="input" type="text" placeholder="Text input">
  91. </div>
  92. <p class="help">This is a help text</p>
  93. </div>
  94. {% endcapture %}
  95. {% capture fields_example %}
  96. <div class="field">
  97. <label class="label">Name</label>
  98. <div class="control">
  99. <input class="input" type="text" placeholder="e.g Alex Smith">
  100. </div>
  101. </div>
  102. <div class="field">
  103. <label class="label">Email</label>
  104. <div class="control">
  105. <input class="input" type="email" placeholder="e.g. alexsmith@gmail.com">
  106. </div>
  107. </div>
  108. {% endcapture %}
  109. {% capture control_input_example %}
  110. <div class="control">
  111. <input class="input" type="text" placeholder="Text input">
  112. </div>
  113. {% endcapture %}
  114. {% capture control_select_example %}
  115. <div class="control">
  116. <div class="select">
  117. <select>
  118. <option>Select dropdown</option>
  119. <option>With options</option>
  120. </select>
  121. </div>
  122. </div>
  123. {% endcapture %}
  124. {% capture control_button_example %}
  125. <div class="control">
  126. <button class="button is-primary">Submit</button>
  127. </div>
  128. {% endcapture %}
  129. {% capture icons_example %}
  130. <div class="field">
  131. <p class="control has-icons-left has-icons-right">
  132. <input class="input" type="email" placeholder="Email">
  133. <span class="icon is-small is-left">
  134. <i class="fa fa-envelope"></i>
  135. </span>
  136. <span class="icon is-small is-right">
  137. <i class="fa fa-check"></i>
  138. </span>
  139. </p>
  140. </div>
  141. <div class="field">
  142. <p class="control has-icons-left">
  143. <input class="input" type="password" placeholder="Password">
  144. <span class="icon is-small is-left">
  145. <i class="fa fa-lock"></i>
  146. </span>
  147. </p>
  148. </div>
  149. <div class="field">
  150. <p class="control">
  151. <button class="button is-success">
  152. Login
  153. </button>
  154. </p>
  155. </div>
  156. {% endcapture %}
  157. {% capture select_icons_example %}
  158. <div class="field">
  159. <p class="control has-icons-left">
  160. <span class="select">
  161. <select>
  162. <option selected>Country</option>
  163. <option>Select dropdown</option>
  164. <option>With options</option>
  165. </select>
  166. </span>
  167. <span class="icon is-small is-left">
  168. <i class="fa fa-globe"></i>
  169. </span>
  170. </p>
  171. </div>
  172. {% endcapture %}
  173. {% capture has_icons_small_example %}
  174. <div class="field">
  175. <label class="label is-small">Small input</label>
  176. <div class="control has-icons-left has-icons-right">
  177. <input class="input is-small" type="email" placeholder="Email">
  178. <span class="icon is-small is-left">
  179. <i class="fa fa-envelope"></i>
  180. </span>
  181. <span class="icon is-small is-right">
  182. <i class="fa fa-check"></i>
  183. </span>
  184. </div>
  185. </div>
  186. {% endcapture %}
  187. {% capture has_icons_normal_example %}
  188. <div class="field">
  189. <label class="label">Normal input</label>
  190. <div class="control has-icons-left has-icons-right">
  191. <input class="input" type="email" placeholder="Email">
  192. <span class="icon is-small is-left">
  193. <i class="fa fa-envelope"></i>
  194. </span>
  195. <span class="icon is-small is-right">
  196. <i class="fa fa-check"></i>
  197. </span>
  198. </div>
  199. </div>
  200. <div class="field">
  201. <div class="control has-icons-left has-icons-right">
  202. <input class="input" type="email" placeholder="Email">
  203. <span class="icon is-left">
  204. <i class="fa fa-envelope"></i>
  205. </span>
  206. <span class="icon is-right">
  207. <i class="fa fa-check"></i>
  208. </span>
  209. </div>
  210. </div>
  211. {% endcapture %}
  212. {% capture has_icons_medium_example %}
  213. <div class="field">
  214. <label class="label is-medium">Medium input</label>
  215. <div class="control has-icons-left has-icons-right">
  216. <input class="input is-medium" type="email" placeholder="Email">
  217. <span class="icon is-small is-left">
  218. <i class="fa fa-envelope"></i>
  219. </span>
  220. <span class="icon is-small is-right">
  221. <i class="fa fa-check"></i>
  222. </span>
  223. </div>
  224. </div>
  225. <div class="field">
  226. <div class="control has-icons-left has-icons-right">
  227. <input class="input is-medium" type="email" placeholder="Email">
  228. <span class="icon is-left">
  229. <i class="fa fa-envelope"></i>
  230. </span>
  231. <span class="icon is-right">
  232. <i class="fa fa-check"></i>
  233. </span>
  234. </div>
  235. </div>
  236. <div class="field">
  237. <div class="control has-icons-left has-icons-right">
  238. <input class="input is-medium" type="email" placeholder="Email">
  239. <span class="icon is-medium is-left">
  240. <i class="fa fa-envelope"></i>
  241. </span>
  242. <span class="icon is-medium is-right">
  243. <i class="fa fa-check"></i>
  244. </span>
  245. </div>
  246. </div>
  247. {% endcapture %}
  248. {% capture has_icons_large_example %}
  249. <div class="field">
  250. <label class="label is-large">Large input</label>
  251. <div class="control has-icons-left has-icons-right">
  252. <input class="input is-large" type="email" placeholder="Email">
  253. <span class="icon is-small is-left">
  254. <i class="fa fa-envelope"></i>
  255. </span>
  256. <span class="icon is-small is-right">
  257. <i class="fa fa-check"></i>
  258. </span>
  259. </div>
  260. </div>
  261. <div class="field">
  262. <div class="control has-icons-left has-icons-right">
  263. <input class="input is-large" type="email" placeholder="Email">
  264. <span class="icon is-left">
  265. <i class="fa fa-envelope"></i>
  266. </span>
  267. <span class="icon is-right">
  268. <i class="fa fa-check"></i>
  269. </span>
  270. </div>
  271. </div>
  272. <div class="field">
  273. <div class="control has-icons-left has-icons-right">
  274. <input class="input is-large" type="email" placeholder="Email">
  275. <span class="icon is-medium is-left">
  276. <i class="fa fa-envelope"></i>
  277. </span>
  278. <span class="icon is-medium is-right">
  279. <i class="fa fa-check"></i>
  280. </span>
  281. </div>
  282. </div>
  283. <div class="field">
  284. <div class="control has-icons-left has-icons-right">
  285. <input class="input is-large" type="email" placeholder="Email">
  286. <span class="icon is-large is-left">
  287. <i class="fa fa-envelope"></i>
  288. </span>
  289. <span class="icon is-large is-right">
  290. <i class="fa fa-check"></i>
  291. </span>
  292. </div>
  293. </div>
  294. {% endcapture %}
  295. {% capture addons_example %}
  296. <div class="field has-addons">
  297. <div class="control">
  298. <input class="input" type="text" placeholder="Find a repository">
  299. </div>
  300. <div class="control">
  301. <a class="button is-info">
  302. Search
  303. </a>
  304. </div>
  305. </div>
  306. {% endcapture %}
  307. {% capture addons_static_example %}
  308. <div class="field has-addons">
  309. <p class="control">
  310. <input class="input" type="text" placeholder="Your email">
  311. </p>
  312. <p class="control">
  313. <a class="button is-static">
  314. @gmail.com
  315. </a>
  316. </p>
  317. </div>
  318. {% endcapture %}
  319. {% capture addons_expanded_example %}
  320. <div class="field has-addons">
  321. <p class="control">
  322. <span class="select">
  323. <select>
  324. <option>$</option>
  325. <option>£</option>
  326. <option>€</option>
  327. </select>
  328. </span>
  329. </p>
  330. <p class="control">
  331. <input class="input" type="text" placeholder="Amount of money">
  332. </p>
  333. <p class="control">
  334. <a class="button">
  335. Transfer
  336. </a>
  337. </p>
  338. </div>
  339. <div class="field has-addons">
  340. <p class="control">
  341. <span class="select">
  342. <select>
  343. <option>$</option>
  344. <option>£</option>
  345. <option>€</option>
  346. </select>
  347. </span>
  348. </p>
  349. <p class="control is-expanded">
  350. <input class="input" type="text" placeholder="Amount of money">
  351. </p>
  352. <p class="control">
  353. <a class="button">
  354. Transfer
  355. </a>
  356. </p>
  357. </div>
  358. {% endcapture %}
  359. {% capture addons_expanded_fullwidth_example %}
  360. <div class="field has-addons">
  361. <div class="control is-expanded">
  362. <div class="select is-fullwidth">
  363. <select name="country">
  364. <option value="Argentina">Argentina</option>
  365. <option value="Bolivia">Bolivia</option>
  366. <option value="Brazil">Brazil</option>
  367. <option value="Chile">Chile</option>
  368. <option value="Colombia">Colombia</option>
  369. <option value="Ecuador">Ecuador</option>
  370. <option value="Guyana">Guyana</option>
  371. <option value="Paraguay">Paraguay</option>
  372. <option value="Peru">Peru</option>
  373. <option value="Suriname">Suriname</option>
  374. <option value="Uruguay">Uruguay</option>
  375. <option value="Venezuela">Venezuela</option>
  376. </select>
  377. </div>
  378. </div>
  379. <div class="control">
  380. <button type="submit" class="button is-primary">Choose</button>
  381. </div>
  382. </div>
  383. {% endcapture %}
  384. {% capture addons_center_example %}
  385. <div class="field has-addons has-addons-centered">
  386. <p class="control">
  387. <span class="select">
  388. <select>
  389. <option>$</option>
  390. <option>£</option>
  391. <option>€</option>
  392. </select>
  393. </span>
  394. </p>
  395. <p class="control">
  396. <input class="input" type="text" placeholder="Amount of money">
  397. </p>
  398. <p class="control">
  399. <a class="button is-primary">
  400. Transfer
  401. </a>
  402. </p>
  403. </div>
  404. {% endcapture %}
  405. {% capture addons_right_example %}
  406. <div class="field has-addons has-addons-right">
  407. <p class="control">
  408. <span class="select">
  409. <select>
  410. <option>$</option>
  411. <option>£</option>
  412. <option>€</option>
  413. </select>
  414. </span>
  415. </p>
  416. <p class="control">
  417. <input class="input" type="text" placeholder="Amount of money">
  418. </p>
  419. <p class="control">
  420. <a class="button is-primary">
  421. Transfer
  422. </a>
  423. </p>
  424. </div>
  425. {% endcapture %}
  426. {% capture group_example %}
  427. <div class="field is-grouped">
  428. <p class="control">
  429. <a class="button is-primary">
  430. Submit
  431. </a>
  432. </p>
  433. <p class="control">
  434. <a class="button is-light">
  435. Cancel
  436. </a>
  437. </p>
  438. </div>
  439. {% endcapture %}
  440. {% capture group_centered_example %}
  441. <div class="field is-grouped is-grouped-centered">
  442. <p class="control">
  443. <a class="button is-primary">
  444. Submit
  445. </a>
  446. </p>
  447. <p class="control">
  448. <a class="button is-light">
  449. Cancel
  450. </a>
  451. </p>
  452. </div>
  453. {% endcapture %}
  454. {% capture group_right_example %}
  455. <div class="field is-grouped is-grouped-right">
  456. <p class="control">
  457. <a class="button is-primary">
  458. Submit
  459. </a>
  460. </p>
  461. <p class="control">
  462. <a class="button is-light">
  463. Cancel
  464. </a>
  465. </p>
  466. </div>
  467. {% endcapture %}
  468. {% capture group_expanded_example %}
  469. <div class="field is-grouped">
  470. <p class="control is-expanded">
  471. <input class="input" type="text" placeholder="Find a repository">
  472. </p>
  473. <p class="control">
  474. <a class="button is-info">
  475. Search
  476. </a>
  477. </p>
  478. </div>
  479. {% endcapture %}
  480. {% capture group_multiline_example %}
  481. <div class="field is-grouped is-grouped-multiline">
  482. <p class="control">
  483. <a class="button">
  484. One
  485. </a>
  486. </p>
  487. <p class="control">
  488. <a class="button">
  489. Two
  490. </a>
  491. </p>
  492. <p class="control">
  493. <a class="button">
  494. Three
  495. </a>
  496. </p>
  497. <p class="control">
  498. <a class="button">
  499. Four
  500. </a>
  501. </p>
  502. <p class="control">
  503. <a class="button">
  504. Five
  505. </a>
  506. </p>
  507. <p class="control">
  508. <a class="button">
  509. Size
  510. </a>
  511. </p>
  512. <p class="control">
  513. <a class="button">
  514. Seven
  515. </a>
  516. </p>
  517. <p class="control">
  518. <a class="button">
  519. Eight
  520. </a>
  521. </p>
  522. <p class="control">
  523. <a class="button">
  524. Nine
  525. </a>
  526. </p>
  527. <p class="control">
  528. <a class="button">
  529. Ten
  530. </a>
  531. </p>
  532. <p class="control">
  533. <a class="button">
  534. Eleven
  535. </a>
  536. </p>
  537. <p class="control">
  538. <a class="button">
  539. Twelve
  540. </a>
  541. </p>
  542. <p class="control">
  543. <a class="button">
  544. Thirteen
  545. </a>
  546. </p>
  547. </div>
  548. {% endcapture %}
  549. {% capture horizontal_form_example %}
  550. <div class="field is-horizontal">
  551. <div class="field-label is-normal">
  552. <label class="label">From</label>
  553. </div>
  554. <div class="field-body">
  555. <div class="field">
  556. <p class="control is-expanded has-icons-left">
  557. <input class="input" type="text" placeholder="Name">
  558. <span class="icon is-small is-left">
  559. <i class="fa fa-user"></i>
  560. </span>
  561. </p>
  562. </div>
  563. <div class="field">
  564. <p class="control is-expanded has-icons-left has-icons-right">
  565. <input class="input is-success" type="email" placeholder="Email" value="alex@smith.com">
  566. <span class="icon is-small is-left">
  567. <i class="fa fa-envelope"></i>
  568. </span>
  569. <span class="icon is-small is-right">
  570. <i class="fa fa-check"></i>
  571. </span>
  572. </p>
  573. </div>
  574. </div>
  575. </div>
  576. <div class="field is-horizontal">
  577. <div class="field-label"></div>
  578. <div class="field-body">
  579. <div class="field is-expanded">
  580. <div class="field has-addons">
  581. <p class="control">
  582. <a class="button is-static">
  583. +44
  584. </a>
  585. </p>
  586. <p class="control is-expanded">
  587. <input class="input" type="tel" placeholder="Your phone number">
  588. </p>
  589. </div>
  590. <p class="help">Do not enter the first zero</p>
  591. </div>
  592. </div>
  593. </div>
  594. <div class="field is-horizontal">
  595. <div class="field-label is-normal">
  596. <label class="label">Department</label>
  597. </div>
  598. <div class="field-body">
  599. <div class="field is-narrow">
  600. <div class="control">
  601. <div class="select is-fullwidth">
  602. <select>
  603. <option>Business development</option>
  604. <option>Marketing</option>
  605. <option>Sales</option>
  606. </select>
  607. </div>
  608. </div>
  609. </div>
  610. </div>
  611. </div>
  612. <div class="field is-horizontal">
  613. <div class="field-label">
  614. <label class="label">Already a member?</label>
  615. </div>
  616. <div class="field-body">
  617. <div class="field is-narrow">
  618. <div class="control">
  619. <label class="radio">
  620. <input type="radio" name="member">
  621. Yes
  622. </label>
  623. <label class="radio">
  624. <input type="radio" name="member">
  625. No
  626. </label>
  627. </div>
  628. </div>
  629. </div>
  630. </div>
  631. <div class="field is-horizontal">
  632. <div class="field-label is-normal">
  633. <label class="label">Subject</label>
  634. </div>
  635. <div class="field-body">
  636. <div class="field">
  637. <div class="control">
  638. <input class="input is-danger" type="text" placeholder="e.g. Partnership opportunity">
  639. </div>
  640. <p class="help is-danger">
  641. This field is required
  642. </p>
  643. </div>
  644. </div>
  645. </div>
  646. <div class="field is-horizontal">
  647. <div class="field-label is-normal">
  648. <label class="label">Question</label>
  649. </div>
  650. <div class="field-body">
  651. <div class="field">
  652. <div class="control">
  653. <textarea class="textarea" placeholder="Explain how we can help you"></textarea>
  654. </div>
  655. </div>
  656. </div>
  657. </div>
  658. <div class="field is-horizontal">
  659. <div class="field-label">
  660. <!-- Left empty for spacing -->
  661. </div>
  662. <div class="field-body">
  663. <div class="field">
  664. <div class="control">
  665. <button class="button is-primary">
  666. Send message
  667. </button>
  668. </div>
  669. </div>
  670. </div>
  671. </div>
  672. {% endcapture %}
  673. {% capture field_label_example %}
  674. <div class="field is-horizontal">
  675. <div class="field-label">
  676. <label class="label">No padding</label>
  677. </div>
  678. <div class="field-body">
  679. <div class="field">
  680. <div class="control">
  681. <label class="checkbox">
  682. <input type="checkbox">
  683. Checkbox
  684. </label>
  685. </div>
  686. </div>
  687. </div>
  688. </div>
  689. <div class="field is-horizontal">
  690. <div class="field-label is-small">
  691. <label class="label">Small padding</label>
  692. </div>
  693. <div class="field-body">
  694. <div class="field">
  695. <div class="control">
  696. <input class="input is-small" type="text" placeholder="Small sized input">
  697. </div>
  698. </div>
  699. </div>
  700. </div>
  701. <div class="field is-horizontal">
  702. <div class="field-label is-normal">
  703. <label class="label">Normal label</label>
  704. </div>
  705. <div class="field-body">
  706. <div class="field">
  707. <div class="control">
  708. <input class="input" type="text" placeholder="Normal sized input">
  709. </div>
  710. </div>
  711. </div>
  712. </div>
  713. <div class="field is-horizontal">
  714. <div class="field-label is-medium">
  715. <label class="label">Medium label</label>
  716. </div>
  717. <div class="field-body">
  718. <div class="field">
  719. <div class="control">
  720. <input class="input is-medium" type="text" placeholder="Medium sized input">
  721. </div>
  722. </div>
  723. </div>
  724. </div>
  725. <div class="field is-horizontal">
  726. <div class="field-label is-large">
  727. <label class="label">Large label</label>
  728. </div>
  729. <div class="field-body">
  730. <div class="field">
  731. <div class="control">
  732. <input class="input is-large" type="text" placeholder="Large sized input">
  733. </div>
  734. </div>
  735. </div>
  736. </div>
  737. {% endcapture %}
  738. {% include subnav-form.html %}
  739. <section class="section">
  740. <div class="container">
  741. <h1 class="title">Form controls</h1>
  742. <h2 class="subtitle">
  743. All generic <strong>form controls</strong>, designed for consistency
  744. </h2>
  745. <hr>
  746. <div class="content">
  747. <p>The following form controls <strong>classes</strong> are supported:</p>
  748. <ul>
  749. <li><code>.label</code></li>
  750. <li><code>.input</code></li>
  751. <li><code>.textarea</code></li>
  752. <li><code>.select</code></li>
  753. <li><code>.checkbox</code></li>
  754. <li><code>.radio</code></li>
  755. <li><code>.button</code></li>
  756. <li><code>.help</code></li>
  757. </ul>
  758. <p>Each of them should be wrapped in a <code>.control</code> container.<br>
  759. When combining several controls in a <strong>form</strong>, use the <code>.field</code> class as a <strong>container</strong>, to keep the spacing consistent.</p>
  760. </div>
  761. <div class="columns">
  762. <div class="column is-half">
  763. {{example}}
  764. </div>
  765. <div class="column is-half">
  766. {% highlight html %}{{example}}{% endhighlight %}
  767. </div>
  768. </div>
  769. <hr>
  770. <h3 id="form-field" class="title">Form field</h3>
  771. <div class="content">
  772. <p>The <code>field</code> container is a simple container for:</p>
  773. <ul>
  774. <li>a text <code>label</code></li>
  775. <li>a form <code>control</code></li>
  776. <li>an optional <code>help</code>text</li>
  777. </ul>
  778. </div>
  779. <div class="columns">
  780. <div class="column is-half">
  781. {{field_example}}
  782. </div>
  783. <div class="column is-half">
  784. {% highlight html %}{{field_example}}{% endhighlight %}
  785. </div>
  786. </div>
  787. <div class="content">
  788. <p>This container allows form fields to be <strong>spaced consistently</strong>.</p>
  789. </div>
  790. <div class="columns">
  791. <div class="column is-half">
  792. {{fields_example}}
  793. </div>
  794. <div class="column is-half">
  795. {% highlight html %}{{fields_example}}{% endhighlight %}
  796. </div>
  797. </div>
  798. <hr>
  799. <h3 id="form-control" class="title">Form control</h3>
  800. <div class="content">
  801. <p>The <code>control</code> is a versatile container meant to <strong>enhance single form controls</strong>. Because it has the same height as a control elements, it can <strong class="has-text-danger">only contain</strong> the following elements:</p>
  802. <ul>
  803. <li><code>input</code></li>
  804. <li><code>select</code></li>
  805. <li><code>button</code></li>
  806. <li><code>icon</code></li>
  807. </ul>
  808. </div>
  809. <div class="columns">
  810. <div class="column is-half">
  811. {{control_input_example}}
  812. </div>
  813. <div class="column is-half">
  814. {% highlight html %}{{control_input_example}}{% endhighlight %}
  815. </div>
  816. </div>
  817. <div class="columns">
  818. <div class="column is-half">
  819. {{control_select_example}}
  820. </div>
  821. <div class="column is-half">
  822. {% highlight html %}{{control_select_example}}{% endhighlight %}
  823. </div>
  824. </div>
  825. <div class="columns">
  826. <div class="column is-half">
  827. {{control_button_example}}
  828. </div>
  829. <div class="column is-half">
  830. {% highlight html %}{{control_button_example}}{% endhighlight %}
  831. </div>
  832. </div>
  833. <!-- Font Awesome Icons -->
  834. <hr>
  835. <h3 class="title">With icons</h3>
  836. <div class="content">
  837. <p>You can append one of 2 <strong>modifiers</strong> on a control:</p>
  838. <ul>
  839. <li>
  840. <code>has-icons-left</code>
  841. </li>
  842. <li>
  843. and/or <code>has-icons-right</code>
  844. </li>
  845. </ul>
  846. <p>You also need to add a modifier on the <strong>icon</strong>:</p>
  847. <ul>
  848. <li>
  849. <code>icon is-left</code> if <code>has-icons-left</code> is used
  850. </li>
  851. <li>
  852. <code>icon is-right</code> if <code>has-icons-right</code> is used
  853. </li>
  854. </ul>
  855. <p>The size of the <strong>input</strong> will define the size of the icon container.</p>
  856. </div>
  857. <div class="columns">
  858. <div class="column is-half">
  859. {{icons_example}}
  860. </div>
  861. <div class="column is-half highlight-full">
  862. {% highlight html %}{{icons_example}}{% endhighlight %}
  863. </div>
  864. </div>
  865. <div class="columns">
  866. <div class="column is-half">
  867. <div class="content">
  868. <p>
  869. You can append icons to <strong>select dropdowns</strong> as well.
  870. </p>
  871. </div>
  872. {{select_icons_example}}
  873. </div>
  874. <div class="column is-half">
  875. {% highlight html %}{{select_icons_example}}{% endhighlight %}
  876. </div>
  877. </div>
  878. <div class="columns">
  879. <div class="column is-half">
  880. <div class="content">
  881. <p>
  882. If the control contains an icon, Bulma will make sure the icon remains <strong>centered</strong>, no matter the size of the input <em>or</em> of the icon.
  883. </p>
  884. </div>
  885. {{has_icons_small_example}}
  886. </div>
  887. <div class="column is-half">
  888. {% highlight html %}{{has_icons_small_example}}{% endhighlight %}
  889. </div>
  890. </div>
  891. <div class="columns">
  892. <div class="column is-half">
  893. {{has_icons_normal_example}}
  894. </div>
  895. <div class="column is-half">
  896. {% highlight html %}{{has_icons_normal_example}}{% endhighlight %}
  897. </div>
  898. </div>
  899. <div class="columns">
  900. <div class="column is-half">
  901. {{has_icons_medium_example}}
  902. </div>
  903. <div class="column is-half">
  904. {% highlight html %}{{has_icons_medium_example}}{% endhighlight %}
  905. </div>
  906. </div>
  907. <div class="columns">
  908. <div class="column is-half">
  909. {{has_icons_large_example}}
  910. </div>
  911. <div class="column is-half">
  912. {% highlight html %}{{has_icons_large_example}}{% endhighlight %}
  913. </div>
  914. </div>
  915. <hr>
  916. <h3 id="form-addons" class="title">Form addons</h3>
  917. <div class="content">
  918. <p>If you want to <strong>attach controls</strong> together, use the <code>has-addons</code> modifier on the <code>field</code> container:</p>
  919. </div>
  920. <div class="bd-example">
  921. {{addons_example}}
  922. </div>
  923. {% highlight html %}{{addons_example}}{% endhighlight %}
  924. <div class="content">
  925. <p>You can attach inputs, buttons, and dropdowns <strong>only</strong>.</p>
  926. </div>
  927. <div class="content">
  928. <p>
  929. <span class="tag is-success">New!</span>
  930. <span class="tag is-info">0.4.2</span>
  931. </p>
  932. <p>It can be useful to append a <a href="{{site.url}}/documentation/elements/button#static-button">static button</a>.</p>
  933. </div>
  934. <div class="bd-example">
  935. {{addons_static_example}}
  936. </div>
  937. {% highlight html %}{{addons_static_example}}{% endhighlight %}
  938. <div class="content">
  939. <p>Use the <code>is-expanded</code> modifier on the element you want to fill up the remaining space (in this case, the input):</p>
  940. </div>
  941. <div class="bd-example">
  942. {{addons_expanded_example}}
  943. </div>
  944. {% highlight html %}{{addons_expanded_example}}{% endhighlight %}
  945. <div class="content">
  946. <p>If you want a full width select dropdown, pair <code>control is-expanded</code> with <code>select is-fullwidth</code>.</p>
  947. </div>
  948. <div class="bd-example">
  949. {{addons_expanded_fullwidth_example}}
  950. </div>
  951. {% highlight html %}{{addons_expanded_fullwidth_example}}{% endhighlight %}
  952. <div class="content">
  953. <p>Use the <code>has-addons-centered</code> or the <code>has-addons-right</code> modifers to alter the <strong>alignment</strong>.</p>
  954. </div>
  955. <div class="bd-example">
  956. {{addons_center_example}}
  957. </div>
  958. {% highlight html %}{{addons_center_example}}{% endhighlight %}
  959. <div class="bd-example">
  960. {{addons_right_example}}
  961. </div>
  962. {% highlight html %}{{addons_right_example}}{% endhighlight %}
  963. <hr>
  964. <h3 class="title">Form group</h3>
  965. <div class="content">
  966. <p>
  967. If you want to <strong>group</strong> controls together, use the <code>is-grouped</code> modifier on the <code>field</code> container.
  968. </p>
  969. </div>
  970. <div class="bd-example">
  971. {{group_example}}
  972. </div>
  973. {% highlight html %}{{group_example}}{% endhighlight %}
  974. <div class="content">
  975. Use the <code>is-grouped-centered</code> or the <code>is-grouped-right</code> modifers to alter the <strong>alignment</strong>.
  976. </p>
  977. </div>
  978. <div class="bd-example">
  979. {{group_centered_example}}
  980. </div>
  981. {% highlight html %}{{group_centered_example}}{% endhighlight %}
  982. <div class="bd-example">
  983. {{group_right_example}}
  984. </div>
  985. {% highlight html %}{{group_right_example}}{% endhighlight %}
  986. <div class="content">
  987. <p>
  988. Add the <code>is-expanded</code> modifier on the control element you want to <strong>fill up the remaining space</strong> with.
  989. </p>
  990. </div>
  991. <div class="bd-example">
  992. {{group_expanded_example}}
  993. </div>
  994. {% highlight html %}{{group_expanded_example}}{% endhighlight %}
  995. <div id="form-group-multiline" class="content">
  996. <p>
  997. <span class="tag is-success">New!</span>
  998. <span class="tag is-info">0.4.4</span>
  999. </p>
  1000. <p>
  1001. Add the <code>is-grouped-multiline</code> modifier to allow controls to fill up <strong>multiple lines</strong>. This is ideal for a long list of controls.
  1002. </p>
  1003. </div>
  1004. <div class="columns">
  1005. <div class="column is-half">
  1006. <div class="bd-example">
  1007. {{group_multiline_example}}
  1008. </div>
  1009. </div>
  1010. <div class="column is-half">
  1011. {% highlight html %}{{group_multiline_example}}{% endhighlight %}
  1012. </div>
  1013. </div>
  1014. <hr>
  1015. <h3 class="title">Horizontal form</h3>
  1016. <div class="content">
  1017. <p>If you want a <strong>horizontal</strong> form control, use the <code>is-horizontal</code> modifier on the <code>field</code> container, in which you include:</p>
  1018. <ul>
  1019. <li>
  1020. <code>field-label</code> for the side label
  1021. </li>
  1022. <li>
  1023. <code>field-body</code> for the input/select/textarea container
  1024. </li>
  1025. </ul>
  1026. <p>You can use <code>is-grouped</code> or <code>has-addons</code> for the child elements.</p>
  1027. </div>
  1028. <div class="bd-example">
  1029. {{horizontal_form_example}}
  1030. </div>
  1031. {% highlight html %}{{horizontal_form_example}}{% endhighlight %}
  1032. <div class="content">
  1033. <p>
  1034. To preserve the <strong>vertical alignment</strong> of labels with each type and size of control, the <code>.field-label</code> comes with <strong>4 size modifiers</strong>:
  1035. </p>
  1036. <ul>
  1037. <li>
  1038. <code>.is-small</code>
  1039. </li>
  1040. <li>
  1041. <code>.is-normal</code> for any <code>.input</code> or <code>.button</code>
  1042. </li>
  1043. <li>
  1044. <code>.is-medium</code>
  1045. </li>
  1046. <li>
  1047. <code>.is-large</code>
  1048. </li>
  1049. </ul>
  1050. </div>
  1051. <div class="bd-example">
  1052. {{field_label_example}}
  1053. </div>
  1054. {% highlight html %}{{field_label_example}}{% endhighlight %}
  1055. </div>
  1056. </section>