from typing import Any, Callable, Optional
from ..element import Element
from ..events import GenericEventArguments, JoystickEventArguments, handle_event
class Joystick(Element, component='joystick.vue', libraries=['lib/nipplejs/nipplejs.js']):
def __init__(self, *,
on_start: Optional[Callable[..., Any]] = None,
on_move: Optional[Callable[..., Any]] = None,
on_end: Optional[Callable[..., Any]] = None,
throttle: float = 0.05,
** options: Any) -> None:
"""Joystick
Create a joystick based on `nipple.js `_.
:param on_start: callback for when the user touches the joystick
:param on_move: callback for when the user moves the joystick
:param on_end: callback for when the user releases the joystick
:param throttle: throttle interval in seconds for the move event (default: 0.05)
:param options: arguments like `color` which should be passed to the `underlying nipple.js library `_
"""
super().__init__()
self._props['options'] = options
self.active = False
def handle_start() -> None:
self.active = True
handle_event(on_start, JoystickEventArguments(sender=self,
client=self.client,
action='start'))
def handle_move(e: GenericEventArguments) -> None:
if self.active:
handle_event(on_move, JoystickEventArguments(sender=self,
client=self.client,
action='move',
x=float(e.args['data']['vector']['x']),
y=float(e.args['data']['vector']['y'])))
def handle_end() -> None:
self.active = False
handle_event(on_end, JoystickEventArguments(sender=self,
client=self.client,
action='end'))
self.on('start', handle_start, [])
self.on('move', handle_move, ['data'], throttle=throttle)
self.on('end', handle_end, [])