feffery_utils_components 0.2.0-rc20 → 0.2.0-rc22

package/DESCRIPTION

@@ -1,6 +1,6 @@
 Package: fefferyUtilsComponents
 Title: Build more utility components for Plotly Dash.
-Version: 0.2.0-rc20
+Version: 0.2.0-rc22
 Description: Build more utility components for Plotly Dash.
 Depends: R (>= 3.0.2)
 Imports: 

package/NAMESPACE

@@ -84,6 +84,8 @@ export(''FefferyGeolocation)
 export(''FefferyIdle)
 export(''FefferyInViewport)
 export(''FefferyKeyPress)
+export(''FefferyListenDrag)
+export(''FefferyListenDrop)
 export(''FefferyListenElementSize)
 export(''FefferyListenHover)
 export(''FefferyListenPaste)

package/Project.toml

@@ -2,7 +2,7 @@
 name = "FefferyUtilsComponents"
 uuid = "1b08a953-4be3-4667-9a23-209fcf3199fa"
 authors = ["CNFeffery <fefferypzy@gmail.com>"]
-version = "0.2.0-rc20"
+version = "0.2.0-rc22"
 
 [deps]
 Dash = "1b08a953-4be3-4667-9a23-3db579824955"

package/README.md

@@ -22,7 +22,7 @@ pip install feffery-utils-components -U
 ## 2 最新预发布版本安装方式
 
 > [!NOTE]  
