diff options
| author | XhmikosR <[email protected]> | 2021-09-07 18:43:13 +0300 |
|---|---|---|
| committer | GitHub <[email protected]> | 2021-09-07 18:43:13 +0300 |
| commit | dfb3a02ca8b4393ec4dc4b5368da0150bd681d1e (patch) | |
| tree | fa7b3e61b0035129e8b498f27b0785f90b775662 /docs/5.1/utilities/interactions/index.html | |
| parent | 592ba5f4df83c4a1cc2c6de5ba93abbc4d237be1 (diff) | |
| download | bootstrap-gh-pages.tar.xz bootstrap-gh-pages.zip | |
Add v5.1.1 docs (#34870)gh-pages
Diffstat (limited to 'docs/5.1/utilities/interactions/index.html')
| -rw-r--r-- | docs/5.1/utilities/interactions/index.html | 22 |
1 files changed, 13 insertions, 9 deletions
diff --git a/docs/5.1/utilities/interactions/index.html b/docs/5.1/utilities/interactions/index.html index 9f6045a18..982edc07e 100644 --- a/docs/5.1/utilities/interactions/index.html +++ b/docs/5.1/utilities/interactions/index.html @@ -5,7 +5,7 @@ <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="description" content="Utility classes that change how users interact with contents of a website."> <meta name="author" content="Mark Otto, Jacob Thornton, and Bootstrap contributors"> -<meta name="generator" content="Hugo 0.87.0"> +<meta name="generator" content="Hugo 0.88.1"> <meta name="docsearch:language" content="en"> <meta name="docsearch:version" content="5.1"> @@ -17,7 +17,7 @@ <!-- Bootstrap core CSS --> -<link href="/docs/5.1/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-KyZXEAg3QhqLMpG8r+8fhAXLRk2vvoC2f3B09zVXn8CA5QIVfZOJ3BCsw2P0p/We" crossorigin="anonymous"> +<link href="/docs/5.1/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-F3w7mX95PdgyTmZZMECAngseQB83DfGTowi0iMjiWaeVhAn4FJkqJByhZMI3AhiU" crossorigin="anonymous"> <link href="/docs/5.1/assets/css/docs.css" rel="stylesheet"> @@ -149,7 +149,7 @@ <span class="d-none d-lg-inline">Bootstrap</span> v5.1 </button> <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="bd-versions"> - <li><a class="dropdown-item current" aria-current="true" href="/docs/5.1/">Latest (5.0.x)</a></li> + <li><a class="dropdown-item current" aria-current="true" href="/docs/5.1/">Latest (5.1.x)</a></li> <li><hr class="dropdown-divider"></li> <li><a class="dropdown-item" href="https://getbootstrap.com/docs/4.6/">v4.6.x</a></li> <li><a class="dropdown-item" href="https://getbootstrap.com/docs/3.4/">v3.4.1</a></li> @@ -421,10 +421,14 @@ </div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-html" data-lang="html"><span class="p"><</span><span class="nt">p</span><span class="p">><</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">"#"</span> <span class="na">class</span><span class="o">=</span><span class="s">"pe-none"</span> <span class="na">tabindex</span><span class="o">=</span><span class="s">"-1"</span> <span class="na">aria-disabled</span><span class="o">=</span><span class="s">"true"</span><span class="p">></span>This link<span class="p"></</span><span class="nt">a</span><span class="p">></span> can not be clicked.<span class="p"></</span><span class="nt">p</span><span class="p">></span> <span class="p"><</span><span class="nt">p</span><span class="p">><</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">"#"</span> <span class="na">class</span><span class="o">=</span><span class="s">"pe-auto"</span><span class="p">></span>This link<span class="p"></</span><span class="nt">a</span><span class="p">></span> can be clicked (this is default behavior).<span class="p"></</span><span class="nt">p</span><span class="p">></span> <span class="p"><</span><span class="nt">p</span> <span class="na">class</span><span class="o">=</span><span class="s">"pe-none"</span><span class="p">><</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">"#"</span> <span class="na">tabindex</span><span class="o">=</span><span class="s">"-1"</span> <span class="na">aria-disabled</span><span class="o">=</span><span class="s">"true"</span><span class="p">></span>This link<span class="p"></</span><span class="nt">a</span><span class="p">></span> can not be clicked because the <span class="p"><</span><span class="nt">code</span><span class="p">></span>pointer-events<span class="p"></</span><span class="nt">code</span><span class="p">></span> property is inherited from its parent. However, <span class="p"><</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">"#"</span> <span class="na">class</span><span class="o">=</span><span class="s">"pe-auto"</span><span class="p">></span>this link<span class="p"></</span><span class="nt">a</span><span class="p">></span> has a <span class="p"><</span><span class="nt">code</span><span class="p">></span>pe-auto<span class="p"></</span><span class="nt">code</span><span class="p">></span> class and can be clicked.<span class="p"></</span><span class="nt">p</span><span class="p">></span></code></pre></div> -<div class="bd-callout bd-callout-warning"> -The <code>.pe-none</code> class (and the <code>pointer-events</code> CSS property it sets) only prevents interactions with a pointer (mouse, stylus, touch). Links and controls with <code>.pe-none</code> are, by default, still focusable and actionable for keyboard users. To ensure that they are completely neutralized even for keyboard users, you may need to add further attributes such as <code>tabindex="-1"</code> (to prevent them from receiving keyboard focus) and <code>aria-disabled="true"</code> (to convey the fact they are effectively disabled to assistive technologies), and possibly use JavaScript to completely prevent them from being actionable. For form controls, consider using the <code>disabled</code> HTML attribute instead. -</div> - +<p>The <code>.pe-none</code> class (and the <code>pointer-events</code> CSS property it sets) only prevents interactions with a pointer (mouse, stylus, touch). Links and controls with <code>.pe-none</code> are, by default, still focusable and actionable for keyboard users. To ensure that they are completely neutralized even for keyboard users, you may need to add further attributes such as <code>tabindex="-1"</code> (to prevent them from receiving keyboard focus) and <code>aria-disabled="true"</code> (to convey the fact they are effectively disabled to assistive technologies), and possibly use JavaScript to completely prevent them from being actionable.</p> +<p>If possible, the simpler solution is:</p> +<ul> +<li>For form controls, add the <code>disabled</code> HTML attribute.</li> +</ul> +<ul> +<li>For links, remove the <code>href</code> attribute, making it a non-interactive anchor or placeholder link.</li> +</ul> <h2 id="sass">Sass</h2> <h3 id="utilities-api">Utilities API</h3> <p>Interaction utilities are declared in our utilities API in <code>scss/_utilities.scss</code>. <a href="/docs/5.1/utilities/api/#using-the-api">Learn how to use the utilities API.</a></p> @@ -455,7 +459,7 @@ The <code>.pe-none</code> class (and the <code>pointer-events</code> CSS propert <ul class="list-unstyled small text-muted"> <li class="mb-2">Designed and built with all the love in the world by the <a href="/docs/5.1/about/team/">Bootstrap team</a> with the help of <a href="https://github.com/twbs/bootstrap/graphs/contributors">our contributors</a>.</li> <li class="mb-2">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>.</li> - <li class="mb-2">Currently v5.1.0.</li> + <li class="mb-2">Currently v5.1.1.</li> </ul> </div> <div class="col-6 col-lg-2 offset-lg-1 mb-3"> @@ -502,7 +506,7 @@ The <code>.pe-none</code> class (and the <code>pointer-events</code> CSS propert </div> </footer> - <script src="/docs/5.1/dist/js/bootstrap.bundle.min.js" integrity="sha384-U1DAWAznBHeqEIlVSCgzq+c9gqGAJn5c/t99JyeKa9xxaYpSvHU5awsuZVVFIhvj" crossorigin="anonymous"></script> + <script src="/docs/5.1/dist/js/bootstrap.bundle.min.js" integrity="sha384-/bQdsTh/da6pkI1MST/rWKFNjaCP5gBSY4sEBT38Q/9RBh9AH40zEOg7Hlq2THRZ" crossorigin="anonymous"></script> <script src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script> |
