reflex/reflex/components/react_player/react_player.py
Khaleel Al-Adhami 946b7bc25a
upgrade deps as per python 3.10 (#4842)
* upgrade deps as per python 3.10

* no need for that guy
2025-02-18 13:56:58 -08:00

106 lines
3.5 KiB
Python

"""React-Player component."""
from __future__ import annotations
from typing import TypedDict
from reflex.components.component import NoSSRComponent
from reflex.event import EventHandler, no_args_event_spec, passthrough_event_spec
from reflex.vars.base import Var
class Progress(TypedDict):
"""Callback containing played and loaded progress as a fraction, and playedSeconds and loadedSeconds in seconds."""
played: float
playedSeconds: float
loaded: float
loadedSeconds: float
class ReactPlayer(NoSSRComponent):
"""Using react-player and not implement all props and callback yet.
reference: https://github.com/cookpete/react-player.
"""
library = "react-player@2.16.0"
tag = "ReactPlayer"
is_default = True
# The url of a video or song to play
url: Var[str]
# Set to true or false to pause or play the media
playing: Var[bool]
# Set to true or false to loop the media
loop: Var[bool]
# Set to true or false to display native player controls.
controls: Var[bool] = Var.create(True)
# Set to true to show just the video thumbnail, which loads the full player on click
light: Var[bool]
# Set the volume of the player, between 0 and 1
volume: Var[float]
# Mutes the player
muted: Var[bool]
# Set the width of the player: ex:640px
width: Var[str]
# Set the height of the player: ex:640px
height: Var[str]
# Called when media is loaded and ready to play. If playing is set to true, media will play immediately.
on_ready: EventHandler[no_args_event_spec]
# Called when media starts playing.
on_start: EventHandler[no_args_event_spec]
# Called when media starts or resumes playing after pausing or buffering.
on_play: EventHandler[no_args_event_spec]
# Callback containing played and loaded progress as a fraction, and playedSeconds and loadedSeconds in seconds. eg { played: 0.12, playedSeconds: 11.3, loaded: 0.34, loadedSeconds: 16.7 }
on_progress: EventHandler[passthrough_event_spec(Progress)]
# Callback containing duration of the media, in seconds.
on_duration: EventHandler[passthrough_event_spec(float)]
# Called when media is paused.
on_pause: EventHandler[no_args_event_spec]
# Called when media starts buffering.
on_buffer: EventHandler[no_args_event_spec]
# Called when media has finished buffering. Works for files, YouTube and Facebook.
on_buffer_end: EventHandler[no_args_event_spec]
# Called when media seeks with seconds parameter.
on_seek: EventHandler[passthrough_event_spec(float)]
# Called when playback rate of the player changed. Only supported by YouTube, Vimeo (if enabled), Wistia, and file paths.
on_playback_rate_change: EventHandler[no_args_event_spec]
# Called when playback quality of the player changed. Only supported by YouTube (if enabled).
on_playback_quality_change: EventHandler[no_args_event_spec]
# Called when media finishes playing. Does not fire when loop is set to true.
on_ended: EventHandler[no_args_event_spec]
# Called when an error occurs whilst attempting to play media.
on_error: EventHandler[no_args_event_spec]
# Called when user clicks the light mode preview.
on_click_preview: EventHandler[no_args_event_spec]
# Called when picture-in-picture mode is enabled.
on_enable_pip: EventHandler[no_args_event_spec]
# Called when picture-in-picture mode is disabled.
on_disable_pip: EventHandler[no_args_event_spec]