# Sition

**Repository Path**: lovefc/Sition

## Basic Information

- **Project Name**: Sition
- **Description**: 轻量级JS原生触屏位置操作插件--Sition，支持移动端上下左右中的滑动判断，还有长按，以及双击事件。
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://lovefc.gitee.io/sition
- **GVP Project**: No

## Statistics

- **Stars**: 73
- **Forks**: 15
- **Created**: 2018-10-14
- **Last Updated**: 2025-08-25

## Categories & Tags

**Categories**: javascript-toolkits

**Tags**: None

## README

**js原生触屏位置操作插件--Sition** 

- 一款轻量级的移动触屏手势操作js插件,使用简单方便,支持多种判断操作
- https://gitee.com/lovefc/fmusic 移动端手势音乐播放器项目地址
- 在线演示：https://lovefc.gitee.io/sition

**如何使用：** 
- ` Sition(dom,action,function,debug) `


**参数：** 

|参数名|必选|类型|说明|
|:----    |:---|:----- |-----   |
| dom | 否  |string | 元素id名,为空代表整个body页面   |
| action  | 是  |string | 要执行的动作名称   |
| function | 是  |function | 执行后的回调函数   |
| debug | 否  | bool | 开启调试，true为开启   |

**action 动作参数说明：** 

|参数名|说明|
|---  | ---|  
| long | 长按操作 |
| clicked | 双击操作 |
| up | 向上滑动 |
| upLeft | 向上滑动-左边 |
| upRight | 向上滑动-右边 |
| down | 向下滑动 |
| downLeft | 向下滑动-左边 |
| downRight | 向下滑动-右边 |
| left | 向左滑动 |
| leftUp | 向左滑动-顶部 |
| leftDown | 向左滑动-底部 |
| right | 向右滑动 |
| rightUp | 向右滑动-顶部 |
| rightDown | 向右滑动-底部 |
| upCenter | 向上滑动-居中 |
| downCenter | 向下滑动-居中 |
| leftCenter | 向左滑动-居中 |
| rightCenter | 向右滑动-居中 |
| 方向+Ing | 表示滑动的整个过程 |

**关于正在滑动（方向+Ing）** 

- 举例： ` Sition(dom,'upIng',function(){console.log(11);}) `

在方向后面加上Ing，表示的都是整个向下滑动过程中，函数会一直执行下去，直到你的手指离开了屏幕

**注意事项** 
 
- 要确保dom有高度和宽度，不然无法判断，默认读取的是body元素，body元素也要有高度和宽度

**前端调试**
- 可以使用谷歌浏览器自带的移动端模拟功能在电脑上调试

 ![](https://www.showdoc.cc/server/api/common/visitfile/sign/2a419bd9617cb07925d3867055df781a?showdoc=.jpg)

**作者备注**
- 如果发现问题，欢迎向我反馈，毕竟一个人测试有限，会有注意不到的地方。
- 作者QQ：1102952084
- 作者博客：lovefc.cn