https://github.com/korsoftwaresolutions/react-native-joystick

React Native Joystick Component.
https://github.com/korsoftwaresolutions/react-native-joystick

expo games react react-native

Last synced: 9 months ago
JSON representation

React Native Joystick Component.

• Host: GitHub
• URL: https://github.com/korsoftwaresolutions/react-native-joystick
• Owner: KorSoftwareSolutions
• Created: 2021-11-15T20:31:32.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-05-19T03:30:40.000Z (about 2 years ago)
• Last Synced: 2025-09-23T23:36:46.773Z (9 months ago)
• Topics: expo, games, react, react-native
• Language: TypeScript
• Homepage:
• Size: 753 KB
• Stars: 23
• Watchers: 1
• Forks: 19
• Open Issues: 1
• Metadata Files:
  • Readme: README.MD

Awesome Lists containing this project

README

          
# React Native Joystick

[![NPM](https://nodei.co/npm/@korsolutions/react-native-joystick.png)](https://nodei.co/npm/@korsolutions/react-native-joystick)

[![runs with Expo Go](https://img.shields.io/badge/Runs%20with%20Expo%20Go-4630EB.svg?style=flat-square&logo=EXPO&labelColor=f3f3f3&logoColor=000)](https://expo.io/client)

## TOC

- [Installation](#installation)

- [Preview](#preview)

- [Usage](#usage)

- [Props](#props)

- [Types](#types)

## Installation

**NPM**

```shell

npm install @korsolutions/react-native-joystick react-native-gesture-handler --save

```

**YARN**

```shell

yarn add @korsolutions/react-native-joystick react-native-gesture-handler

```

Add GestureHandlerRootView at the root level of your app.

```js

import { GestureHandlerRootView } from "react-native-gesture-handler";

  

```

## Preview

![React Native Axis Pad: Screen Preview](./assets/preview.gif)

## Usage

```js

import { ReactNativeJoystick } from "@korsolutions/react-native-joystick";

```

```js

 console.log(data)} />

```

## Props

### radius

Set the size radius of the container circle

The inside joystick radius is 1/3 of this size

Type: **Number**

### color

Set the color scheme of the joystick

The color of the container and the joystick is set based on this color with a set opacity.

type: **HEX Color Code**

### onMove, onStart, onStop

A callback function with an argument of type [MoveJoystickEvent](#MoveJoystickEvent).

type: **Function**

## Types

### MoveJoystickEvent

Event returned by the onMove, onStart and onStop callbacks.

```js

{

  type: "move" | "stop" | "start";

  position: {

    x: number;

    y: number;

  }

  force: number;

  angle: {

    radian: number;

    degree: number;

  }

}

```