general.html 29 KB

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