mirror_css/bootstrap
1
0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2025-08-30 16:50:00 +02:00
Code Issues Releases Wiki Activity

Add v5.0.0-beta3 docs (#33440)

Browse Source
This commit is contained in:
XhmikosR
2021-03-23 18:32:27 +02:00
committed by GitHub
parent 8484574c52
commit e2460ba2f8
219 changed files with 13671 additions and 7651 deletions
Download Patch File Download Diff File Expand all files Collapse all files

162
docs/5.0/utilities/spacing/index.html
View File

@@ -5,7 +5,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Bootstrap includes a wide range of shorthand responsive margin, padding, and gap utility classes to modify an element&rsquo;s appearance.">
<meta name="author" content="Mark Otto, Jacob Thornton, and Bootstrap contributors">
<meta name="generator" content="Hugo 0.80.0">
<meta name="generator" content="Hugo 0.82.0">
<meta name="docsearch:language" content="en">
<meta name="docsearch:version" content="5.0">
@@ -17,7 +17,7 @@
<!-- Bootstrap core CSS -->
<link href="/docs/5.0/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-BmbxuPwQa2lc/FVzBcNJ7UAyJxM6wuqIj61tLrc4wSX0szH/Ev+nYRRuWlolflfl" crossorigin="anonymous">
<link href="/docs/5.0/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-eOJMYsd53ii+scO/bJGFsiCZc+5NDVN2yr8+0RDqr0Ql0h+rP48ckxlpbzKgwra6" crossorigin="anonymous">
<link href="/docs/5.0/assets/css/docs.css" rel="stylesheet">
@@ -193,6 +193,7 @@
<li><a href="/docs/5.0/getting-started/javascript/" class="d-inline-flex align-items-center rounded">JavaScript</a></li>
<li><a href="/docs/5.0/getting-started/build-tools/" class="d-inline-flex align-items-center rounded">Build tools</a></li>
<li><a href="/docs/5.0/getting-started/webpack/" class="d-inline-flex align-items-center rounded">Webpack</a></li>
<li><a href="/docs/5.0/getting-started/parcel/" class="d-inline-flex align-items-center rounded">Parcel</a></li>
<li><a href="/docs/5.0/getting-started/accessibility/" class="d-inline-flex align-items-center rounded">Accessibility</a></li>
<li><a href="/docs/5.0/getting-started/rfs/" class="d-inline-flex align-items-center rounded">RFS</a></li>
<li><a href="/docs/5.0/getting-started/rtl/" class="d-inline-flex align-items-center rounded">RTL</a></li>
@@ -289,6 +290,7 @@
<li><a href="/docs/5.0/components/modal/" class="d-inline-flex align-items-center rounded">Modal</a></li>
<li><a href="/docs/5.0/components/navs-tabs/" class="d-inline-flex align-items-center rounded">Navs &amp; tabs</a></li>
<li><a href="/docs/5.0/components/navbar/" class="d-inline-flex align-items-center rounded">Navbar</a></li>
<li><a href="/docs/5.0/components/offcanvas/" class="d-inline-flex align-items-center rounded">Offcanvas</a></li>
<li><a href="/docs/5.0/components/pagination/" class="d-inline-flex align-items-center rounded">Pagination</a></li>
<li><a href="/docs/5.0/components/popovers/" class="d-inline-flex align-items-center rounded">Popovers</a></li>
<li><a href="/docs/5.0/components/progress/" class="d-inline-flex align-items-center rounded">Progress</a></li>
@@ -405,6 +407,12 @@
</li>
<li><a href="#negative-margin">Negative margin</a></li>
<li><a href="#gap">Gap</a></li>
<li><a href="#sass">Sass</a>
<ul>
<li><a href="#maps">Maps</a></li>
<li><a href="#utilities-api">Utilities API</a></li>
</ul>
</li>
</ul>
</nav>
</div>
@@ -493,6 +501,152 @@
<span class="p">&lt;</span><span class="nt">div</span> <span class="na">class</span><span class="o">=</span><span class="s">&#34;p-2 bg-light border&#34;</span><span class="p">&gt;</span>Grid item 3<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
<span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span></code></pre></div>
<p>Support includes responsive options for all of Bootstrap&rsquo;s grid breakpoints, as well as six sizes from the <code>$spacers</code> map (<code>0</code>–<code>5</code>). There is no <code>.gap-auto</code> utility class as it&rsquo;s effectively the same as <code>.gap-0</code>.</p>
<h2 id="sass">Sass</h2>
<h3 id="maps">Maps</h3>
<p>Spacing utilities are declared via Sass map and then generated with our utilities API.</p>
<div class="highlight"><pre class="chroma"><code class="language-scss" data-lang="scss"><span class="nv">$spacer</span><span class="o">:</span> <span class="mi">1</span><span class="kt">rem</span><span class="p">;</span>
<span class="nv">$spacers</span><span class="o">:</span> <span class="p">(</span>
<span class="mi">0</span><span class="o">:</span> <span class="mi">0</span><span class="o">,</span>
<span class="mi">1</span><span class="o">:</span> <span class="nv">$spacer</span> <span class="o">/</span> <span class="mi">4</span><span class="o">,</span>
<span class="mi">2</span><span class="o">:</span> <span class="nv">$spacer</span> <span class="o">/</span> <span class="mi">2</span><span class="o">,</span>
<span class="mi">3</span><span class="o">:</span> <span class="nv">$spacer</span><span class="o">,</span>
<span class="mi">4</span><span class="o">:</span> <span class="nv">$spacer</span> <span class="o">*</span> <span class="mi">1</span><span class="mf">.5</span><span class="o">,</span>
<span class="mi">5</span><span class="o">:</span> <span class="nv">$spacer</span> <span class="o">*</span> <span class="mi">3</span><span class="o">,</span>
<span class="p">);</span>
<span class="nv">$negative-spacers</span><span class="o">:</span> <span class="nf">if</span><span class="p">(</span><span class="nv">$enable-negative-margins</span><span class="o">,</span> <span class="nf">negativify-map</span><span class="p">(</span><span class="nv">$spacers</span><span class="p">)</span><span class="o">,</span> <span class="n">null</span><span class="p">);</span>
</code></pre></div>
<h3 id="utilities-api">Utilities API</h3>
<p>Spacing utilities are declared in our utilities API in <code>scss/_utilities.scss</code>. <a href="/docs/5.0/utilities/api/#using-the-api">Learn how to use the utilities API.</a></p>
<div class="highlight"><pre class="chroma"><code class="language-scss" data-lang="scss"> <span class="s2">&#34;margin&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">m</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="nt">map-merge</span><span class="o">(</span><span class="err">$</span><span class="nt">spacers</span><span class="o">,</span> <span class="o">(</span><span class="nt">auto</span><span class="nd">:</span> <span class="nt">auto</span><span class="o">))</span>
<span class="o">),</span>
<span class="s2">&#34;margin-x&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-right</span> <span class="nt">margin-left</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">mx</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="nt">map-merge</span><span class="o">(</span><span class="err">$</span><span class="nt">spacers</span><span class="o">,</span> <span class="o">(</span><span class="nt">auto</span><span class="nd">:</span> <span class="nt">auto</span><span class="o">))</span>
<span class="o">),</span>
<span class="s2">&#34;margin-y&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-top</span> <span class="nt">margin-bottom</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">my</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="nt">map-merge</span><span class="o">(</span><span class="err">$</span><span class="nt">spacers</span><span class="o">,</span> <span class="o">(</span><span class="nt">auto</span><span class="nd">:</span> <span class="nt">auto</span><span class="o">))</span>
<span class="o">),</span>
<span class="s2">&#34;margin-top&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-top</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">mt</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="nt">map-merge</span><span class="o">(</span><span class="err">$</span><span class="nt">spacers</span><span class="o">,</span> <span class="o">(</span><span class="nt">auto</span><span class="nd">:</span> <span class="nt">auto</span><span class="o">))</span>
<span class="o">),</span>
<span class="s2">&#34;margin-end&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-right</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">me</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="nt">map-merge</span><span class="o">(</span><span class="err">$</span><span class="nt">spacers</span><span class="o">,</span> <span class="o">(</span><span class="nt">auto</span><span class="nd">:</span> <span class="nt">auto</span><span class="o">))</span>
<span class="o">),</span>
<span class="s2">&#34;margin-bottom&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-bottom</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">mb</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="nt">map-merge</span><span class="o">(</span><span class="err">$</span><span class="nt">spacers</span><span class="o">,</span> <span class="o">(</span><span class="nt">auto</span><span class="nd">:</span> <span class="nt">auto</span><span class="o">))</span>
<span class="o">),</span>
<span class="s2">&#34;margin-start&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-left</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">ms</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="nt">map-merge</span><span class="o">(</span><span class="err">$</span><span class="nt">spacers</span><span class="o">,</span> <span class="o">(</span><span class="nt">auto</span><span class="nd">:</span> <span class="nt">auto</span><span class="o">))</span>
<span class="o">),</span>
<span class="o">//</span> <span class="nt">Negative</span> <span class="nt">margin</span> <span class="nt">utilities</span>
<span class="s2">&#34;negative-margin&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">m</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">negative-spacers</span>
<span class="o">),</span>
<span class="s2">&#34;negative-margin-x&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-right</span> <span class="nt">margin-left</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">mx</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">negative-spacers</span>
<span class="o">),</span>
<span class="s2">&#34;negative-margin-y&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-top</span> <span class="nt">margin-bottom</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">my</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">negative-spacers</span>
<span class="o">),</span>
<span class="s2">&#34;negative-margin-top&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-top</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">mt</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">negative-spacers</span>
<span class="o">),</span>
<span class="s2">&#34;negative-margin-end&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-right</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">me</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">negative-spacers</span>
<span class="o">),</span>
<span class="s2">&#34;negative-margin-bottom&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-bottom</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">mb</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">negative-spacers</span>
<span class="o">),</span>
<span class="s2">&#34;negative-margin-start&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">margin-left</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">ms</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">negative-spacers</span>
<span class="o">),</span>
<span class="o">//</span> <span class="nt">Padding</span> <span class="nt">utilities</span>
<span class="s2">&#34;padding&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">padding</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">p</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">spacers</span>
<span class="o">),</span>
<span class="s2">&#34;padding-x&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">padding-right</span> <span class="nt">padding-left</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">px</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">spacers</span>
<span class="o">),</span>
<span class="s2">&#34;padding-y&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">padding-top</span> <span class="nt">padding-bottom</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">py</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">spacers</span>
<span class="o">),</span>
<span class="s2">&#34;padding-top&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">padding-top</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">pt</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">spacers</span>
<span class="o">),</span>
<span class="s2">&#34;padding-end&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">padding-right</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">pe</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">spacers</span>
<span class="o">),</span>
<span class="s2">&#34;padding-bottom&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">padding-bottom</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">pb</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">spacers</span>
<span class="o">),</span>
<span class="s2">&#34;padding-start&#34;</span><span class="nd">:</span> <span class="o">(</span>
<span class="nt">responsive</span><span class="nd">:</span> <span class="nt">true</span><span class="o">,</span>
<span class="nt">property</span><span class="nd">:</span> <span class="nt">padding-left</span><span class="o">,</span>
<span class="nt">class</span><span class="nd">:</span> <span class="nt">ps</span><span class="o">,</span>
<span class="nt">values</span><span class="nd">:</span> <span class="err">$</span><span class="nt">spacers</span>
<span class="o">),</span>
</code></pre></div>
</div>
</main>
@@ -508,11 +662,11 @@
<li class="d-inline-block ms-3"><a href="/docs/5.0/about/overview/">About</a></li>
</ul>
<p class="mb-0">Designed and built with all the love in the world by the <a href="/docs/5.0/about/team/">Bootstrap team</a> with the help of <a href="https://github.com/twbs/bootstrap/graphs/contributors">our contributors</a>.</p>
<p class="mb-0">Currently v5.0.0-beta2. Code licensed <a href="https://github.com/twbs/bootstrap/blob/main/LICENSE" target="_blank" rel="license noopener">MIT</a>, docs <a href="https://creativecommons.org/licenses/by/3.0/" target="_blank" rel="license noopener">CC BY 3.0</a>.</p>
<p class="mb-0">Currently v5.0.0-beta3. Code licensed <a href="https://github.com/twbs/bootstrap/blob/main/LICENSE" target="_blank" rel="license noopener">MIT</a>, docs <a href="https://creativecommons.org/licenses/by/3.0/" target="_blank" rel="license noopener">CC BY 3.0</a>.</p>
</div>
</footer>
<script src="/docs/5.0/dist/js/bootstrap.bundle.min.js" integrity="sha384-b5kHyXgcpbZJO/tY9Ul7kGkf1S0CWuKcCD38l8YkeH8z8QjE0GmW1gYU5S9FOnJ0" crossorigin="anonymous"></script>
<script src="/docs/5.0/dist/js/bootstrap.bundle.min.js" integrity="sha384-JEW9xMcG8R+pH31jmWH6WWP0WintQrMb4s7ZOdauHnUtxwoG2vI5DkLtS3qm9Ekf" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>