开发
API

tt.setSwipeBackMode

基础库 2.6.0 开始支持本方法,低版本需做 兼容处理,这是一个同步方法。

设置滑动返回的模式。

语法

tt.setSwipeBackMode(mode);

参数说明

mode

类型默认值必填说明最低支持版本
number0滑动返回的模式,含义参考下表2.6.0

值的具体含义如下:

枚举值含义
0禁止所有滑动返回方式
1允许边缘、全屏滑动返回
2仅允许边缘滑动返回

返回值

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

TTML

<view class="page-section">
  <view class="section-title">实践场景</view>
  <view class="desc">
    除满足一般的业务需求外,可以用来修复组件的手势冲突问题。在 Android
    系统运行时,对于组件的拖动可能和边缘退出检测发生冲突。
  </view>
  <view class="desc">
    下面以 slider 组件为例,通过在 touchstart 时机关闭滑动返回,在 touchend
    时机启用滑动返回来解决问题:
  </view>
  <slider bindtouchstart="disableSwipe" bindtouchend="enableSwipe" value="10" />
</view>

JavaScript

Page({
  disableSwipe() {
    tt.setSwipeBackMode(0);
  },
  enableSwipe() {
    tt.setSwipeBackMode(1);
  },
});

Bug & Tip

  • Tip:由于 Android 平台不支持全屏手势返回,因此在 Android 中设置 mode = 1,在效果上与设置 mode = 2 相同。
  • Tip:API 设置的优先级高于页面 disableSwipeBack 配置。
点击纠错
评价此篇文档