runopencode / dm-jcarousellite-behavior-plugin
dmJCarouselLiteBehaviorPlugin - Diem Extended 的折叠前行为
Requires
- composer/installers: dev-master
This package is auto-updated.
Last update: 2022-02-01 12:22:46 UTC
README
作者: TheCelavi
版本: 1.0.0
稳定性: 稳定
日期: 2012年12月15日
由 Run Open Code 提供
许可证: 免费
dmJCarouselLiteBehaviorPlugin for Diem Extended 是 jCarouselLite jQuery 插件的适配版本。
请注意,该网站最近被标记为恶意软件。此外,为了使 jQuery 插件作为行为工作,需要进行修改和调整,才能升级。
使用方法
使用此轮播图最简单、最直接的方法是将小部件添加到区域中,并将 dmJCarouselLiteBehaviorPlugin 绑定到该区域。这种行为将每个小部件变成轮播图元素。
但是,它可以与任何具有以下结构的 HTML 元素一起工作
<container>
<carousel-element></carousel-element>
<carousel-element></carousel-element>
<carousel-element></carousel-element>
<carousel-element></carousel-element>
.....
</container>
为了实现这一点,您必须指定 <container>
标签的 Inner target
选择器,以便轮播图可以识别其元素。
请注意,在此示例中,如 container
和 carousel-element
这样的标签只是示例,当然,任何 HTML 结构都将工作,例如使用 DIV
或可能使用 UL
和 LI
。
HTML 输出
该行为不会更改结构。如果设置为这样做,它将添加导航和分页器。
配置和主题化
在 dmJCarouselLiteBehaviorPlugin/config/dm/config.yml
中是此行为的配置参数。
default:
dmJCarouselLiteBehavior:
defaults: # Default settings for behavior
inner_target: ''
theme: default
item_width: 100
item_height: 100
mouse_wheel: true
auto_scroll: false
auto_scroll_period: 500
hover_pause: true
speed: 500
easing: jswing
is_vertical: false
is_circular: true
visible: 1
scroll: 1
pager: bottom
navigation: bottom
labels:
auto_scroll_period: Auto scroll interval
speed: Scroll speed
hover_pause: Pause on hover
helps:
auto_scroll: Auto scroll items
auto_scroll_period: Interval in ms between two auto scrolling
mouse_wheel: Enable/disable mouse wheel for scrolling
speed: Speed of scrolling animation in ms
scroll: Number of items to scroll at once
hover_pause: Mouse hover pause scrolling when auto scroll is set to true
visible: Number of visible items
themes:
default: 'dmJCarouselLiteBehaviorPlugin.default' # From assets.yml - U can use a path instead
如果您通过 Github 下载了行为,您可以修改此文件。如果您通过 Composer 安装,则必须使用 Symfony 配置级联来覆盖这些设置。
“defaults”部分包含行为的默认设置,这是行为表单最初显示的内容。如果您想将某些设置显示为默认值,请更改此位置。
“labels”部分包含行为表单设置字段的标签,“helps”部分包含表单字段的帮助信息。
“themes”部分用于主题,它配置为 theme_key: path_to_css_file
。如果用户在行为表单中选择“默认”主题,则折叠视图 HTML 结构将如下所示
<div class="dmJCarouselLiteBehaviorPlugin default">
.... other HTML content
</div>
请注意,已添加一个 default
类,即主题密钥。当然,主题 CSS 文件也将被加载。因此,您只需为主题化即可。
默认主题
使用此行为,提供了带有默认主题的 LESS 文件。LESS 文件提供了结构的洞察力,它应该有助于您进行主题化。
重要提示
jCarouselLite 可以是循环的或非循环的。关于 visible
和 scroll
参数的各种设置可能导致与分页符的各种行为。
对于非循环的,重要的是要知道,当可滚动的项目少于可见项目时,已实现故障安全策略。例如,如果可见项目是6,滚动项目也是6,而你有9个项目 - 行为将添加3个额外的 <div class="empty"/>
标签。
对于循环的,没有实施这种策略,这在从第一项切换到最后一项和反之亦然时会导致分页符出现故障。分页符将显示为第一页。对此没有逻辑修复 - 显示第一还是最后一项?所以,第一项被设置为。