464 lines
13 KiB
Python
464 lines
13 KiB
Python
"""Data Editor component from glide-data-grid."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from enum import Enum
|
|
from typing import Any, Dict, Literal, Optional, Tuple, TypedDict, Union
|
|
|
|
from reflex.base import Base
|
|
from reflex.components.component import Component, NoSSRComponent
|
|
from reflex.components.literals import LiteralRowMarker
|
|
from reflex.event import EventHandler, no_args_event_spec, passthrough_event_spec
|
|
from reflex.utils import console, format, types
|
|
from reflex.utils.imports import ImportDict, ImportVar
|
|
from reflex.utils.serializers import serializer
|
|
from reflex.vars import get_unique_variable_name
|
|
from reflex.vars.base import Var
|
|
from reflex.vars.sequence import ArrayVar
|
|
|
|
|
|
# TODO: Fix the serialization issue for custom types.
|
|
class GridColumnIcons(Enum):
|
|
"""An Enum for the available icons in DataEditor."""
|
|
|
|
Array = "array"
|
|
AudioUri = "audio_uri"
|
|
Boolean = "boolean"
|
|
HeaderCode = "code"
|
|
Date = "date"
|
|
Email = "email"
|
|
Emoji = "emoji"
|
|
GeoDistance = "geo_distance"
|
|
IfThenElse = "if_then_else"
|
|
Image = "image"
|
|
JoinStrings = "join_strings"
|
|
Lookup = "lookup"
|
|
Markdown = "markdown"
|
|
Math = "math"
|
|
Number = "number"
|
|
Phone = "phone"
|
|
Reference = "reference"
|
|
Rollup = "rollup"
|
|
RowID = "row_id"
|
|
SingleValue = "single_value"
|
|
SplitString = "split_string"
|
|
String = "string"
|
|
TextTemplate = "text_template"
|
|
Time = "time"
|
|
Uri = "uri"
|
|
VideoUri = "video_uri"
|
|
|
|
|
|
class DataEditorTheme(Base):
|
|
"""The theme for the DataEditor component."""
|
|
|
|
accent_color: Optional[str] = None
|
|
accent_fg: Optional[str] = None
|
|
accent_light: Optional[str] = None
|
|
base_font_style: Optional[str] = None
|
|
bg_bubble: Optional[str] = None
|
|
bg_bubble_selected: Optional[str] = None
|
|
bg_cell: Optional[str] = None
|
|
bg_cell_medium: Optional[str] = None
|
|
bg_header: Optional[str] = None
|
|
bg_header_has_focus: Optional[str] = None
|
|
bg_header_hovered: Optional[str] = None
|
|
bg_icon_header: Optional[str] = None
|
|
bg_search_result: Optional[str] = None
|
|
border_color: Optional[str] = None
|
|
cell_horizontal_padding: Optional[int] = None
|
|
cell_vertical_padding: Optional[int] = None
|
|
drilldown_border: Optional[str] = None
|
|
editor_font_size: Optional[str] = None
|
|
fg_icon_header: Optional[str] = None
|
|
font_family: Optional[str] = None
|
|
header_bottom_border_color: Optional[str] = None
|
|
header_font_style: Optional[str] = None
|
|
horizontal_border_color: Optional[str] = None
|
|
line_height: Optional[int] = None
|
|
link_color: Optional[str] = None
|
|
text_bubble: Optional[str] = None
|
|
text_dark: Optional[str] = None
|
|
text_group_header: Optional[str] = None
|
|
text_header: Optional[str] = None
|
|
text_header_selected: Optional[str] = None
|
|
text_light: Optional[str] = None
|
|
text_medium: Optional[str] = None
|
|
|
|
|
|
class Bounds(TypedDict):
|
|
"""The bounds of the group header."""
|
|
|
|
x: int
|
|
y: int
|
|
width: int
|
|
height: int
|
|
|
|
|
|
class CompatSelection(TypedDict):
|
|
"""The selection."""
|
|
|
|
items: list
|
|
|
|
|
|
class Rectangle(TypedDict):
|
|
"""The bounds of the group header."""
|
|
|
|
x: int
|
|
y: int
|
|
width: int
|
|
height: int
|
|
|
|
|
|
class GridSelectionCurrent(TypedDict):
|
|
"""The current selection."""
|
|
|
|
cell: tuple[int, int]
|
|
range: Rectangle
|
|
rangeStack: list[Rectangle]
|
|
|
|
|
|
class GridSelection(TypedDict):
|
|
"""The grid selection."""
|
|
|
|
current: Optional[GridSelectionCurrent]
|
|
columns: CompatSelection
|
|
rows: CompatSelection
|
|
|
|
|
|
class GroupHeaderClickedEventArgs(TypedDict):
|
|
"""The arguments for the group header clicked event."""
|
|
|
|
kind: str
|
|
group: str
|
|
location: tuple[int, int]
|
|
bounds: Bounds
|
|
isEdge: bool
|
|
shiftKey: bool
|
|
ctrlKey: bool
|
|
metaKey: bool
|
|
isTouch: bool
|
|
localEventX: int
|
|
localEventY: int
|
|
button: int
|
|
buttons: int
|
|
scrollEdge: tuple[int, int]
|
|
|
|
|
|
class GridCell(TypedDict):
|
|
"""The grid cell."""
|
|
|
|
span: Optional[list[int]]
|
|
|
|
|
|
class GridColumn(TypedDict):
|
|
"""The grid column."""
|
|
|
|
title: str
|
|
group: Optional[str]
|
|
|
|
|
|
class DataEditor(NoSSRComponent):
|
|
"""The DataEditor Component."""
|
|
|
|
tag = "DataEditor"
|
|
is_default = True
|
|
library: str | None = "@glideapps/glide-data-grid@^6.0.3"
|
|
lib_dependencies: list[str] = [
|
|
"lodash@^4.17.21",
|
|
"react-responsive-carousel@^3.2.7",
|
|
]
|
|
|
|
# Number of rows.
|
|
rows: Var[int]
|
|
|
|
# Headers of the columns for the data grid.
|
|
columns: Var[list[dict[str, Any]]]
|
|
|
|
# The data.
|
|
data: Var[list[list[Any]]]
|
|
|
|
# The name of the callback used to find the data to display.
|
|
get_cell_content: Var[str]
|
|
|
|
# Allow selection for copying.
|
|
get_cells_for_selection: Var[bool]
|
|
|
|
# Allow paste.
|
|
on_paste: Var[bool]
|
|
|
|
# Controls the drawing of the focus ring.
|
|
draw_focus_ring: Var[bool]
|
|
|
|
# Enables or disables the overlay shadow when scrolling horizontally.
|
|
fixed_shadow_x: Var[bool]
|
|
|
|
# Enables or disables the overlay shadow when scrolling vertically.
|
|
fixed_shadow_y: Var[bool]
|
|
|
|
# The number of columns which should remain in place when scrolling horizontally. Doesn't include rowMarkers.
|
|
freeze_columns: Var[int]
|
|
|
|
# Controls the header of the group header row.
|
|
group_header_height: Var[int]
|
|
|
|
# Controls the height of the header row.
|
|
header_height: Var[int]
|
|
|
|
# Additional header icons:
|
|
# header_icons: Var[Any] # (TODO: must be a map of name: svg) #noqa: ERA001
|
|
|
|
# The maximum width a column can be automatically sized to.
|
|
max_column_auto_width: Var[int]
|
|
|
|
# The maximum width a column can be resized to.
|
|
max_column_width: Var[int]
|
|
|
|
# The minimum width a column can be resized to.
|
|
min_column_width: Var[int]
|
|
|
|
# Determines the height of each row.
|
|
row_height: Var[int]
|
|
|
|
# Kind of row markers.
|
|
row_markers: Var[LiteralRowMarker]
|
|
|
|
# Changes the starting index for row markers.
|
|
row_marker_start_index: Var[int]
|
|
|
|
# Sets the width of row markers in pixels, if unset row markers will automatically size.
|
|
row_marker_width: Var[int]
|
|
|
|
# Enable horizontal smooth scrolling.
|
|
smooth_scroll_x: Var[bool]
|
|
|
|
# Enable vertical smooth scrolling.
|
|
smooth_scroll_y: Var[bool]
|
|
|
|
# Controls the drawing of the left hand vertical border of a column. If set to a boolean value it controls all borders.
|
|
vertical_border: Var[bool] # TODO: support a mapping (dict[int, bool])
|
|
|
|
# Allow columns selections. ("none", "single", "multi")
|
|
column_select: Var[Literal["none", "single", "multi"]]
|
|
|
|
# Prevent diagonal scrolling.
|
|
prevent_diagonal_scrolling: Var[bool]
|
|
|
|
# Allow to scroll past the limit of the actual content on the horizontal axis.
|
|
overscroll_x: Var[int]
|
|
|
|
# Allow to scroll past the limit of the actual content on the vertical axis.
|
|
overscroll_y: Var[int]
|
|
|
|
# Initial scroll offset on the horizontal axis.
|
|
scroll_offset_x: Var[int]
|
|
|
|
# Initial scroll offset on the vertical axis.
|
|
scroll_offset_y: Var[int]
|
|
|
|
# global theme
|
|
theme: Var[Union[DataEditorTheme, Dict]]
|
|
|
|
# Fired when a cell is activated.
|
|
on_cell_activated: EventHandler[passthrough_event_spec(Tuple[int, int])]
|
|
|
|
# Fired when a cell is clicked.
|
|
on_cell_clicked: EventHandler[passthrough_event_spec(Tuple[int, int])]
|
|
|
|
# Fired when a cell is right-clicked.
|
|
on_cell_context_menu: EventHandler[passthrough_event_spec(Tuple[int, int])]
|
|
|
|
# Fired when a cell is edited.
|
|
on_cell_edited: EventHandler[passthrough_event_spec(Tuple[int, int], GridCell)]
|
|
|
|
# Fired when a group header is clicked.
|
|
on_group_header_clicked: EventHandler[
|
|
passthrough_event_spec(Tuple[int, int], GridCell)
|
|
]
|
|
|
|
# Fired when a group header is right-clicked.
|
|
on_group_header_context_menu: EventHandler[
|
|
passthrough_event_spec(int, GroupHeaderClickedEventArgs)
|
|
]
|
|
|
|
# Fired when a group header is renamed.
|
|
on_group_header_renamed: EventHandler[passthrough_event_spec(str, str)]
|
|
|
|
# Fired when a header is clicked.
|
|
on_header_clicked: EventHandler[passthrough_event_spec(Tuple[int, int])]
|
|
|
|
# Fired when a header is right-clicked.
|
|
on_header_context_menu: EventHandler[passthrough_event_spec(Tuple[int, int])]
|
|
|
|
# Fired when a header menu item is clicked.
|
|
on_header_menu_click: EventHandler[passthrough_event_spec(int, Rectangle)]
|
|
|
|
# Fired when an item is hovered.
|
|
on_item_hovered: EventHandler[passthrough_event_spec(Tuple[int, int])]
|
|
|
|
# Fired when a selection is deleted.
|
|
on_delete: EventHandler[passthrough_event_spec(GridSelection)]
|
|
|
|
# Fired when editing is finished.
|
|
on_finished_editing: EventHandler[
|
|
passthrough_event_spec(Union[GridCell, None], tuple[int, int])
|
|
]
|
|
|
|
# Fired when a row is appended.
|
|
on_row_appended: EventHandler[no_args_event_spec]
|
|
|
|
# Fired when the selection is cleared.
|
|
on_selection_cleared: EventHandler[no_args_event_spec]
|
|
|
|
# Fired when a column is resized.
|
|
on_column_resize: EventHandler[passthrough_event_spec(GridColumn, int)]
|
|
|
|
def add_imports(self) -> ImportDict:
|
|
"""Add imports for the component.
|
|
|
|
Returns:
|
|
The import dict.
|
|
"""
|
|
if self.library is None:
|
|
return {}
|
|
return {
|
|
"": f"{format.format_library_name(self.library)}/dist/index.css",
|
|
self.library: "GridCellKind",
|
|
"$/utils/helpers/dataeditor.js": ImportVar(
|
|
tag="formatDataEditorCells", is_default=False, install=False
|
|
),
|
|
}
|
|
|
|
def add_hooks(self) -> list[str]:
|
|
"""Get the hooks to render.
|
|
|
|
Returns:
|
|
The hooks to render.
|
|
"""
|
|
# Define the id of the component in case multiple are used in the same page.
|
|
editor_id = get_unique_variable_name()
|
|
|
|
# Define the name of the getData callback associated with this component and assign to get_cell_content.
|
|
if self.get_cell_content is not None:
|
|
data_callback = self.get_cell_content._js_expr
|
|
else:
|
|
data_callback = f"getData_{editor_id}"
|
|
self.get_cell_content = Var(_js_expr=data_callback)
|
|
|
|
code = [f"function {data_callback}([col, row]){{"]
|
|
|
|
columns_path = str(self.columns)
|
|
data_path = str(self.data)
|
|
|
|
code.extend(
|
|
[
|
|
f" return formatDataEditorCells(col, row, {columns_path}, {data_path});",
|
|
" }",
|
|
]
|
|
)
|
|
|
|
return ["\n".join(code)]
|
|
|
|
@classmethod
|
|
def create(cls, *children, **props) -> Component:
|
|
"""Create the DataEditor component.
|
|
|
|
Args:
|
|
*children: The children of the data editor.
|
|
**props: The props of the data editor.
|
|
|
|
Raises:
|
|
ValueError: invalid input.
|
|
|
|
Returns:
|
|
The DataEditor component.&
|
|
"""
|
|
from reflex.components.el import Div
|
|
|
|
columns = props.get("columns", [])
|
|
data = props.get("data", [])
|
|
rows = props.get("rows")
|
|
|
|
# If rows is not provided, determine from data.
|
|
if rows is None:
|
|
if isinstance(data, Var) and not isinstance(data, ArrayVar):
|
|
raise ValueError(
|
|
"DataEditor data must be an ArrayVar if rows is not provided."
|
|
)
|
|
|
|
props["rows"] = data.length() if isinstance(data, ArrayVar) else len(data)
|
|
|
|
if not isinstance(columns, Var) and len(columns):
|
|
if types.is_dataframe(type(data)) or (
|
|
isinstance(data, Var) and types.is_dataframe(data._var_type)
|
|
):
|
|
raise ValueError(
|
|
"Cannot pass in both a pandas dataframe and columns to the data_editor component."
|
|
)
|
|
else:
|
|
props["columns"] = [
|
|
format.format_data_editor_column(col) for col in columns
|
|
]
|
|
|
|
if "theme" in props:
|
|
theme = props.get("theme")
|
|
if isinstance(theme, Dict):
|
|
props["theme"] = DataEditorTheme(**theme)
|
|
|
|
# Allow by default to select a region of cells in the grid.
|
|
props.setdefault("get_cells_for_selection", True)
|
|
|
|
# Disable on_paste by default if not provided.
|
|
props.setdefault("on_paste", False)
|
|
|
|
if props.pop("get_cell_content", None) is not None:
|
|
console.warn(
|
|
"get_cell_content is not user configurable, the provided value will be discarded"
|
|
)
|
|
grid = super().create(*children, **props)
|
|
return Div.create(
|
|
grid,
|
|
width=props.pop("width", "100%"),
|
|
height=props.pop("height", "100%"),
|
|
)
|
|
|
|
@staticmethod
|
|
def _get_app_wrap_components() -> dict[tuple[int, str], Component]:
|
|
"""Get the app wrap components for the component.
|
|
|
|
Returns:
|
|
The app wrap components.
|
|
"""
|
|
from reflex.components.el import Div
|
|
|
|
class Portal(Div):
|
|
def get_ref(self):
|
|
return None
|
|
|
|
return {
|
|
(-1, "DataEditorPortal"): Portal.create(
|
|
id="portal",
|
|
position="fixed",
|
|
top=0,
|
|
)
|
|
}
|
|
|
|
|
|
@serializer
|
|
def serialize_dataeditortheme(theme: DataEditorTheme):
|
|
"""The serializer for the data editor theme.
|
|
|
|
Args:
|
|
theme: The theme to serialize.
|
|
|
|
Returns:
|
|
The serialized theme.
|
|
"""
|
|
return {
|
|
format.to_camel_case(k): v for k, v in theme.__dict__.items() if v is not None
|
|
}
|
|
|
|
|
|
data_editor = DataEditor.create
|
|
data_editor_theme = DataEditorTheme
|