fritzmg / contao-nivo-lightbox
1.3.0
2017-11-10 19:22 UTC
Requires
- php: >=5.2
- contao-community-alliance/composer-plugin: ^2.4|^3.0
- contao/core-bundle: ^3.0|^4.4
Replaces
- contao-legacy/nivo_lightbox: 1.3.0
README
Contao Nivo Lightbox
Contao扩展,用于集成Nivo Lightbox覆盖。
使用方法
只需在页面布局中的jQuery下激活j_nivo_lightbox
模板。不要同时激活j_colorbox
或moo_mediabox
!覆盖层将与所有使用data-lightbox="..."
参数的链接一起工作。
自定义
如果您想使用自己的自定义参数,只需创建自己的j_nivo_lightbox
模板,并在该行插入您的自定义选项。
// init nivo lightbox $links.nivoLightbox();
有关所有可用参数的详细信息,请参阅Nivo Lightbox文档。
类型
默认情况下,Nivo Lightbox充当图片覆盖层。Nivo Lightbox还允许您通过AJAX或iframe打开URL。或者,您可以通过引用HTML元素的ID在覆盖层中显示现有的HTML。此扩展提供了一种初始化机制,因此大多数用例仍然可以通过Contao中常见的data-lightbox
参数进行控制。
通过iframe显示页面
<a href="page.html" data-lightbox="iframe">...</a>
通过AJAX加载页面
<a href="page.html" data-lightbox="ajax">...</a>
在覆盖层中显示某些HTML元素
<a href="#some-element" data-lightbox="inline">...</a>
在某些情况下,您可能需要强制将href显示为图片,例如,如果href的结尾不是jpeg
、jpg
、gif
或png
。
<a href="http://placehold.it/350x150" data-lightbox="image">...</a> <a href="http://placehold.it/350x150" data-lightbox-type="image">...</a>
在Nivo Lightbox文档中提到的所有常规参数都应该正常工作。如果您在HTML源中不提供这些参数,则扩展程序将默认在iframe中打开任何非图片URL。