-> 最新预发布版本（2024-06-10）：`0.2.0rc19`
+> 最新预发布版本（2024-07-23）：`0.2.0rc21`
 
 ```bash
 pip install feffery-utils-components --pre -U

package/feffery_utils_components/FefferyGrid.py

@@ -25,7 +25,8 @@ Keyword arguments:
     用于自定义断点及其对应的像素值映射对象  默认为{lg: 1200, md: 996, sm: 768, xs: 480, xxs:
     0}.
 
-- className (string; optional)
+- className (string; optional):
+    当前组件css类名.
 
 - cols (dict with strings as keys and values of type number | number; default 12):
     与breakpoints对应，用于设置不同断点下网格系统的列数  默认为{lg: 12, md: 10, sm: 6, xs: 4,
@@ -53,7 +54,7 @@ Keyword arguments:
     设置是否开启当前网格内部的尺寸调整行为，默认为True.
 
 - key (string; optional):
-    唯一标识符，强制刷新用.
+    强制刷新用.
 
 - layouts (dict; optional):
     用于定义不同断点下的各个网格项布局相关参数.
@@ -159,6 +160,9 @@ Keyword arguments:
 - margin (list of numbers | dict with strings as keys and values of type list of numbers; default [10, 10]):
     用于设置当前网格容器内子元素之间的像素margin，格式：[x, y]  也可以传入以断点为键的字典从而实现响应式.
 
+- placeholder (a list of or a singular dash component, string or number; optional):
+    占位元素，用于在children为空时呈现相关提示信息.
+
 - placeholderBackground (string; default '#3b3a39'):
     自定义样式相关快捷样式参数  自定义拖拽预览占位的background属性，默认为'#3b3a39'.
 
@@ -174,16 +178,17 @@ Keyword arguments:
 - rowHeight (number; default 150):
     用于设置网格中每行的像素高度，默认为150.
 
-- style (dict; optional)"""
-    _children_props = []
-    _base_nodes = ['children']
+- style (dict; optional):
+    当前组件css样式."""
+    _children_props = ['placeholder']
+    _base_nodes = ['placeholder', 'children']
     _namespace = 'feffery_utils_components'
     _type = 'FefferyGrid'
     @_explicitize_args
-    def __init__(self, children=None, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, height=Component.UNDEFINED, autoSize=Component.UNDEFINED, compactType=Component.UNDEFINED, margin=Component.UNDEFINED, containerPadding=Component.UNDEFINED, rowHeight=Component.UNDEFINED, isDraggable=Component.UNDEFINED, isResizable=Component.UNDEFINED, isBounded=Component.UNDEFINED, allowOverlap=Component.UNDEFINED, breakpoints=Component.UNDEFINED, cols=Component.UNDEFINED, layouts=Component.UNDEFINED, placeholderBackground=Component.UNDEFINED, placeholderOpacity=Component.UNDEFINED, placeholderBorder=Component.UNDEFINED, placeholderBorderRadius=Component.UNDEFINED, debug=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['children', 'id', 'allowOverlap', 'autoSize', 'breakpoints', 'className', 'cols', 'compactType', 'containerPadding', 'debug', 'height', 'isBounded', 'isDraggable', 'isResizable', 'key', 'layouts', 'loading_state', 'margin', 'placeholderBackground', 'placeholderBorder', 'placeholderBorderRadius', 'placeholderOpacity', 'rowHeight', 'style']
+    def __init__(self, children=None, id=Component.UNDEFINED, placeholder=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, height=Component.UNDEFINED, autoSize=Component.UNDEFINED, compactType=Component.UNDEFINED, margin=Component.UNDEFINED, containerPadding=Component.UNDEFINED, rowHeight=Component.UNDEFINED, isDraggable=Component.UNDEFINED, isResizable=Component.UNDEFINED, isBounded=Component.UNDEFINED, allowOverlap=Component.UNDEFINED, breakpoints=Component.UNDEFINED, cols=Component.UNDEFINED, layouts=Component.UNDEFINED, placeholderBackground=Component.UNDEFINED, placeholderOpacity=Component.UNDEFINED, placeholderBorder=Component.UNDEFINED, placeholderBorderRadius=Component.UNDEFINED, debug=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['children', 'id', 'allowOverlap', 'autoSize', 'breakpoints', 'className', 'cols', 'compactType', 'containerPadding', 'debug', 'height', 'isBounded', 'isDraggable', 'isResizable', 'key', 'layouts', 'loading_state', 'margin', 'placeholder', 'placeholderBackground', 'placeholderBorder', 'placeholderBorderRadius', 'placeholderOpacity', 'rowHeight', 'style']
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['children', 'id', 'allowOverlap', 'autoSize', 'breakpoints', 'className', 'cols', 'compactType', 'containerPadding', 'debug', 'height', 'isBounded', 'isDraggable', 'isResizable', 'key', 'layouts', 'loading_state', 'margin', 'placeholderBackground', 'placeholderBorder', 'placeholderBorderRadius', 'placeholderOpacity', 'rowHeight', 'style']
+        self.available_properties = ['children', 'id', 'allowOverlap', 'autoSize', 'breakpoints', 'className', 'cols', 'compactType', 'containerPadding', 'debug', 'height', 'isBounded', 'isDraggable', 'isResizable', 'key', 'layouts', 'loading_state', 'margin', 'placeholder', 'placeholderBackground', 'placeholderBorder', 'placeholderBorderRadius', 'placeholderOpacity', 'rowHeight', 'style']
         self.available_wildcard_properties =            []
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_utils_components/FefferyListenDrag.py

@@ -0,0 +1,51 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class FefferyListenDrag(Component):
+    """A FefferyListenDrag component.
+拖拽事件监听组件FefferyListenDrag
+
+Keyword arguments:
+
+- id (string; optional):
+    组件id.
+
+- data (boolean | number | string | dict | list; optional):
+    当前监听目标所携带的数据，配合**FefferyListenDrop**使用.
+
+- isDragging (boolean; optional):
+    监听目标是否处于拖拽中状态.
+
+- loading_state (dict; optional)
+
+    `loading_state` is a dict with keys:
+
+    - component_name (string; optional):
+        Holds the name of the component that is loading.
+
+    - is_loading (boolean; optional):
+        Determines if the component is loading or not.
+
+    - prop_name (string; optional):
+        Holds which property is loading.
+
+- targetSelector (string; optional):
+    拖拽事件监听目标选择器规则字符串."""
+    _children_props = []
+    _base_nodes = ['children']
+    _namespace = 'feffery_utils_components'
+    _type = 'FefferyListenDrag'
+    @_explicitize_args
+    def __init__(self, id=Component.UNDEFINED, targetSelector=Component.UNDEFINED, data=Component.UNDEFINED, isDragging=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'data', 'isDragging', 'loading_state', 'targetSelector']
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['id', 'data', 'isDragging', 'loading_state', 'targetSelector']
+        self.available_wildcard_properties =            []
+        _explicit_args = kwargs.pop('_explicit_args')
+        _locals = locals()
+        _locals.update(kwargs)  # For wildcard attrs and excess named props
+        args = {k: _locals[k] for k in _explicit_args}
+
+        super(FefferyListenDrag, self).__init__(**args)

package/feffery_utils_components/FefferyListenDrop.py

@@ -0,0 +1,103 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class FefferyListenDrop(Component):
+    """A FefferyListenDrop component.
+放置事件监听组件FefferyListenDrop
+
+Keyword arguments:
+
+- id (string; optional):
+    组件id.
+
+- dropEvent (dict; optional):
+    监听最近一次基于FefferyListenDrag的元素拖拽放置事件.
+
+    `dropEvent` is a dict with keys:
+
+    - clientX (number; optional):
+        以浏览器窗口左上角为原点，记录x坐标.
+
+    - clientY (number; optional):
+        以浏览器窗口左上角为原点，记录y坐标.
+
+    - data (boolean | number | string | dict | list; optional):
+        事件携带数据.
+
+    - pageX (number; optional):
+        以页面整体左上角为原点，记录x坐标.
+
+    - pageY (number; optional):
+        以页面整体左上角为原点，记录y坐标.
+
+    - screenX (number; optional):
+        以屏幕左上角为原点，记录x坐标.
+
+    - screenY (number; optional):
+        以屏幕左上角为原点，记录y坐标.
+
+    - time (number; optional):
+        事件对应时间戳.
+
+- hoverEvent (dict; optional):
+    监听最近一次正处于待放置鼠标悬停状态时的事件.
+
+    `hoverEvent` is a dict with keys:
+
+    - clientX (number; optional):
+        以浏览器窗口左上角为原点，记录x坐标.
+
+    - clientY (number; optional):
+        以浏览器窗口左上角为原点，记录y坐标.
+
+    - pageX (number; optional):
+        以页面整体左上角为原点，记录x坐标.
+
+    - pageY (number; optional):
+        以页面整体左上角为原点，记录y坐标.
+
+    - screenX (number; optional):
+        以屏幕左上角为原点，记录x坐标.
+
+    - screenY (number; optional):
+        以屏幕左上角为原点，记录y坐标.
+
+    - time (number; optional):
+        事件对应时间戳.
+
+- isHovering (boolean; optional):
+    监听放置事件监听目标容器是否正处于待放置鼠标悬停状态.
+
+- loading_state (dict; optional)
+
+    `loading_state` is a dict with keys:
+
+    - component_name (string; optional):
+        Holds the name of the component that is loading.
+
+    - is_loading (boolean; optional):
+        Determines if the component is loading or not.
+
+    - prop_name (string; optional):
+        Holds which property is loading.
+
+- targetSelector (string; optional):
+    放置事件监听目标容器选择器规则字符串."""
+    _children_props = []
+    _base_nodes = ['children']
+    _namespace = 'feffery_utils_components'
+    _type = 'FefferyListenDrop'
+    @_explicitize_args
+    def __init__(self, id=Component.UNDEFINED, targetSelector=Component.UNDEFINED, dropEvent=Component.UNDEFINED, isHovering=Component.UNDEFINED, hoverEvent=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'dropEvent', 'hoverEvent', 'isHovering', 'loading_state', 'targetSelector']
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['id', 'dropEvent', 'hoverEvent', 'isHovering', 'loading_state', 'targetSelector']
+        self.available_wildcard_properties =            []
+        _explicit_args = kwargs.pop('_explicit_args')
+        _locals = locals()
+        _locals.update(kwargs)  # For wildcard attrs and excess named props
+        args = {k: _locals[k] for k in _explicit_args}
+
+        super(FefferyListenDrop, self).__init__(**args)

package/feffery_utils_components/_imports_.py

@@ -82,6 +82,8 @@ from .FefferyGeolocation import FefferyGeolocation
 from .FefferyIdle import FefferyIdle
 from .FefferyInViewport import FefferyInViewport
 from .FefferyKeyPress import FefferyKeyPress
+from .FefferyListenDrag import FefferyListenDrag
+from .FefferyListenDrop import FefferyListenDrop
 from .FefferyListenElementSize import FefferyListenElementSize
 from .FefferyListenHover import FefferyListenHover
 from .FefferyListenPaste import FefferyListenPaste
@@ -198,6 +200,8 @@ __all__ = [
     "FefferyIdle",
     "FefferyInViewport",
     "FefferyKeyPress",
+    "FefferyListenDrag",
+    "FefferyListenDrop",
     "FefferyListenElementSize",
     "FefferyListenHover",
     "FefferyListenPaste",