general.html 27 KB

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