如何在 twitter 的 bootstrap 2.1.0 中使用新的 affix 插件？答案

【问题标题】：How to use the new affix plugin in twitter's bootstrap 2.1.0?如何在 twitter 的 bootstrap 2.1.0 中使用新的 affix 插件？
【发布时间】：2012-08-17 17:59:15
【问题描述】：

关于该主题的引导文档让我有点困惑。我想在带有词缀导航栏的文档中实现类似的行为：导航栏位于段落/页面标题下方，向下滚动时，它应该首先滚动直到到达页面顶部，然后固定在那里以进一步向下滚动.

由于 jsFiddle 不适用于导航栏概念，我设置了一个单独的页面作为最小示例：http://i08fs1.ira.uka.de/~s_drr/navbar.html

我用它作为我的导航栏：

<div class="navbar affix-top" data-spy="affix" data-offset-top="50">
    <div class="navbar-inner">
        <div class="container">
            <div class="span12">
                <a class="brand" href="#">My Brand</a> 
                This is my navbar.
             </div>
        </div> <!-- container -->
    </div> <!-- navbar-inner -->
</div> <!-- navbar -->

我想我希望 data-offset-top 的值为 0（因为条形图应该“粘”在最顶端”，但 50 至少有一些效果可看。

如果也将javascript代码放在适当的位置：

     <script>
        $(document).ready (function (){
            $(".navbar").affix ();
        });
     </script>

任何帮助表示赞赏。

【问题讨论】：

您是否尝试在页面的主导航栏上使用 affix()？
@NithinEmmanuel 是的，请参阅帖子或示例中的 javascript：i08fs1.ira.uka.de/~s_drr/navbar.html
为什么不使用 .navbar-fixed-top 而不是使用 affix()？
@NithinEmmanuel 因为那不是我想要的。 .navbar-fixed-top会一直将导航栏置于顶部。我想要一个位于导航栏上方的页眉，并且当向下滚动时（因此导航栏会滚动），它应该粘在顶部 - 然后只有这样。 Bootstrap 文档在他们以前的文档中使用了与 subnav 完全相同的机制，遗憾的是他们已经为 2.1.0 文档删除了它。
一方面，您的 Javascript 嵌套不正确。 )}; 应该是 });

标签： css web twitter-bootstrap navbar

【解决方案1】：

第一次实现这个，这是我发现的。

data-offset-top 值是您必须滚动的像素数量，才能产生附加效果。在您的情况下，一旦滚动50px，您的项目上的类就会从.affix-top 更改为.affix。在您的用例中，您可能希望将 data-offset-top 设置为大约 130px。

一旦发生此类更改，您必须通过设置类.affix 的定位样式将元素定位在css 中。 Bootstrap 2.1 已经将.affix 定义为position: fixed;，所以你需要做的就是添加你自己的位置值。

例子：

.affix {
    position: fixed; 
    top: 20px; 
    left: 0px;
}

【讨论】：

谢谢，这有点工作。我已经更新了我的示例页面。现在的问题是，一旦导航栏作为 css 类获得“词缀”，导航栏 css 类就会被丢弃。但我认为这只是引导程序的一个错误/缺点。如果不使用 LESS 并重建引导程序，将不会很容易改变。
在我看来 .navbar 类被保留了 - 你确定吗？
感谢您的回答，我花了很长时间试图解决这个问题
请参阅 my answer 以获得稍微改进的更通用的解决方案。

【解决方案2】：

为了解决这个问题，我修改了 affix 插件以在对象被附加或未附加时发出 jQuery 事件。

这里是拉取请求：https://github.com/twitter/bootstrap/pull/4712

还有代码：https://github.com/corbinu/bootstrap/blob/master/js/bootstrap-affix.js

然后执行此操作以附加导航栏：

<script type="text/javascript">
$(function(){
    $('#navbar').on('affixed', function () {
        $('#navbar').addClass('navbar-fixed-top')
    });

    $('#navbar').on('unaffixed', function () {
        $('#navbar').removeClass('navbar-fixed-top')
    });
});
</script>

【讨论】：

【解决方案3】：

我附加导航栏的解决方案：

function affixnolag(){

    $navbar = $('#navbar');
    if($navbar.length < 1)
        return false;

    h_obj = $navbar.height();

    $navbar
        .on('affixed', function(){      
            $navbar.after('<div id="nvfix_tmp" style="height:'+h_obj+'px">');
        })
        .on('unaffixed', function(){
            if($('#nvfix_tmp').length > 0)
                $('#nvfix_tmp').remove();
        });
 }

【讨论】：

【解决方案4】：

您需要从脚本中删除 .affix()。

Bootstrap 提供了在大多数情况下通过 data-attributes 或直接 JavaScript 来完成任务的选项。

【讨论】：

【解决方案5】：

您只需要删除脚本。这是我的例子：

<!DOCTYPE html>
<html>

<head>
<script type="text/javascript" src="http://code.jquery.com/jquery-1.8.0.min.js"></script>
<script type="text/javascript" src="http://netdna.bootstrapcdn.com/twitter-bootstrap/2.1.0/js/bootstrap.min.js"></script>

  <style>
  #content {
    width: 800px;
    height: 2000px;
    background: #f5f5f5;
    margin: 0 auto;
  }
  .menu {
    background: #ccc;
    width: 200px;
    height: 400px;
    float: left;
  }
  .affix {
    position: fixed;
    top: 20px;
    left: auto;
    right: auto;
  }
  </style>

