feffery_utils_components 0.2.0-rc19 → 0.2.0-rc20

package/DESCRIPTION

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

package/NAMESPACE

@@ -79,10 +79,13 @@ export(''FefferyImageCropper)
 export(''FefferyImageGallery)
 export(''FefferyDeviceDetect)
 export(''FefferyDocumentVisibility)
+export(''FefferyEventListener)
 export(''FefferyGeolocation)
 export(''FefferyIdle)
 export(''FefferyInViewport)
 export(''FefferyKeyPress)
+export(''FefferyListenElementSize)
+export(''FefferyListenHover)
 export(''FefferyListenPaste)
 export(''FefferyListenScroll)
 export(''FefferyListenUnload)

package/Project.toml

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

package/README.md

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

package/feffery_utils_components/FefferyEventListener.py

@@ -0,0 +1,65 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class FefferyEventListener(Component):
+    """A FefferyEventListener component.
+通用事件监听组件FefferyEventListener
+
+Keyword arguments:
+
+- id (string; optional):
+    组件id.
+
+- enable (boolean; default True):
+    控制是否开启监听  默认值：`True`.
+
+- eventName (string; required):
+    必填，目标事件名称.
+
+- handler (string; optional):
+    必填，自定义事件处理js函数字符串，唯一入参为事件对象，返回值将用于更新`result`属性.
+
+- key (string; optional):
+    强制刷新用key值.
+
+- 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.
+
+- result (boolean | number | string | dict | list; optional):
+    监听`handler`对应函数的返回值，作为事件监听的结果.
+
+- targetSelector (string; optional):
+    事件监听目标对应的选择器字符串，默认监听目标为整个页面."""
+    _children_props = []
+    _base_nodes = ['children']
+    _namespace = 'feffery_utils_components'
+    _type = 'FefferyEventListener'
+    @_explicitize_args
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, eventName=Component.REQUIRED, handler=Component.UNDEFINED, targetSelector=Component.UNDEFINED, enable=Component.UNDEFINED, result=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'enable', 'eventName', 'handler', 'key', 'loading_state', 'result', 'targetSelector']
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['id', 'enable', 'eventName', 'handler', 'key', 'loading_state', 'result', '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}
+
+        for k in ['eventName']:
+            if k not in args:
+                raise TypeError(
+                    'Required argument `' + k + '` was not specified.')
+
+        super(FefferyEventListener, self).__init__(**args)

package/feffery_utils_components/FefferyListenElementSize.py

@@ -0,0 +1,59 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class FefferyListenElementSize(Component):
+    """A FefferyListenElementSize component.
+元素尺寸监听组件FefferyListenElementSize
+
+Keyword arguments:
+
+- id (string; optional):
+    组件id.
+
+- height (number; optional):
+    监听目标元素像素高度.
+
+- key (string; optional):
+    强制刷新用key值.
+
+- 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.
+
+- target (string; required):
+    必填，设置尺寸监听目标元素id.
+
+- width (number; optional):
+    监听目标元素像素宽度."""
+    _children_props = []
+    _base_nodes = ['children']
+    _namespace = 'feffery_utils_components'
+    _type = 'FefferyListenElementSize'
+    @_explicitize_args
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, target=Component.REQUIRED, width=Component.UNDEFINED, height=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'height', 'key', 'loading_state', 'target', 'width']
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['id', 'height', 'key', 'loading_state', 'target', 'width']
+        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}
+
+        for k in ['target']:
+            if k not in args:
+                raise TypeError(
+                    'Required argument `' + k + '` was not specified.')
+
+        super(FefferyListenElementSize, self).__init__(**args)

package/feffery_utils_components/FefferyListenHover.py

