general.html 28 KB

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