gap.html 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283
  1. ---
  2. title: Columns gap
  3. layout: documentation
  4. doc-tab: columns
  5. doc-subtab: gap
  6. breadcrumb:
  7. - home
  8. - documentation
  9. - columns
  10. - columns-gap
  11. ---
  12. {% capture columns_default_gap %}
  13. <div class="columns">
  14. <div class="column">
  15. <p class="bd-notification is-primary">
  16. Default gap
  17. </p>
  18. </div>
  19. <div class="column">
  20. <p class="bd-notification is-primary">
  21. Default gap
  22. </p>
  23. </div>
  24. <div class="column">
  25. <p class="bd-notification is-primary">
  26. Default gap
  27. </p>
  28. </div>
  29. <div class="column">
  30. <p class="bd-notification is-primary">
  31. Default gap
  32. </p>
  33. </div>
  34. </div>
  35. {% endcapture %}
  36. {% capture columns_gapless %}
  37. <div class="columns is-gapless">
  38. <div class="column">
  39. No gap
  40. </div>
  41. <div class="column">
  42. No gap
  43. </div>
  44. <div class="column">
  45. No gap
  46. </div>
  47. <div class="column">
  48. No gap
  49. </div>
  50. </div>
  51. {% endcapture %}
  52. {% capture columns_gapless_multiline %}
  53. <div class="columns is-gapless is-multiline is-mobile">
  54. <div class="column is-one-quarter">
  55. is-one-quarter
  56. </div>
  57. <div class="column is-one-quarter">
  58. is-one-quarter
  59. </div>
  60. <div class="column is-one-quarter">
  61. is-one-quarter
  62. </div>
  63. <div class="column is-one-quarter">
  64. is-one-quarter
  65. </div>
  66. <div class="column is-half">
  67. is-half
  68. </div>
  69. <div class="column is-one-quarter">
  70. is-one-quarter
  71. </div>
  72. <div class="column is-one-quarter">
  73. is-one-quarter
  74. </div>
  75. <div class="column is-one-quarter">
  76. is-one-quarter
  77. </div>
  78. <div class="column">
  79. Auto
  80. </div>
  81. </div>
  82. {% endcapture %}
  83. {% capture columns_variable_responsive_gaps %}
  84. <div class="columns is-variable is-1-mobile is-0-tablet is-3-desktop is-8-widescreen is-2-fullhd">
  85. <div class="column">
  86. Column
  87. </div>
  88. <div class="column">
  89. Column
  90. </div>
  91. <div class="column">
  92. Column
  93. </div>
  94. <div class="column">
  95. Column
  96. </div>
  97. <div class="column">
  98. Column
  99. </div>
  100. <div class="column">
  101. Column
  102. </div>
  103. </div>
  104. {% endcapture %}
  105. {% include elements/anchor.html name="Default gap" %}
  106. <div class="content">
  107. <p>
  108. Each column has a <strong>gap</strong> equal to the <strong>variable</strong> <code>$column-gap</code>, which has a default value of <code>0.75rem</code>.
  109. <br>
  110. Since the gap is on <em>each side</em> of a column, the gap between two adjacent columns will be twice the value of <code>$column-gap</code>, or <code>1.5rem</code> by default.
  111. </p>
  112. </div>
  113. {{ columns_default_gap }}
  114. {% include elements/anchor.html name="Gapless" %}
  115. <div class="content">
  116. <p>
  117. 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:
  118. </p>
  119. </div>
  120. <div class="columns is-gapless">
  121. <div class="column">
  122. <p class="bd-notification is-primary">First column</p>
  123. </div>
  124. <div class="column">
  125. <p class="bd-notification is-primary">Second column</p>
  126. </div>
  127. <div class="column">
  128. <p class="bd-notification is-primary">Third column</p>
  129. </div>
  130. <div class="column">
  131. <p class="bd-notification is-primary">Fourth column</p>
  132. </div>
  133. </div>
  134. <div class="highlight-full">
  135. {% highlight html %}{{ columns_gapless }}{% endhighlight %}
  136. </div>
  137. <div class="content">
  138. <p>You can combine it with the <code>is-multiline</code> modifier:</p>
  139. </div>
  140. <div class="columns is-multiline is-mobile is-gapless">
  141. <div class="column is-one-quarter">
  142. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  143. </div>
  144. <div class="column is-one-quarter">
  145. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  146. </div>
  147. <div class="column is-one-quarter">
  148. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  149. </div>
  150. <div class="column is-one-quarter">
  151. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  152. </div>
  153. <div class="column is-half">
  154. <p class="bd-notification is-primary"><code>is-half</code></p>
  155. </div>
  156. <div class="column is-one-quarter">
  157. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  158. </div>
  159. <div class="column is-one-quarter">
  160. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  161. </div>
  162. <div class="column is-one-quarter">
  163. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  164. </div>
  165. <div class="column">
  166. <p class="bd-notification is-primary">Auto</p>
  167. </div>
  168. </div>
  169. <div class="highlight-full">
  170. {% highlight html %}{{ columns_gapless_multiline }}{% endhighlight %}
  171. </div>
  172. {% include elements/anchor.html name="Variable gap" %}
  173. <div class="field is-grouped is-grouped-multiline">
  174. <div class="control">
  175. <div class="tags">
  176. <span class="tag is-warning">Experimental</span>
  177. </div>
  178. </div>
  179. </div>
  180. <div class="content">
  181. <p>
  182. You can specify a <strong>custom column gap</strong> by appending one of <strong>9 modifiers</strong> on the <code>.columns</code> container.
  183. </p>
  184. <ul>
  185. <li>
  186. <code>is-0</code> will remove any gap (similar to <code>is-gapless</code>)
  187. </li>
  188. <li>
  189. <code>is-3</code> is the <strong>default value</strong>, equivalent to the <code>0.75rem</code> value
  190. </li>
  191. <li>
  192. <code>is-8</code> is the maximum gap of <code>2rem</code>
  193. </li>
  194. </ul>
  195. <p>
  196. Additionally, <code>.is-variable</code> should be added on the <code>.columns</code> container.
  197. </p>
  198. </div>
  199. {% include content/klmn.html %}
  200. <div class="message is-warning">
  201. <div class="message-body">
  202. <p>
  203. This feature is only available in browsers that support <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables">CSS Variables</a>:
  204. </p>
  205. </div>
  206. </div>
  207. <div class="message is-info">
  208. <div class="message-body">
  209. <p>
  210. If your Sass setup doesn't support CSS Variables, you can <strong>disable this feature</strong> by setting <code>$variable-columns</code> to <code>false</code>.
  211. </p>
  212. </div>
  213. </div>
  214. {% assign vernum = site.data.meta.version | downcase | remove: "." | plus: 0 %}
  215. {% if vernum >= 72 %}
  216. {% include elements/anchor.html name="Breakpoint based column gaps" %}
  217. {% include elements/new-tag.html version="0.7.2" %}
  218. <div class="content">
  219. <p>
  220. You can define a column gap for each viewport size:
  221. </p>
  222. </div>
  223. For example, here's how it looks with the following modifiers: <code>is-variable is-2-mobile is-0-tablet is-3-desktop is-8-widescreen is-1-fullhd</code>
  224. <div class="highlight-full">
  225. {% highlight html %}{{ columns_variable_responsive_gaps }}{% endhighlight %}
  226. </div>
  227. <div class="columns is-variable is-1-mobile is-0-tablet is-3-desktop is-8-widescreen is-2-fullhd">
  228. <div class="column">
  229. <p class="bd-notification is-primary">Column</p>
  230. </div>
  231. <div class="column">
  232. <p class="bd-notification is-primary">Column</p>
  233. </div>
  234. <div class="column">
  235. <p class="bd-notification is-primary">Column</p>
  236. </div>
  237. <div class="column">
  238. <p class="bd-notification is-primary">Column</p>
  239. </div>
  240. <div class="column">
  241. <p class="bd-notification is-primary">Column</p>
  242. </div>
  243. <div class="column">
  244. <p class="bd-notification is-primary">Column</p>
  245. </div>
  246. </div>
  247. <div class="message is-info">
  248. <p class="message-body">
  249. If you want to see the difference, resize your browser and see how the <strong>columns gap</strong> varies.
  250. </p>
  251. </div>
  252. {% endif %}