gap.html 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
  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. {% include elements/anchor.html name="Default gap" %}
  84. <div class="content">
  85. <p>
  86. 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>.
  87. <br>
  88. 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.
  89. </p>
  90. </div>
  91. {{ columns_default_gap }}
  92. {% include elements/anchor.html name="Gapless" %}
  93. <div class="content">
  94. <p>
  95. 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:
  96. </p>
  97. </div>
  98. <div class="columns is-gapless">
  99. <div class="column">
  100. <p class="bd-notification is-primary">First column</p>
  101. </div>
  102. <div class="column">
  103. <p class="bd-notification is-primary">Second column</p>
  104. </div>
  105. <div class="column">
  106. <p class="bd-notification is-primary">Third column</p>
  107. </div>
  108. <div class="column">
  109. <p class="bd-notification is-primary">Fourth column</p>
  110. </div>
  111. </div>
  112. <div class="highlight-full">
  113. {% highlight html %}{{ columns_gapless }}{% endhighlight %}
  114. </div>
  115. <div class="content">
  116. <p>You can combine it with the <code>is-multiline</code> modifier:</p>
  117. </div>
  118. <div class="columns is-multiline is-mobile is-gapless">
  119. <div class="column is-one-quarter">
  120. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  121. </div>
  122. <div class="column is-one-quarter">
  123. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  124. </div>
  125. <div class="column is-one-quarter">
  126. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  127. </div>
  128. <div class="column is-one-quarter">
  129. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  130. </div>
  131. <div class="column is-half">
  132. <p class="bd-notification is-primary"><code>is-half</code></p>
  133. </div>
  134. <div class="column is-one-quarter">
  135. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  136. </div>
  137. <div class="column is-one-quarter">
  138. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  139. </div>
  140. <div class="column is-one-quarter">
  141. <p class="bd-notification is-primary"><code>is-one-quarter</code></p>
  142. </div>
  143. <div class="column">
  144. <p class="bd-notification is-primary">Auto</p>
  145. </div>
  146. </div>
  147. <div class="highlight-full">
  148. {% highlight html %}{{ columns_gapless_multiline }}{% endhighlight %}
  149. </div>
  150. {% include elements/anchor.html name="Variable gap" %}
  151. <div class="field is-grouped is-grouped-multiline">
  152. <div class="control">
  153. <div class="tags">
  154. <span class="tag is-warning">Experimental</span>
  155. </div>
  156. </div>
  157. </div>
  158. <div class="content">
  159. <p>
  160. You can specify a <strong>custom column gap</strong> by appending one of <strong>9 modifiers</strong> on the <code>.columns</code> container.
  161. </p>
  162. <ul>
  163. <li>
  164. <code>is-0</code> will remove any gap (similar to <code>is-gapless</code>)
  165. </li>
  166. <li>
  167. <code>is-3</code> is the <strong>default value</strong>, equivalent to the <code>0.75rem</code> value
  168. </li>
  169. <li>
  170. <code>is-8</code> is the maximum gap of <code>2rem</code>
  171. </li>
  172. </ul>
  173. <p>
  174. Additionally, <code>.is-variable</code> should be added on the <code>.columns</code> container.
  175. </p>
  176. </div>
  177. {% include content/klmn.html %}
  178. <div class="message is-warning">
  179. <div class="message-body">
  180. <p>
  181. 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>:
  182. </p>
  183. </div>
  184. </div>
  185. <div class="message is-info">
  186. <div class="message-body">
  187. <p>
  188. 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>.
  189. </p>
  190. </div>
  191. </div>