2 Star 0 Fork 0

react-component/gesture

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

rc-gesture


Support gesture for react component, inspired by hammer.js and AlloyFinger.

NPM version build status Test coverage gemnasium deps node version npm download

Screenshots

Features

Install

npm install --save rc-gesture

rc-gesture

Usage

import Gesture from 'rc-gesture';

ReactDOM.render(
  <Gesture
    onTap={(gestureStatus) => { console.log(gestureStatus); }}
  >
    <div>container</div>
  </Gesture>,
container);

API

all callback funtion will have one parammeter: type GestureHandler = (s: IGestureStatus) => void;

  • gesture: the rc-gesture state object, which contain all information you may need, see gesture

props:

common props

name type default description
direction string `all` control the allowed gesture direction, could be `['all', 'vertical', 'horizontal']`

Tap & Press

name type default description
onTap function single tap callback
onPress function long tap callback
onPressOut function long tap end callback

Swipe

name type default description
onSwipe function swipe callback, will triggered at the same time of all of below callback
onSwipeLeft function swipe left callback
onSwipeRight function swipe right callback
onSwipeTop function swipe top callback
onSwipeBottom function swipe bottom callback

Pan

name type default description
onPan function pan callback, will triggered at the same time of all of below callback
onPanStart function drag start callback
onPanMove function drag move callback
onPanEnd function drag end callback
onPanCancel function drag cancel callback
onPanLeft function pan left callback
onPanRight function pan right callback
onPanTop function pan top callback
onPanBottom function pan bottom callback

Pinch

pinch gesture is not enabled by default, you must set props.enablePinch = true at first;

name type default description
onPinch function pinch callback, will triggered at the same time of all of below callback
onPinchStart function pinch start callback
onPinchMove function pinch move callback
onPinchEnd function pinch end callback
onPanCancel function pinch cancel callback
onPinchIn function pinch in callback
onPinchOut function pinch out callback

Rotate

pinch gesture is not enabled by default, you must set props.enableRotate = true at first;

name type default description
onRotate function rotate callback, will triggered at the same time of all of below callback
onRotateStart function rotate start callback
onRotateMove function rotate move callback
onRotateEnd function rotate end callback
onRotateCancel function rotate cancel callback

gesture

// http://hammerjs.github.io/api/#event-object
export interface IGestureStauts {
    /* start status snapshot */
    startTime: number;
    startTouches: Finger[];

    startMutliFingerStatus?: MultiFingerStatus[];

    /* now status snapshot */
    time: number;
    touches: Finger[];

    mutliFingerStatus?: MultiFingerStatus[];

    /* delta status from touchstart to now, just for singe finger */
    moveStatus?: SingeFingerMoveStatus;

    /* whether is a long tap */
    press?: boolean;

    /* whether is a swipe*/
    swipe?: boolean;
    direction?: number;

    /* whether is in pinch process */
    pinch?: boolean;
    scale?: number;

    /* whether is in rotate process */
    rotate?: boolean;
    rotation?: number; // Rotation (in deg) that has been done when multi-touch. 0 on a single touch.
};

Development

npm install
npm start

Example

npm start and then go to http://localhost:8005/examples/

Online examples: http://react-component.github.io/gesture/

Test Case

http://localhost:8005/tests/runner.html?coverage

Coverage

http://localhost:8005/node_modules/rc-server/node_modules/node-jscover/lib/front-end/jscoverage.html?w=http://localhost:8088/tests/runner.html?coverage

License

rc-gesture is released under the MIT license.

The MIT License (MIT) Copyright (c) 2015-present Alipay.com, https://www.alipay.com/ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

Support gesture for react component. 展开 收起
README
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/mirrors_react-component/gesture.git
git@gitee.com:mirrors_react-component/gesture.git
mirrors_react-component
gesture
gesture
master

搜索帮助