移动端单页视图库,适用于制作移动Web touchbox

ouchBox

原文:https://github.com/maxzhang/touchbox

移动端单页视图库,适用于制作移动专题

DEMO

http://jsbin.com/vatuma/latest

手机扫描下面二维码查看例子:

demo qrcode

使用方法

首先,页面必须是下面的结构

<html>
    // ...
    <body>
        <div id="touchBoxCt">
            <div>
                // 子视图1
            </div>
            <div>
                // 子视图2
            </div>
            <div>
                // 子视图3
            </div>
        </div>
    </body>
</html>

初始CSS,除以下两个样式之外,TouchBox不依赖任何其他样式

/* 如果不将body的margin设为0,会导致视图高宽计算不准确 */
body, div {
    margin: 0;
    padding: 0;
}
new TouchBox('#touchBoxCt', {
    loop: true,
    animation: 'flow'
});

配置参数 Configs

itemSelector : String

子视图选择器,默认'',如果设置,则使用选择器选中的子元素进行视图切换

active : Number

首视图索引,默认0,默认为第一个子元素

loop : Boolean

子视图切换是否可以循环切换,默认false

animation : String

视图切换的动画效果,默认'flow',取值范围:'slide'、'flow'

duration : Number

视图切换动画时间,默认400,单位ms

lockScreen : String

锁屏状态,默认'off',取值:

  • 'off' 不锁屏
  • 'landscape' 锁定为横屏
  • 'portrait' 锁定为竖屏

rotateBody : String/Function

锁屏提示,当lockScreen不为'off'时有效。

当值为String时,HTML字符串会被插入到页面并显示。

当值为Function时,函数的返回值会被被插入到页面并显示。

beforeSlide : Function 已弃用,使用事件接口替代

子视图开始切换时回调函数,如果返回值为false,则终止当次切换操作。

回调函数参数:

  • toIndex 切换到视图索引
  • active 当前视图索引

onSlide : Function 已弃用,使用事件接口替代

子视图切换结束时回调函数

回调函数参数:

  • active 当前视图索引

onResize : Function 已弃用,使用事件接口替代

当TouchBox高宽被重置时调用。

回调函数参数:

  • width 高度
  • height 宽度

scope: Object

回调函数的作用域

事件 Event

回调函数事件监听方法:

boxer.on('beforeslide', function(toIndex, activeIndex) {
    console.log('beforeslide, ', 'to index:', toIndex, ' current index:', activeIndex);
});

touchstart

touchstart事件,返回false则中止本次touch动作。

回调函数参数:

  • active 当前视图索引

touchmove

touchmove事件,返回false则中止视图偏移。

回调函数参数:

  • active 当前视图索引
  • offsetY Y轴位置偏移量,大于0表示手指向上移动,小于0表示手指向下移动

touchend

touchend事件,返回false则中止视图切换,将视图重置为当前视图。

回调函数参数:

  • active 当前视图索引
  • offsetY Y轴位置偏移量,大于0表示手指向上移动,小于0表示手指向下移动

beforeslide

子视图开始切换时回调函数,如果返回值为false,则终止当次切换操作。

回调函数参数:

  • toIndex 切换到视图索引
  • active 当前视图索引

slide

子视图切换结束时回调函数

回调函数参数:

  • active 当前视图索引

resize

当TouchBox高宽被重置时调用

回调函数参数:

  • width 高度
  • height 宽度
posted @   创业男生  阅读(446)  评论(0编辑  收藏  举报
编辑推荐:
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
阅读排行:
· 周边上新:园子的第一款马克杯温暖上架
· Open-Sora 2.0 重磅开源!
· .NET周刊【3月第1期 2025-03-02】
· 分享 3 个 .NET 开源的文件压缩处理库,助力快速实现文件压缩解压功能!
· [AI/GPT/综述] AI Agent的设计模式综述
点击右上角即可分享
微信分享提示