dev7ch/drupal-swiper

Drupal 8 的 Swiper 集成,从 https://cgit.drupalcode.org/swiper 克隆而来

安装: 13

依赖者: 0

建议者: 0

安全: 0

星标: 2

关注者: 2

分支: 0

公开问题: 0

类型:drupal-module

dev-master 2019-01-29 18:26 UTC

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

安装

依赖项

任务

  1. https://github.com/nolimits4web/Swiper 下载 Swiper 库(要使用 Composer,请参阅下文 Composer 部分)
  2. 解压文件并将文件夹重命名为 "Swiper"(注意字母的大小写)
  3. 将文件夹放在以下位置之一(相对于 drupal 根目录)。
    • libraries
    • profiles/PROFILE-NAME/libraries
    • sites/all/libraries
    • sites/SITE-NAME/libraries
  4. 以下文件是必需的(最后一个文件是用于 JavaScript 调试必需的)
    • dist/js/swiper.jquery.min.js
    • dist/js/swiper.min.js
    • dist/css/swiper.min.css
  5. 确保您有类似以下路径的有效路径用于所有文件
    • 例如:libraries/Swiper/dist/js/swiper.jquery.min.js

就这样!

Composer

可以使用 Composer 以以下方式下载库...

  1. 将以下内容添加到 composer.json 的 require 部分 "nolimits4web/Swiper": "3.4.2"

  2. 将以下内容添加到 composer.json 的 installer-paths 部分(如果尚未添加) "libraries/{$name}": ["type:drupal-library"]

  3. 将以下内容添加到 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" } } }

  4. 打开命令行终端,导航到与您的 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选项。

外部链接