gap.html 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221
  1. ---
  2. title: Columns gap
  3. layout: documentation
  4. doc-tab: columns
  5. doc-subtab: gap
  6. ---
  7. {% capture columns_default_gap %}
  8. <div class="columns">
  9. <div class="column">
  10. <p class="bd-notification is-info">
  11. Default gap
  12. </p>
  13. </div>
  14. <div class="column">
  15. <p class="bd-notification is-success">
  16. Default gap
  17. </p>
  18. </div>
  19. <div class="column">
  20. <p class="bd-notification is-warning">
  21. Default gap
  22. </p>
  23. </div>
  24. <div class="column">
  25. <p class="bd-notification is-danger">
  26. Default gap
  27. </p>
  28. </div>
  29. </div>
  30. {% endcapture %}
  31. {% capture columns_gapless %}
  32. <div class="columns is-gapless">
  33. <div class="column">
  34. No gap
  35. </div>
  36. <div class="column">
  37. No gap
  38. </div>
  39. <div class="column">
  40. No gap
  41. </div>
  42. <div class="column">
  43. No gap
  44. </div>
  45. </div>
  46. {% endcapture %}
  47. {% capture columns_gapless_multiline %}
  48. <div class="columns is-gapless is-multiline is-mobile">
  49. <div class="column is-one-quarter">
  50. is-one-quarter
  51. </div>
  52. <div class="column is-one-quarter">
  53. is-one-quarter
  54. </div>
  55. <div class="column is-one-quarter">
  56. is-one-quarter
  57. </div>
  58. <div class="column is-one-quarter">
  59. is-one-quarter
  60. </div>
  61. <div class="column is-half">
  62. is-half
  63. </div>
  64. <div class="column is-one-quarter">
  65. is-one-quarter
  66. </div>
  67. <div class="column is-one-quarter">
  68. is-one-quarter
  69. </div>
  70. <div class="column">
  71. Auto
  72. </div>
  73. </div>
  74. {% endcapture %}
  75. {% include subnav-columns.html %}
  76. <section class="section">
  77. <div class="container">
  78. <h1 class="title">Columns gap</h1>
  79. <h2 class="subtitle">
  80. Customize the <strong>gap</strong> between the columns
  81. </h2>
  82. {% include anchor.html name="Default gap" %}
  83. <div class="content">
  84. <p>
  85. 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>.
  86. <br>
  87. 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.
  88. </p>
  89. </div>
  90. {{ columns_default_gap }}
  91. {% include anchor.html name="Gapless" %}
  92. <div class="content">
  93. <p>
  94. 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:
  95. </p>
  96. </div>
  97. <div class="columns is-gapless">
  98. <div class="column">
  99. <p class="bd-notification is-info">First column</p>
  100. </div>
  101. <div class="column">
  102. <p class="bd-notification is-success">Second column</p>
  103. </div>
  104. <div class="column">
  105. <p class="bd-notification is-warning">Third column</p>
  106. </div>
  107. <div class="column">
  108. <p class="bd-notification is-danger">Fourth column</p>
  109. </div>
  110. </div>
  111. <div class="highlight-full">
  112. {% highlight html %}{{ columns_gapless }}{% endhighlight %}
  113. </div>
  114. <div class="content">
  115. <p>You can combine it with the <code>is-multiline</code> modifier:</p>
  116. </div>
  117. <div class="columns is-multiline is-mobile is-gapless">
  118. <div class="column is-one-quarter">
  119. <p class="bd-notification is-info"><code>is-one-quarter</code></p>
  120. </div>
  121. <div class="column is-one-quarter">
  122. <p class="bd-notification is-success"><code>is-one-quarter</code></p>
  123. </div>
  124. <div class="column is-one-quarter">
  125. <p class="bd-notification is-warning"><code>is-one-quarter</code></p>
  126. </div>
  127. <div class="column is-one-quarter">
  128. <p class="bd-notification is-danger"><code>is-one-quarter</code></p>
  129. </div>
  130. <div class="column is-half">
  131. <p class="bd-notification is-info"><code>is-half</code></p>
  132. </div>
  133. <div class="column is-one-quarter">
  134. <p class="bd-notification is-success"><code>is-one-quarter</code></p>
  135. </div>
  136. <div class="column is-one-quarter">
  137. <p class="bd-notification is-warning"><code>is-one-quarter</code></p>
  138. </div>
  139. <div class="column is-one-quarter">
  140. <p class="bd-notification is-danger"><code>is-one-quarter</code></p>
  141. </div>
  142. <div class="column">
  143. <p class="bd-notification is-info">Auto</p>
  144. </div>
  145. </div>
  146. <div class="highlight-full">
  147. {% highlight html %}{{ columns_gapless_multiline }}{% endhighlight %}
  148. </div>
  149. {% include anchor.html name="Variable gap" %}
  150. <div class="field is-grouped is-grouped-multiline">
  151. <div class="control">
  152. <div class="tags">
  153. <span class="tag is-warning">Experimental</span>
  154. </div>
  155. </div>
  156. <div class="control">
  157. <div class="tags has-addons">
  158. <span class="tag">New</span>
  159. <span class="tag is-info">0.5.2</span>
  160. </div>
  161. </div>
  162. </div>
  163. <div class="content">
  164. <p>
  165. You can specify a <strong>custom column gap</strong> by appending one of <strong>9 modifiers</strong> on the <code>.columns</code> container.
  166. </p>
  167. <ul>
  168. <li>
  169. <code>is-0</code> will remove any gap (similar to <code>is-gapless</code>)
  170. </li>
  171. <li>
  172. <code>is-3</code> is the <strong>default value</strong>, equivalent to the <code>0.75rem</code> value
  173. </li>
  174. <li>
  175. <code>is-8</code> is the maximum gap of <code>2rem</code>
  176. </li>
  177. </ul>
  178. <p>
  179. Additionally, <code>.is-variable</code> should be added on the <code>.columns</code> container.
  180. </p>
  181. </div>
  182. {% include klmn.html %}
  183. <div class="message is-warning">
  184. <div class="message-body">
  185. <p>
  186. 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>:
  187. </p>
  188. </div>
  189. </div>
  190. <div class="message is-info">
  191. <div class="message-body">
  192. <p>
  193. 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>.
  194. </p>
  195. </div>
  196. </div>
  197. </div>
  198. </section>