dev7ch / drupal-swiper
Drupal 8 的 Swiper 集成,从 https://cgit.drupalcode.org/swiper 克隆而来
This package is auto-updated.
Last update: 2024-09-21 02:17:52 UTC
README
将 Swiper 库集成到 Drupal 中。
当前选项
允许您以几种不同的方式使用 Swiper
- 作为一个库,可以通过调用 swiper_add() 来与其他主题或模块一起使用(注意:这返回一个数组,用于在您自己的渲染数组中作为 #attached 使用)。
- 与字段集成(swiper_fields)
- 添加一个视图显示模式(swiper_views)
关于 Swiper
库可在以下地址找到:https://github.com/nolimits4web/Swiper
安装
依赖项
任务
- 从 https://github.com/nolimits4web/Swiper 下载 Swiper 库(要使用 Composer,请参阅下文 Composer 部分)
- 解压文件并将文件夹重命名为 "Swiper"(注意字母的大小写)
- 将文件夹放在以下位置之一(相对于 drupal 根目录)。
- libraries
- profiles/PROFILE-NAME/libraries
- sites/all/libraries
- sites/SITE-NAME/libraries
- 以下文件是必需的(最后一个文件是用于 JavaScript 调试必需的)
- dist/js/swiper.jquery.min.js
- dist/js/swiper.min.js
- dist/css/swiper.min.css
- 确保您有类似以下路径的有效路径用于所有文件
- 例如:libraries/Swiper/dist/js/swiper.jquery.min.js
就这样!
Composer
可以使用 Composer 以以下方式下载库...
-
将以下内容添加到 composer.json 的 require 部分
"nolimits4web/Swiper": "3.4.2"
-
将以下内容添加到 composer.json 的 installer-paths 部分(如果尚未添加)
"libraries/{$name}": ["type:drupal-library"]
-
将以下内容添加到 composer.json 的 repositories 部分(版本可能不同)
{ "type": "package", "package": { "name": "nolimits4web/Swiper", "version": "3.4.2", "type": "drupal-library", "source": { "url": "https://github.com/nolimits4web/Swiper/archive/master.zip", "type": "zip" } } }
-
打开命令行终端,导航到与您的 composer.json 文件相同的目录,并运行
composer update
Drush Make
您还可以使用 Drush Make 自动下载库。只需将 'swiper.make.example' 复制到 'swiper.make' 或将 make 文件的内容复制到您自己的 make 文件中。
用法
选项
无论您如何想使用 Swiper(与字段或视图一起使用)您都需要定义 "选项",以告诉 Swiper 您希望它如何显示。一个选项定义了显示滑块的设置。例如,滑块方向、速度、起始幻灯片等。您可以定义任意多的选项,而且它们都可以导出!这意味着您可以将您的 wiper 实例的配置从一个站点带到下一个站点,或者创建功能。
转到 admin/config/media/swiper
从那里您可以编辑默认选项并定义新的选项。这些选项将在您设置 Swiper 显示的各个表单中列出。
Swiper 视图
Swiper 视图允许您构建显示其结果的视图。类似于您可以将字段作为 "HTML 列表" 或 "表格" 输出,您现在可以选择 "Swiper" 作为选项。
调试
您可以在管理设置页面上切换库的开发版本。这将加载库的非压缩版本。当转移到生产站点时,取消选中以加载更小的压缩版本。
导出API
您可以通过访问admin/config/development/configuration/single/export并选择Swiper选项作为配置类型,使用D8配置管理导出您的Swiper选项。
外部链接
- [Swiper的Wiki文档] (http://idangero.us/swiper/api)