@@ -0,0 +1,56 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class FefferyListenHover(Component):
+    """A FefferyListenHover component.
+鼠标悬停监听组件FefferyListenHover
+
+Keyword arguments:
+
+- id (string; optional):
+    组件id.
+
+- isHovering (boolean; optional):
+    监听目标元素是否处于鼠标悬停状态.
+
+- key (string; optional):
+    强制刷新用key值.
+
+- 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; required):
+    必填，监听目标选择器字符串."""
+    _children_props = []
+    _base_nodes = ['children']
+    _namespace = 'feffery_utils_components'
+    _type = 'FefferyListenHover'
+    @_explicitize_args
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, targetSelector=Component.REQUIRED, isHovering=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'isHovering', 'key', 'loading_state', 'targetSelector']
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['id', 'isHovering', 'key', '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}
+
+        for k in ['targetSelector']:
+            if k not in args:
+                raise TypeError(
+                    'Required argument `' + k + '` was not specified.')
+
+        super(FefferyListenHover, self).__init__(**args)

package/feffery_utils_components/FefferyListenScroll.py

@@ -5,13 +5,28 @@ from dash.development.base_component import Component, _explicitize_args
 
 class FefferyListenScroll(Component):
     """A FefferyListenScroll component.
-
+滚动条监听组件FefferyListenScroll
 
 Keyword arguments:
 
 - id (string; optional):
     组件id.
 
+- arrivedState (dict; optional):
+    监听目标滚动条的到达边界状态.
+
+- directions (dict; optional):
+    监听目标滚动条的滚动方向.
+
+- idle (number; optional):
+    滚动结束行为的检查时长，单位：毫秒，当`throttle>0`时，检查时长将为`throttle+idle`  默认：`0`.
+
+- isScrolling (boolean; optional):
+    监听目标滚动条是否正在滚动中.
+
+- key (string; optional):
+    强制刷新用key值.
+
 - loading_state (dict; optional)
 
     `loading_state` is a dict with keys:
@@ -25,20 +40,40 @@ Keyword arguments:
     - prop_name (string; optional):
         Holds which property is loading.
 
+- offset (dict; optional):
+    针对各个方向的到达边界状态，设置像素阈值.
+
+    `offset` is a dict with keys:
+
+    - bottom (number; optional):
+        下底部到达边界像素阈值.
+
+    - left (number; optional):
+        左侧到达边界像素阈值.
+
+    - right (number; optional):
+        右侧到达边界像素阈值.
+
+    - top (number; optional):
+        上顶端到达边界像素阈值.
+
 - position (dict; optional):
     监听目标滚动条的水平及竖直方向上的像素偏移量.
 
 - target (string; optional):
-    设置滚动条监听目标元素id，默认为整个页面."""
+    设置滚动条监听目标元素id，默认为整个页面.
+
+- throttle (number; optional):
+    滚动事件监听节流时长，单位：毫秒  默认：`0`."""
     _children_props = []
     _base_nodes = ['children']
     _namespace = 'feffery_utils_components'
     _type = 'FefferyListenScroll'
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, target=Component.UNDEFINED, position=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'loading_state', 'position', 'target']
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, target=Component.UNDEFINED, position=Component.UNDEFINED, isScrolling=Component.UNDEFINED, arrivedState=Component.UNDEFINED, directions=Component.UNDEFINED, throttle=Component.UNDEFINED, idle=Component.UNDEFINED, offset=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'arrivedState', 'directions', 'idle', 'isScrolling', 'key', 'loading_state', 'offset', 'position', 'target', 'throttle']
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'loading_state', 'position', 'target']
+        self.available_properties = ['id', 'arrivedState', 'directions', 'idle', 'isScrolling', 'key', 'loading_state', 'offset', 'position', 'target', 'throttle']
         self.available_wildcard_properties =            []
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_utils_components/_imports_.py

@@ -77,10 +77,13 @@ from .FefferyImageCropper import FefferyImageCropper
 from .FefferyImageGallery import FefferyImageGallery
 from .FefferyDeviceDetect import FefferyDeviceDetect
 from .FefferyDocumentVisibility import FefferyDocumentVisibility
+from .FefferyEventListener import FefferyEventListener
 from .FefferyGeolocation import FefferyGeolocation
 from .FefferyIdle import FefferyIdle
 from .FefferyInViewport import FefferyInViewport
 from .FefferyKeyPress import FefferyKeyPress
+from .FefferyListenElementSize import FefferyListenElementSize
+from .FefferyListenHover import FefferyListenHover
 from .FefferyListenPaste import FefferyListenPaste
 from .FefferyListenScroll import FefferyListenScroll
 from .FefferyListenUnload import FefferyListenUnload
@@ -190,10 +193,13 @@ __all__ = [
     "FefferyImageGallery",
     "FefferyDeviceDetect",
     "FefferyDocumentVisibility",
+    "FefferyEventListener",
     "FefferyGeolocation",
     "FefferyIdle",
     "FefferyInViewport",
     "FefferyKeyPress",
+    "FefferyListenElementSize",
+    "FefferyListenHover",
     "FefferyListenPaste",
     "FefferyListenScroll",
     "FefferyListenUnload",

package/feffery_utils_components/alias.py

@@ -26,6 +26,9 @@ from .FefferyDraggable import FefferyDraggable as Draggable
 from .FefferyGrid import FefferyGrid as Grid
 from .FefferyGridItem import FefferyGridItem as GridItem
 from .FefferyRND import FefferyRND as RND
+from .FefferyMarkdownEditor import FefferyMarkdownEditor as MarkdownEditor
+from .FefferyRichTextEditor import FefferyRichTextEditor as RichTextEditor
+from .FefferyVditor import FefferyVditor as Vditor
 from .FefferyAnimatedImage import FefferyAnimatedImage as AnimatedImage
 from .FefferyBurger import FefferyBurger as Burger
 from .FefferyCaptcha import FefferyCaptcha as Captcha
@@ -36,6 +39,7 @@ from .FefferyCssVar import FefferyCssVar as CssVar
 from .FefferyDiv import FefferyDiv as Div
 from .FefferyDom2Image import FefferyDom2Image as Dom2Image
 from .FefferyEmojiPicker import FefferyEmojiPicker as EmojiPicker
+from .FefferyEventSource import FefferyEventSource as EventSource
 from .FefferyExecuteJs import FefferyExecuteJs as ExecuteJs
 from .FefferyExternalCss import FefferyExternalCss as ExternalCss
 from .FefferyExternalJs import FefferyExternalJs as ExternalJs
@@ -50,19 +54,19 @@ from .FefferyHttpRequests import FefferyHttpRequests as HttpRequests
 from .FefferyImagePaste import FefferyImagePaste as ImagePaste
 from .FefferyJsonViewer import FefferyJsonViewer as JsonViewer
 from .FefferyLazyLoad import FefferyLazyLoad as LazyLoad
-from .FefferyMarkdownEditor import FefferyMarkdownEditor as MarkdownEditor
 from .FefferyPhotoSphereViewer import FefferyPhotoSphereViewer as PhotoSphereViewer
 from .FefferyPortal import FefferyPortal as Portal
 from .FefferyQRCode import FefferyQRCode as QRCode
 from .FefferyRawHTML import FefferyRawHTML as RawHTML
 from .FefferyReload import FefferyReload as Reload
-from .FefferyRichTextEditor import FefferyRichTextEditor as RichTextEditor
 from .FefferyScroll import FefferyScroll as Scroll
 from .FefferyScrollbars import FefferyScrollbars as Scrollbars
 from .FefferySeamlessScroll import FefferySeamlessScroll as SeamlessScroll
+from .FefferySetFavicon import FefferySetFavicon as SetFavicon
 from .FefferySetTitle import FefferySetTitle as SetTitle
 from .FefferyShadowDom import FefferyShadowDom as ShadowDom
 from .FefferyShortcutPanel import FefferyShortcutPanel as ShortcutPanel
+from .FefferySliderCaptcha import FefferySliderCaptcha as SliderCaptcha
 from .FefferySticky import FefferySticky as Sticky
 from .FefferyStyle import FefferyStyle as Style
 from .FefferyTimeout import FefferyTimeout as Timeout
@@ -73,10 +77,13 @@ from .FefferyImageCropper import FefferyImageCropper as ImageCropper
 from .FefferyImageGallery import FefferyImageGallery as ImageGallery
 from .FefferyDeviceDetect import FefferyDeviceDetect as DeviceDetect
 from .FefferyDocumentVisibility import FefferyDocumentVisibility as DocumentVisibility
+from .FefferyEventListener import FefferyEventListener as EventListener
 from .FefferyGeolocation import FefferyGeolocation as Geolocation
 from .FefferyIdle import FefferyIdle as Idle
 from .FefferyInViewport import FefferyInViewport as InViewport
 from .FefferyKeyPress import FefferyKeyPress as KeyPress
+from .FefferyListenElementSize import FefferyListenElementSize as ListenElementSize
+from .FefferyListenHover import FefferyListenHover as ListenHover
 from .FefferyListenPaste import FefferyListenPaste as ListenPaste
 from .FefferyListenScroll import FefferyListenScroll as ListenScroll
 from .FefferyListenUnload import FefferyListenUnload as ListenUnload
@@ -105,7 +112,6 @@ from .FefferyLocalLargeStorage import FefferyLocalLargeStorage as LocalLargeStor
 from .FefferyLocalStorage import FefferyLocalStorage as LocalStorage
 from .FefferySessionStorage import FefferySessionStorage as SessionStorage
 from .FefferyThrottleProp import FefferyThrottleProp as ThrottleProp
-from .FefferyVditor import FefferyVditor as Vditor
 
 __all__ = [
     "AutoAnimate",
@@ -136,6 +142,9 @@ __all__ = [
     "Grid",
     "GridItem",
     "RND",
+    "MarkdownEditor",
+    "RichTextEditor",
+    "Vditor",
     "AnimatedImage",
     "Burger",
     "Captcha",
@@ -146,6 +155,7 @@ __all__ = [
     "Div",
     "Dom2Image",
     "EmojiPicker",
+    "EventSource",
     "ExecuteJs",
     "ExternalCss",
     "ExternalJs",
@@ -160,19 +170,19 @@ __all__ = [
     "ImagePaste",
     "JsonViewer",
     "LazyLoad",
-    "MarkdownEditor",
     "PhotoSphereViewer",
     "Portal",
     "QRCode",
     "RawHTML",
     "Reload",
-    "RichTextEditor",
     "Scroll",
     "Scrollbars",
     "SeamlessScroll",
+    "SetFavicon",
     "SetTitle",
     "ShadowDom",
     "ShortcutPanel",
+    "SliderCaptcha",
     "Sticky",
     "Style",
     "Timeout",
@@ -183,10 +193,13 @@ __all__ = [
     "ImageGallery",
     "DeviceDetect",
     "DocumentVisibility",
+    "EventListener",
     "Geolocation",
     "Idle",
     "InViewport",
     "KeyPress",
+    "ListenElementSize",
+    "ListenHover",
     "ListenPaste",
     "ListenScroll",
     "ListenUnload",
@@ -214,6 +227,5 @@ __all__ = [
     "LocalLargeStorage",
     "LocalStorage",
     "SessionStorage",
-    "ThrottleProp",
-    "Vditor"
-]
+    "ThrottleProp"
+]