form.html 31 KB

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