options.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344
  1. ---
  2. title: Column options
  3. layout: documentation
  4. doc-tab: columns
  5. doc-subtab: options
  6. ---
  7. {% capture columns_multiline %}
  8. <div class="columns is-multiline is-mobile">
  9. <div class="column is-one-quarter">
  10. <code>is-one-quarter</code>
  11. </div>
  12. <div class="column is-one-quarter">
  13. <code>is-one-quarter</code>
  14. </div>
  15. <div class="column is-one-quarter">
  16. <code>is-one-quarter</code>
  17. </div>
  18. <div class="column is-one-quarter">
  19. <code>is-one-quarter</code>
  20. </div>
  21. <div class="column is-half">
  22. <code>is-half</code>
  23. </div>
  24. <div class="column is-one-quarter">
  25. <code>is-one-quarter</code>
  26. </div>
  27. <div class="column is-one-quarter">
  28. <code>is-one-quarter</code>
  29. </div>
  30. <div class="column">
  31. Auto
  32. </div>
  33. </div>
  34. {% endcapture %}
  35. {% capture columns_gapless %}
  36. <div class="columns is-gapless">
  37. <div class="column">First column</div>
  38. <div class="column">Second column</div>
  39. <div class="column">Third column</div>
  40. <div class="column">Fourth column</div>
  41. </div>
  42. {% endcapture %}
  43. {% capture columns_gapless_multiline %}
  44. <div class="columns is-gapless is-multiline is-mobile">
  45. <div class="column is-one-quarter">
  46. <code>is-one-quarter</code>
  47. </div>
  48. <div class="column is-one-quarter">
  49. <code>is-one-quarter</code>
  50. </div>
  51. <div class="column is-one-quarter">
  52. <code>is-one-quarter</code>
  53. </div>
  54. <div class="column is-one-quarter">
  55. <code>is-one-quarter</code>
  56. </div>
  57. <div class="column is-half">
  58. <code>is-half</code>
  59. </div>
  60. <div class="column is-one-quarter">
  61. <code>is-one-quarter</code>
  62. </div>
  63. <div class="column is-one-quarter">
  64. <code>is-one-quarter</code>
  65. </div>
  66. <div class="column">
  67. Auto
  68. </div>
  69. </div>
  70. {% endcapture %}
  71. {% capture columns_mobile_centered %}
  72. <div class="columns is-mobile is-centered">
  73. <div class="column is-half is-narrow">
  74. <p class="bd-notification is-info">
  75. <code class="html">is-half</code><br>
  76. <code class="html">is-narrow</code>
  77. </p>
  78. </div>
  79. </div>
  80. {% endcapture %}
  81. {% capture columns_mobile_multiline_centered %}
  82. <div class="columns is-mobile is-multiline is-centered">
  83. <div class="column is-narrow">
  84. <p class="bd-notification is-info">
  85. <code class="html">is-narrow</code><br>
  86. First Column
  87. </p>
  88. </div>
  89. <div class="column is-narrow">
  90. <p class="bd-notification is-success">
  91. <code class="html">is-narrow</code><br>
  92. Our Second Column
  93. </p>
  94. </div>
  95. <div class="column is-narrow">
  96. <p class="bd-notification is-danger">
  97. <code class="html">is-narrow</code><br>
  98. Third Column
  99. </p>
  100. </div>
  101. <div class="column is-narrow">
  102. <p class="bd-notification is-info">
  103. <code class="html">is-narrow</code><br>
  104. The Fourth Column
  105. </p>
  106. </div>
  107. <div class="column is-narrow">
  108. <p class="bd-notification is-success">
  109. <code class="html">is-narrow</code><br>
  110. Fifth Column
  111. </p>
  112. </div>
  113. </div>
  114. {% endcapture %}
  115. {% capture columns_narrow %}
  116. <div class="columns">
  117. <div class="column is-narrow">
  118. <div class="box" style="width: 200px;">
  119. <p class="title is-5">Narrow column</p>
  120. <p class="subtitle">This column is only 200px wide.</p>
  121. </div>
  122. </div>
  123. <div class="column">
  124. <div class="box">
  125. <p class="title is-5">Flexible column</p>
  126. <p class="subtitle">This column will take up the remaining space available.</p>
  127. </div>
  128. </div>
  129. </div>
  130. {% endcapture %}
  131. {% include subnav-columns.html %}
  132. <section class="section">
  133. <div class="container">
  134. <h1 class="title">Column options</h1>
  135. <h2 class="subtitle">
  136. Design different <strong>types</strong> of column layouts
  137. </h2>
  138. {% include anchor.html name="Multiline" %}
  139. <div class="content">
  140. <p>Whenever you want to start a new line, you can close a <code>columns</code> container and start a new one. But you can also add the <code>is-multiline</code> modifier and add <strong>more</strong> column elements that would fit in a single row.</p>
  141. </div>
  142. <div class="columns is-multiline is-mobile">
  143. <div class="column is-one-quarter">
  144. <p class="bd-notification is-info"><code>is-one-quarter</code></p>
  145. </div>
  146. <div class="column is-one-quarter">
  147. <p class="bd-notification is-success"><code>is-one-quarter</code></p>
  148. </div>
  149. <div class="column is-one-quarter">
  150. <p class="bd-notification is-warning"><code>is-one-quarter</code></p>
  151. </div>
  152. <div class="column is-one-quarter">
  153. <p class="bd-notification is-danger"><code>is-one-quarter</code></p>
  154. </div>
  155. <div class="column is-half">
  156. <p class="bd-notification is-info"><code>is-half</code></p>
  157. </div>
  158. <div class="column is-one-quarter">
  159. <p class="bd-notification is-success"><code>is-one-quarter</code></p>
  160. </div>
  161. <div class="column is-one-quarter">
  162. <p class="bd-notification is-warning"><code>is-one-quarter</code></p>
  163. </div>
  164. <div class="column is-one-quarter">
  165. <p class="bd-notification is-danger"><code>is-one-quarter</code></p>
  166. </div>
  167. <div class="column">
  168. <p class="bd-notification is-info">Auto</p>
  169. </div>
  170. </div>
  171. {% highlight html %}{{ columns_multiline }}{% endhighlight %}
  172. {% include anchor.html name="Gapless" %}
  173. <div class="content">
  174. <p>
  175. If you want to remove the <strong>space</strong> between the columns, add the <code>is-gapless</code> modifier on the <code>columns</code> container:
  176. </p>
  177. </div>
  178. <div class="columns is-gapless">
  179. <div class="column">
  180. <p class="bd-notification is-info">First column</p>
  181. </div>
  182. <div class="column">
  183. <p class="bd-notification is-success">Second column</p>
  184. </div>
  185. <div class="column">
  186. <p class="bd-notification is-warning">Third column</p>
  187. </div>
  188. <div class="column">
  189. <p class="bd-notification is-danger">Fourth column</p>
  190. </div>
  191. </div>
  192. {% highlight html %}{{ columns_gapless }}{% endhighlight %}
  193. <div class="content">
  194. <p>You can combine it with the <code>is-multiline</code> modifier:</p>
  195. </div>
  196. <div class="columns is-multiline is-mobile is-gapless">
  197. <div class="column is-one-quarter">
  198. <p class="bd-notification is-info"><code>is-one-quarter</code></p>
  199. </div>
  200. <div class="column is-one-quarter">
  201. <p class="bd-notification is-success"><code>is-one-quarter</code></p>
  202. </div>
  203. <div class="column is-one-quarter">
  204. <p class="bd-notification is-warning"><code>is-one-quarter</code></p>
  205. </div>
  206. <div class="column is-one-quarter">
  207. <p class="bd-notification is-danger"><code>is-one-quarter</code></p>
  208. </div>
  209. <div class="column is-half">
  210. <p class="bd-notification is-info"><code>is-half</code></p>
  211. </div>
  212. <div class="column is-one-quarter">
  213. <p class="bd-notification is-success"><code>is-one-quarter</code></p>
  214. </div>
  215. <div class="column is-one-quarter">
  216. <p class="bd-notification is-warning"><code>is-one-quarter</code></p>
  217. </div>
  218. <div class="column is-one-quarter">
  219. <p class="bd-notification is-danger"><code>is-one-quarter</code></p>
  220. </div>
  221. <div class="column">
  222. <p class="bd-notification is-info">Auto</p>
  223. </div>
  224. </div>
  225. {% highlight html %}{{ columns_gapless_multiline }}{% endhighlight %}
  226. {% include anchor.html name="Centering columns" %}
  227. <div class="content">
  228. <p>
  229. While you can use <em>empty columns</em> (like <code>&lt;div class="column"&gt;&lt;/div&gt;</code>) to create horizontal space around <code>.column</code> elements, you can also use <code>.is-centered</code> on the parent <code>.columns</code> element:
  230. </p>
  231. </div>
  232. <div class="columns is-mobile is-centered">
  233. <div class="column is-half is-narrow">
  234. <p class="bd-notification is-info">
  235. <code class="html">is-half</code><br>
  236. <code class="html">is-narrow</code>
  237. </p>
  238. </div>
  239. </div>
  240. {% highlight html %}{{ columns_mobile_centered }}{% endhighlight %}
  241. <div class="content">
  242. <p>
  243. Use with <code>.is-multiline</code> to create a flexible, centered list (try resizing to see centering in different viewport sizes):
  244. </p>
  245. </div>
  246. <div class="columns is-mobile is-multiline is-centered">
  247. <div class="column is-narrow">
  248. <p class="bd-notification is-info" style="padding: 1.25rem 1.5rem;">
  249. <code class="html">is-narrow</code><br>
  250. First Column
  251. </p>
  252. </div>
  253. <div class="column is-narrow">
  254. <p class="bd-notification is-success" style="padding: 1.25rem 1.5rem;">
  255. <code class="html">is-narrow</code><br>
  256. Our Second Column
  257. </p>
  258. </div>
  259. <div class="column is-narrow">
  260. <p class="bd-notification is-danger" style="padding: 1.25rem 1.5rem;">
  261. <code class="html">is-narrow</code><br>
  262. Third Column
  263. </p>
  264. </div>
  265. <div class="column is-narrow">
  266. <p class="bd-notification is-info" style="padding: 1.25rem 1.5rem;">
  267. <code class="html">is-narrow</code><br>
  268. The Fourth Column
  269. </p>
  270. </div>
  271. <div class="column is-narrow">
  272. <p class="bd-notification is-success" style="padding: 1.25rem 1.5rem;">
  273. <code class="html">is-narrow</code><br>
  274. Fifth Column
  275. </p>
  276. </div>
  277. </div>
  278. {% highlight html %}{{ columns_mobile_multiline_centered }}{% endhighlight %}
  279. {% include anchor.html name="Narrow column" %}
  280. <div class="content">
  281. <p>If you want a column to only take the <strong>space it needs</strong>, use the <code>is-narrow</code> modifier. The other column(s) will fill up the remaining space.</p>
  282. </div>
  283. <div class="columns">
  284. <div class="column is-narrow">
  285. <div class="box" style="width: 200px;">
  286. <p class="title is-5">Narrow column</p>
  287. <p class="subtitle">This column is only 200px wide.</p>
  288. </div>
  289. </div>
  290. <div class="column">
  291. <div class="box">
  292. <p class="title is-5">Flexible column</p>
  293. <p class="subtitle">This column will take up the remaining space available.</p>
  294. </div>
  295. </div>
  296. </div>
  297. {% highlight html %}{{ columns_narrow }}{% endhighlight %}
  298. <div class="content">
  299. <p>As for the size modifiers, you can have narrow columns for different <strong>breakpoints</strong>:</p>
  300. <ul>
  301. <li>
  302. <code>is-narrow-mobile</code>
  303. </li>
  304. <li>
  305. <code>is-narrow-tablet</code>
  306. </li>
  307. <li>
  308. <code>is-narrow-desktop</code>
  309. </li>
  310. </ul>
  311. </div>
  312. </div>
  313. </section>