123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412 |
- """Data Editor component from glide-data-grid."""
- from __future__ import annotations
- from enum import Enum
- from typing import Any, Callable, Dict, List, Literal, Optional, Union
- from reflex.base import Base
- from reflex.components.component import Component, NoSSRComponent
- from reflex.components.literals import LiteralRowMarker
- from reflex.utils import console, format, imports, types
- from reflex.utils.imports import ImportVar
- from reflex.utils.serializers import serializer
- from reflex.vars import Var, get_unique_variable_name
- # 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"
- # @serializer
- # def serialize_gridcolumn_icon(icon: GridColumnIcons) -> str:
- # """Serialize grid column icon.
- # Args:
- # icon: the Icon to serialize.
- # Returns:
- # The serialized value.
- # """
- # return "prefix" + str(icon)
- # class DataEditorColumn(Base):
- # """Column."""
- # title: str
- # id: Optional[str] = None
- # type_: str = "str"
- 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 DataEditor(NoSSRComponent):
- """The DataEditor Component."""
- tag: str = "DataEditor"
- is_default: bool = True
- library: str = "@glideapps/glide-data-grid@^5.3.0"
- lib_dependencies: List[str] = [
- "lodash@^4.17.21",
- "marked@^4.0.10",
- "react-responsive-carousel@^3.2.7",
- ]
- # Number of rows.
- rows: Optional[Var[int]] = None
- # Headers of the columns for the data grid.
- columns: Optional[Var[List[Dict[str, Any]]]] = None
- # The data.
- data: Optional[Var[List[List[Any]]]] = None
- # The name of the callback used to find the data to display.
- get_cell_content: Optional[Var[str]] = None
- # Allow selection for copying.
- get_cell_for_selection: Optional[Var[bool]] = None
- # Allow paste.
- on_paste: Optional[Var[bool]] = None
- # Controls the drawing of the focus ring.
- draw_focus_ring: Optional[Var[bool]] = None
- # Enables or disables the overlay shadow when scrolling horizontally.
- fixed_shadow_x: Optional[Var[bool]] = None
- # Enables or disables the overlay shadow when scrolling vertically.
- fixed_shadow_y: Optional[Var[bool]] = None
- # The number of columns which should remain in place when scrolling horizontally. Doesn't include rowMarkers.
- freeze_columns: Optional[Var[int]] = None
- # Controls the header of the group header row.
- group_header_height: Optional[Var[int]] = None
- # Controls the height of the header row.
- header_height: Optional[Var[int]] = None
- # Additional header icons:
- # header_icons: Var[Any] # (TODO: must be a map of name: svg)
- # The maximum width a column can be automatically sized to.
- max_column_auto_width: Optional[Var[int]] = None
- # The maximum width a column can be resized to.
- max_column_width: Optional[Var[int]] = None
- # The minimum width a column can be resized to.
- min_column_width: Optional[Var[int]] = None
- # Determins the height of each row.
- row_height: Optional[Var[int]] = None
- # Kind of row markers.
- row_markers: Optional[Var[LiteralRowMarker]] = None
- # Changes the starting index for row markers.
- row_marker_start_index: Optional[Var[int]] = None
- # Sets the width of row markers in pixels, if unset row markers will automatically size.
- row_marker_width: Optional[Var[int]] = None
- # Enable horizontal smooth scrolling.
- smooth_scroll_x: Optional[Var[bool]] = None
- # Enable vertical smooth scrolling.
- smooth_scroll_y: Optional[Var[bool]] = None
- # 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: Optional[Var[Literal["none", "single", "multi"]]] = None
- # Prevent diagonal scrolling.
- prevent_diagonal_scrolling: Optional[Var[bool]] = None
- # Allow to scroll past the limit of the actual content on the horizontal axis.
- overscroll_x: Optional[Var[int]] = None
- # Allow to scroll past the limit of the actual content on the vertical axis.
- overscroll_y: Optional[Var[int]] = None
- # Initial scroll offset on the horizontal axis.
- scroll_offset_x: Optional[Var[int]] = None
- # Initial scroll offset on the vertical axis.
- scroll_offset_y: Optional[Var[int]] = None
- # global theme
- theme: Optional[Var[Union[DataEditorTheme, Dict]]] = None
- def _get_imports(self):
- return imports.merge_imports(
- super()._get_imports(),
- {
- "": {
- ImportVar(
- tag=f"{format.format_library_name(self.library)}/dist/index.css"
- )
- },
- self.library: {ImportVar(tag="GridCellKind")},
- "/utils/helpers/dataeditor.js": {
- ImportVar(
- tag=f"formatDataEditorCells", is_default=False, install=False
- ),
- },
- },
- )
- def get_event_triggers(self) -> Dict[str, Callable]:
- """The event triggers of the component.
- Returns:
- The dict describing the event triggers.
- """
- def edit_sig(pos, data: dict[str, Any]):
- return [pos, data]
- return {
- "on_cell_activated": lambda pos: [pos],
- "on_cell_clicked": lambda pos: [pos],
- "on_cell_context_menu": lambda pos: [pos],
- "on_cell_edited": edit_sig,
- "on_group_header_clicked": edit_sig,
- "on_group_header_context_menu": lambda grp_idx, data: [grp_idx, data],
- "on_group_header_renamed": lambda idx, val: [idx, val],
- "on_header_clicked": lambda pos: [pos],
- "on_header_context_menu": lambda pos: [pos],
- "on_header_menu_click": lambda col, pos: [col, pos],
- "on_item_hovered": lambda pos: [pos],
- "on_delete": lambda selection: [selection],
- "on_finished_editing": lambda new_value, movement: [new_value, movement],
- "on_row_appended": lambda: [],
- "on_selection_cleared": lambda: [],
- "on_column_resize": lambda col, width: [col, width],
- }
- def _get_hooks(self) -> str | None:
- # 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.
- data_callback = f"getData_{editor_id}"
- self.get_cell_content = Var.create(data_callback, _var_is_local=False) # type: ignore
- code = [f"function {data_callback}([col, row])" "{"]
- columns_path = f"{self.columns._var_full_name}"
- data_path = f"{self.data._var_full_name}"
- 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", None)
- # If rows is not provided, determine from data.
- if rows is None:
- props["rows"] = (
- data.length() # BaseVar.create(value=f"{data}.length()", is_local=False)
- if isinstance(data, Var)
- 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_cell_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,
- )
- }
- # try:
- # pass
- # # def format_dataframe_values(df: DataFrame) -> list[list[Any]]:
- # # """Format dataframe values to a list of lists.
- # # Args:
- # # df: The dataframe to format.
- # # Returns:
- # # The dataframe as a list of lists.
- # # """
- # # return [
- # # [str(d) if isinstance(d, (list, tuple)) else d for d in data]
- # # for data in list(df.values.tolist())
- # # ]
- # # ...
- # # @serializer
- # # def serialize_dataframe(df: DataFrame) -> dict:
- # # """Serialize a pandas dataframe.
- # # Args:
- # # df: The dataframe to serialize.
- # # Returns:
- # # The serialized dataframe.
- # # """
- # # return {
- # # "columns": df.columns.tolist(),
- # # "data": format_dataframe_values(df),
- # # }
- # except ImportError:
- # pass
- @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.json_dumps(
- {format.to_camel_case(k): v for k, v in theme.__dict__.items() if v is not None}
- )
|