</head>
<body>
    <div id="content">
        <div style="height: 200px"></div>

        <div class="affix-top" data-spy="affix" data-offset-top="180">
            <div class="menu">AFFIX BAR</div>
        </div>
    </div>
</body>
</html>

【讨论】：

【解决方案6】：

我遇到了类似的问题，我相信我找到了改进的解决方案。

不要费心在 HTML 中指定 data-offset-top。相反，请在调用 .affix() 时指定它：

$('#nav').affix({
    offset: { top: $('#nav').offset().top }
});

这里的优点是您可以更改站点的布局而无需更新data-offset-top 属性。由于这使用了元素的实际计算位置，因此它还可以防止与将元素呈现在稍微不同的位置的浏览器不一致。

您仍然需要使用 CSS 将元素固定在顶部。此外，我不得不在导航元素上设置width: 100%，因为.nav 元素与position: fixed 出于某种原因行为不端：

#nav.affix {
    position: fixed;
    top: 0px;
    width: 100%;
}

最后一件事：当一个附加元素固定后，它的元素不再占用页面空间，导致它下面的元素“跳跃”。为了防止这种丑陋，我将导航栏包装在 div 中，我将其高度设置为在运行时等于导航栏：

<div id="nav-wrapper">
    <div id="nav" class="navbar">
        <!-- ... -->
    </div>
</div>

.

$('#nav-wrapper').height($("#nav").height());

Here's the obligatory jsFiddle to see it in action.

【讨论】：

删除“跳转”的好技巧 - 完全忽略了这个项目被删除的事实，并认为我的问题包含在我的代码的 affix/js 部分中。
这个答案是最好的！一切正常。 “跳转”部分是我发现的大多数教程中缺少的部分。谢谢！
一个重要的更正：在您的第一个代码 sn-p 中的 jquery 代码中使用 offset() 而不是 position()。说明： position() 函数为您提供父元素内的偏移量，但 offset() 是它在文档中的位置，这是您真正想要的（是的，名称是违反直觉的）。因此，如果您的 affix 元素在另一个元素内，您的代码将无法工作。您还应该只传递这样的“top”值： $("#nav").affix({ offset: { top: $('#nav').offset().top。它应该在 ready () 块，以便您知道页面布局已完成。
谢谢@orrd -- 更新我的答案和小提琴！
不错！完美运行，非常流畅。顺便说一句，我正在寻找带有粘性页脚的相同示例。如果你知道怎么做，你能更新 jsFiddle 吗？谢谢！

【解决方案7】：

我从 twitterbootstrap 的源代码中得到了这个，它工作得很好：

HTML：

<div class="row">
    <div class="span3 bs-docs-sidebar">
        <ul id="navbar" class="nav nav-list bs-docs-sidenav">
            ...
        </ul>
    </div>
</div>

CSS：

.bs-docs-sidenav {
    max-height: 340px;
    overflow-y: scroll;
}

.affix {
    position: fixed;
    top: 50px;
    width: 240px;
}

JS：

$(document).ready(function(){
    var $window = $(window);
    setTimeout(function () {
        $('.bs-docs-sidenav').affix({
            offset: {
                top: function (){
                    return $window.width() <= 980 ? 290 : 210
                }
            }
        })
    }, 100);
});

【讨论】：

【解决方案8】：

感谢 namuol 和 Dave Kiss 的解决方案。在我的情况下，当我一起使用 afflix 和折叠插件时，导航栏的高度和宽度有一个小问题。宽度问题可以很容易地从父元素（在我的例子中是容器）继承它来解决。我也可以设法用一点javascript（实际上是coffeescript）让它顺利折叠。诀窍是在折叠切换发生之前将包装高度设置为auto，然后再将其修复。

标记（haml）：

#wrapper
  #navbar.navbar
    .navbar-inner
      %a.btn.btn-navbar.btn-collapse
        %span.icon-bar
        %span.icon-bar
        %span.icon-bar

      #menu.nav-collapse
        -# Menu goes here

CSS：

#wrapper {
  width: inherit;
}

#navbar {
  &.affix {
    top: 0;
    width: inherit;
  }
}

咖啡脚本：

class Navigation
  @initialize: ->
    @navbar = $('#navbar')
    @menu = $('#menu')
    @wrapper = $('#wrapper')

    @navbar.affix({offset: @navbar.position()})
    @adjustWrapperHeight(@navbar.height())

    @navbar.find('a.btn-collapse').on 'click', () => @collapse()

    @menu.on 'shown', () => @adjustWrapperHeight(@navbar.height())
    @menu.on 'hidden', () => @adjustWrapperHeight(@navbar.height())

  @collapse: ->
    @adjustWrapperHeight("auto")
    @menu.collapse('toggle')

  @adjustWrapperHeight: (height) ->
    @wrapper.css("height", height)

$ ->
  Navigation.initialize()

【讨论】：

【解决方案9】：

与接受的答案类似，您也可以执行以下操作来一次性完成所有操作：

$('#nav').affix({
  offset: { top: $('#nav').offset().top }
}).wrap(function() {
  return $('<div></div>', {
    height: $(this).outerHeight()
  });
});

这不仅会调用affix 插件，还会将附加的元素包装在一个div中，从而保持导航栏的原始高度。

【讨论】：