视差扩展

视差扩展

使用视差选项前请先阅读 扩展的使用

HTML

为了在代码段和幻灯片中使用视差效果,必须将一个空div新元素添加到类fp-bg中,作为该代码段或幻灯片的第一个子段。 如下所示:

<div class="fp-bg"></div>

这是您必须应用在背景中的元素,而不是其所属的代码段或幻灯片。

例如:

<div id="fullpage">
    <div class="section" id="section1">
        <div class="fp-bg"></div>
        幻灯片 1.1
    </div>
    <div class="section" id="section2">
        <div class="slide" id="slide2-1">
            <div class="fp-bg"></div>
            幻灯片  2.1
        </div>
        <div class="slide" id="slide2-2">
            <div class="fp-bg"></div>
            幻灯片 2.2
        </div>
    </div>
</div>

这个结构可以在视差演示页面的源代码中看到。

如果出于其他原因,您真的不想在布局中添加新元素,则可以将parallaxOptions中的选项property设置为background,以便将效果应用于当前段落或幻灯片背景。 正如“视差效果选项”中所解释的,如果真的有必要,我只推荐这样做,因为性能不会像使用fp-bg元素时那样。

应用背景

应用于fp-bg元素的背景应与将其应用于段落或幻灯片的方式相同。 您可以使用CSS或内联样式。

例如:

#section1 .fp-bg{
    background-image: url('imgs/alvaro-genious.jpg');
    background-size: cover;
    background-position: center 80%;
}

选项

选项说明
parallax(默认为 false). fullPage.js的扩展。. 定义是否在段落/幻灯片上使用视差背景效果。
parallaxOptions:(默认: { type: 'reveal', percentage: 62, property: 'translate'}). 当使用选项parallax:true时,表示允许配置视差背景效果的参数

视差效果选项

可以在演示页面看到运行效果

在选项parallaxOptions中可用的可配置选项说明:

parallaxOptions描述
type(默认 reveal) 可用值是coverreveal。提供选择当前段落/幻灯片是高于还是低于目标页面的方法。当使用cover时,下一段落或幻灯片将会覆盖当前的部分页面。使用reveal仅是反转的效果,并在显示时覆盖了小部分目标页面
percentage(默认值 62 ) 提供一种方法来定义与视口相关的视差效果的百分比。数值越小,视差效果越小,而最大值为100的图像则为完全静态的背景。
property定义我们是否要将视差效果应用于fp-bg元素,或者直接应用于段落或幻灯片的背景属性。建议使用此选项的默认值。

请注意,使用fp-bg元素可以获得更好的性能,因为它利用了translate3d硬件加速。该选项适用于那些由于某种原因不想在每个段落或幻灯片中添加额外的fp-bg元素或无法修改HTML标记的人。

方法

可以在演示页面查看运行效果。

setOption(optionName, value)

为给定选项设一个值。optionName 可以是parallaxOptions中的任意选项 (type, percentageproperty).

//改变属性`type`的值
fullpage_api.parallax.setOption('type', 'cover');

//改变属性`percentage`的值
fullpage_api.parallax.setOption('percentage', '30');

init()

启用视差效果。如果您需要在某个特定时间点动态启用该功能,可以调用这个方法。

fullpage_api.parallax.init();

destroy()

关闭视差效果。

fullpage_api.parallax.destroy();