当跳转到页面上的不同部分时平滑滚动。
只需将uk-scroll
属性添加到任何包含URL片段的页面内部链接,即可添加平滑滚动行为。
<a href="#my-id" uk-scroll></a>
粘性元素的高度,例如粘性导航栏,会自动添加为滚动目标的偏移量,使其不会被粘性元素覆盖。
要在直接链接到页面上的特定部分时定义通用偏移量,请添加offset
选项。
<a href="#my-id" uk-scroll="offset: 100"></a>
如果已经有粘性元素的偏移量,则会累加上offset
选项。
要在滚动完成后接收回调,您可以监听触发滚动的链接元素上的scrolled
事件。
<a id="js-scroll-trigger" href="#my-id" uk-scroll></a>
UIkit.util.on('#js-scroll-trigger', 'scrolled', function () {
alert('Done.');
});
<a id="js-scroll-trigger" class="uk-button uk-button-primary" href="#target" uk-scroll>Down with callback</a>
<script>
UIkit.util.on('#js-scroll-trigger', 'scrolled', function () {
alert('Done.');
});
</script>
任何这些选项都可以应用于组件属性。用分号分隔多个选项。了解更多
选项 | 值 | 默认值 | 描述 |
---|---|---|---|
offset |
数字 | 0 |
添加到滚动顶部的偏移量。 |
了解有关JavaScript组件的更多信息。
UIkit.scroll(element, options);
以下事件将在附加此组件的元素上触发
名称 | 描述 |
---|---|
beforescroll |
在滚动开始之前触发。可以通过在事件上调用preventDefault() 来阻止滚动。 |
scrolled |
滚动完成后触发。 |
以下方法可用于该组件
UIkit.scroll(element).scrollTo(el);
滚动到给定元素。
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
el |
节点,选择器 | 未定义 | 要滚动到的元素。 |