]> git.ipfire.org Git - thirdparty/bootstrap.git/commitdiff
Fixes #12487: Document required use of position relative for scrollspy
authorMark Otto <otto@github.com>
Sun, 9 Mar 2014 22:19:26 +0000 (15:19 -0700)
committerMark Otto <otto@github.com>
Sun, 9 Mar 2014 22:19:26 +0000 (15:19 -0700)
docs/javascript.html

index 48e07485adcbdbf8f5b839a380e885a7d5acba89..d3eeeb5c229196e1ea41221bde829621803f4274 100644 (file)
@@ -665,8 +665,16 @@ $('#myDropdown').on('show.bs.dropdown', function () {
 
   <h2 id="scrollspy-usage">Usage</h2>
 
+  <h3>Requires relative positioning</h3>
+  <p>No matter the implementation method, scrollspy requires the use of <code>position: absolute;</code> on the element you're spying on. In most cases this is the <code>&lt;body&gt;</code>.</p>
+
   <h3>Via data attributes</h3>
   <p>To easily add scrollspy behavior to your topbar navigation, add <code>data-spy="scroll"</code> to the element you want to spy on (most typically this would be the <code>&lt;body&gt;</code>). Then add the <code>data-target</code> attribute with the ID or class of the parent element of any Bootstrap <code>.nav</code> component.</p>
+{% highlight css %}
+body {
+  position: relative;
+}
+{% endhighlight %}
 {% highlight html %}
 <body data-spy="scroll" data-target=".navbar-example">
   ...
@@ -680,7 +688,7 @@ $('#myDropdown').on('show.bs.dropdown', function () {
 {% endhighlight %}
 
   <h3>Via JavaScript</h3>
-  <p>Call the scrollspy via JavaScript:</p>
+  <p>After adding <code>position: relative;</code> in your CSS, call the scrollspy via JavaScript:</p>
 {% highlight js %}
 $('body').scrollspy({ target: '.navbar-example' })
 {% endhighlight %}