feffery_antd_components 0.3.14 → 0.4.0-rc5

package/DESCRIPTION

@@ -1,6 +1,6 @@
 Package: fefferyAntdComponents
 Title: Best implementation of Antd components in Plotly Dash.
-Version: 0.3.14
+Version: 0.4.0-rc5
 Description: Best implementation of Antd components in Plotly Dash.
 Depends: R (>= 3.0.2)
 Imports: 

package/NAMESPACE

@@ -108,5 +108,5 @@ export('feffery'AntdCopyText)
 export('feffery'AntdTour)
 export('feffery'AntdWatermark)
 export('feffery'Fragment)
-export('feffery'AntdDraggablePanel)
-export('feffery'AntdEditorLayout)
+export(AntdDraggablePanel)
+export(AntdEditorLayout)

package/Project.toml

@@ -2,7 +2,7 @@
 name = "FefferyAntdComponents"
 uuid = "1b08a953-4be3-4667-9a23-674b58f7de79"
 authors = ["CNFeffery <fefferypzy@gmail.com>"]
-version = "0.3.14"
+version = "0.4.0-rc5"
 
 [deps]
 Dash = "1b08a953-4be3-4667-9a23-3db579824955"

package/README-en_US.md

@@ -15,7 +15,14 @@
 
 [简体中文](./README.md) | English
 
-Subproject of `feffery-components` projects, third-party components library of `Plotly Dash`, based on the [Antd](https://github.com/ant-design/ant-design), brings many common and powerful components into `Dash`🥳, latest stable version: `0.3.13` (2025-01-17)
+Subproject of `feffery-components` projects, third-party components library of `Plotly Dash`, based on the [Antd](https://github.com/ant-design/ant-design), brings many common and powerful components into `Dash`🥳, latest stable version: `0.3.15` (2025-01-30)
+
+## Dash Version Compatibility Notes
+
+| fac version | Compatible Dash Version |
+| :--------: | :---------------------: |
+| >=0.4.0    |        >=3.0.0          |
+| <0.4.0     |         <3.0.0          |
 
 ## 1 Install
 
@@ -26,7 +33,7 @@ pip install feffery-antd-components -U
 ## 2 Install the latest preview release version
 
 > [!NOTE]  
-> The latest preview release version (2024-08-09): `0.3.0rc31`
+> The latest preview release version (2025-04-26): `0.4.0rc4`
 
 ```bash
 pip install feffery-antd-components --pre -U

package/README.md

@@ -15,7 +15,14 @@
 
 简体中文 | [English](./README-en_US.md)
 
-`feffery-components`计划子项目，`Plotly Dash`第三方组件库，基于`Antd`，将超多具有丰富功能的通用网页常用交互组件引入`Dash`的生态中 🥳，最新稳定版本：`0.3.13`（2025-01-17）
+`feffery-components`计划子项目，`Plotly Dash`第三方组件库，基于`Antd`，将超多具有丰富功能的通用网页常用交互组件引入`Dash`的生态中 🥳，最新稳定版本：`0.3.15`（2025-01-30）
+
+## Dash版本兼容性说明
+
+| fac版本 | 适用Dash版本 |
+| :-----: | :----------: |
+| >=0.4.0 |   >=3.0.0    |
+| <0.4.0  |    <3.0.0    |
 
 ## 1 最新版本安装方式
 
@@ -26,7 +33,7 @@ pip install feffery-antd-components -U
 ## 2 最新预发布版本安装方式
 
 > [!NOTE]  
-> 最新预发布版本（2024-08-09）：`0.3.0rc31`
+> 最新预发布版本（2025-04-26）：`0.4.0rc4`
 
 ```bash
 pip install feffery-antd-components --pre -U
@@ -65,3 +72,17 @@ fac.AntdDatePicker(locale='de-de')
 <a href = "https://github.com/CNFeffery/feffery-antd-components/graphs/contributors">
   <img src = "https://contrib.rocks/image?repo=CNFeffery/feffery-antd-components"/>
 </a>
+
+## 7 更多应用开发教程
+
+> 微信公众号「玩转 Dash」，欢迎扫码关注 👇
+
+<p align="center" >
+  <img src="./images/公众号.png" height=220 />
+</p>
+
+> 「玩转 Dash」知识星球，海量教程案例模板资源，专业的答疑咨询服务，欢迎扫码加入 👇
+
+<p align="center" >
+  <img src="./images/知识星球.jpg" height=220 />
+</p>

package/feffery_antd_components/AntdAccordion.py

@@ -1,13 +1,21 @@
 # AUTO GENERATED FILE - DO NOT EDIT
 
 import typing  # noqa: F401
-import numbers # noqa: F401
 from typing_extensions import TypedDict, NotRequired, Literal # noqa: F401
 from dash.development.base_component import Component, _explicitize_args
-try:
-    from dash.development.base_component import ComponentType # noqa: F401
-except ImportError:
-    ComponentType = typing.TypeVar("ComponentType", bound=Component)
+
+ComponentType = typing.Union[
+    str,
+    int,
+    float,
+    Component,
+    None,
+    typing.Sequence[typing.Union[str, int, float, Component, None]],
+]
+
+NumberType = typing.Union[
+    typing.SupportsFloat, typing.SupportsInt, typing.SupportsComplex
+]
 
 
 class AntdAccordion(Component):
@@ -22,9 +30,6 @@ Keyword arguments:
 - key (string; optional):
     对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
-- style (dict; optional):
-    当前组件css样式.
-
 - className (string | dict; optional):
     当前组件css类名，支持[动态css](/advanced-classname).
 
@@ -110,20 +115,7 @@ Keyword arguments:
     `data-*`格式属性通配.
 
 - aria-* (string; optional):
-    `aria-*`格式属性通配.
-
-- loading_state (dict; optional)
-
-    `loading_state` is a dict with keys:
-
-    - is_loading (boolean; optional):
-        Determines if the component is loading or not.
-
-    - prop_name (string; optional):
-        Holds which property is loading.
-
-    - component_name (string; optional):
-        Holds the name of the component that is loading."""
+    `aria-*`格式属性通配."""
     _children_props = ['items[].children', 'items[].title', 'items[].extra']
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
@@ -147,51 +139,41 @@ Keyword arguments:
     Items = TypedDict(
         "Items",
             {
-            "children": NotRequired[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]],
+            "children": NotRequired[ComponentType],
             "className": NotRequired[typing.Union[str, dict]],
             "style": NotRequired[dict],
-            "key": typing.Union[str, typing.Union[int, float, numbers.Number]],
+            "key": typing.Union[str, NumberType],
             "collapsible": NotRequired[Literal["header", "disabled", "icon"]],
-            "title": NotRequired[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]],
-            "extra": NotRequired[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]],
+            "title": NotRequired[ComponentType],
+            "extra": NotRequired[ComponentType],
             "showArrow": NotRequired[bool],
             "forceRender": NotRequired[bool]
         }
     )
 
-    LoadingState = TypedDict(
-        "LoadingState",
-            {
-            "is_loading": NotRequired[bool],
-            "prop_name": NotRequired[str],
-            "component_name": NotRequired[str]
-        }
-    )
 
-    @_explicitize_args
     def __init__(
         self,
-        id: typing.Optional[str] = None,
+        id: typing.Optional[typing.Union[str, dict]] = None,
         key: typing.Optional[str] = None,
-        style: typing.Optional[dict] = None,
+        style: typing.Optional[typing.Any] = None,
         className: typing.Optional[typing.Union[str, dict]] = None,
         styles: typing.Optional["Styles"] = None,
         classNames: typing.Optional["ClassNames"] = None,
         items: typing.Optional[typing.Sequence["Items"]] = None,
         accordion: typing.Optional[bool] = None,
-        activeKey: typing.Optional[typing.Union[str, typing.Sequence[str], typing.Union[int, float, numbers.Number], typing.Sequence[typing.Union[int, float, numbers.Number]]]] = None,
-        defaultActiveKey: typing.Optional[typing.Union[str, typing.Sequence[str], typing.Union[int, float, numbers.Number], typing.Sequence[typing.Union[int, float, numbers.Number]]]] = None,
+        activeKey: typing.Optional[typing.Union[str, typing.Sequence[str], NumberType, typing.Sequence[NumberType]]] = None,
+        defaultActiveKey: typing.Optional[typing.Union[str, typing.Sequence[str], NumberType, typing.Sequence[NumberType]]] = None,
         bordered: typing.Optional[bool] = None,
         size: typing.Optional[Literal["large", "middle", "small"]] = None,
         collapsible: typing.Optional[Literal["header", "disabled", "icon"]] = None,
         expandIconPosition: typing.Optional[Literal["left", "right"]] = None,
         ghost: typing.Optional[bool] = None,
-        loading_state: typing.Optional["LoadingState"] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'style', 'className', 'styles', 'classNames', 'items', 'accordion', 'activeKey', 'defaultActiveKey', 'bordered', 'size', 'collapsible', 'expandIconPosition', 'ghost', 'data-*', 'aria-*', 'loading_state']
+        self._prop_names = ['id', 'key', 'style', 'className', 'styles', 'classNames', 'items', 'accordion', 'activeKey', 'defaultActiveKey', 'bordered', 'size', 'collapsible', 'expandIconPosition', 'ghost', 'data-*', 'aria-*']
         self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'style', 'className', 'styles', 'classNames', 'items', 'accordion', 'activeKey', 'defaultActiveKey', 'bordered', 'size', 'collapsible', 'expandIconPosition', 'ghost', 'data-*', 'aria-*', 'loading_state']
+        self.available_properties = ['id', 'key', 'style', 'className', 'styles', 'classNames', 'items', 'accordion', 'activeKey', 'defaultActiveKey', 'bordered', 'size', 'collapsible', 'expandIconPosition', 'ghost', 'data-*', 'aria-*']
         self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
@@ -199,3 +181,5 @@ Keyword arguments:
         args = {k: _locals[k] for k in _explicit_args}
 
         super(AntdAccordion, self).__init__(**args)
+
+setattr(AntdAccordion, "__init__", _explicitize_args(AntdAccordion.__init__))

package/feffery_antd_components/AntdAffix.py

@@ -1,13 +1,21 @@
 # AUTO GENERATED FILE - DO NOT EDIT
 
 import typing  # noqa: F401
-import numbers # noqa: F401
 from typing_extensions import TypedDict, NotRequired, Literal # noqa: F401
 from dash.development.base_component import Component, _explicitize_args
-try:
-    from dash.development.base_component import ComponentType # noqa: F401
-except ImportError:
-    ComponentType = typing.TypeVar("ComponentType", bound=Component)
+
+ComponentType = typing.Union[
+    str,
+    int,
+    float,
+    Component,
+    None,
+    typing.Sequence[typing.Union[str, int, float, Component, None]],
+]
+
+NumberType = typing.Union[
+    typing.SupportsFloat, typing.SupportsInt, typing.SupportsComplex
+]
 
 
 class AntdAffix(Component):
@@ -25,9 +33,6 @@ Keyword arguments:
 - children (a list of or a singular dash component, string or number; optional):
     组件型，内嵌元素.
 
-- style (dict; optional):
-    当前组件css样式.
-
 - className (string | dict; optional):
     当前组件css类名，支持[动态css](/advanced-classname).
 
@@ -40,54 +45,36 @@ Keyword arguments:
 - target (string; optional):
     滚动事件监听的特定目标容器id.
 
+- affixed (boolean; optional):
+    监听当前目标是否已触发固定.
+
 - data-* (string; optional):
     `data-*`格式属性通配.
 
 - aria-* (string; optional):
-    `aria-*`格式属性通配.
-
-- loading_state (dict; optional)
-
-    `loading_state` is a dict with keys:
-
-    - is_loading (boolean; optional):
-        Determines if the component is loading or not.
-
-    - prop_name (string; optional):
-        Holds which property is loading.
-
-    - component_name (string; optional):
-        Holds the name of the component that is loading."""
+    `aria-*`格式属性通配."""
     _children_props = []
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdAffix'
-    LoadingState = TypedDict(
-        "LoadingState",
-            {
-            "is_loading": NotRequired[bool],
-            "prop_name": NotRequired[str],
-            "component_name": NotRequired[str]
-        }
-    )
-
-    @_explicitize_args
+
+
     def __init__(
         self,
-        children: typing.Optional[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]] = None,
-        id: typing.Optional[str] = None,
+        children: typing.Optional[ComponentType] = None,
+        id: typing.Optional[typing.Union[str, dict]] = None,
         key: typing.Optional[str] = None,
-        style: typing.Optional[dict] = None,
+        style: typing.Optional[typing.Any] = None,
         className: typing.Optional[typing.Union[str, dict]] = None,
-        offsetBottom: typing.Optional[typing.Union[int, float, numbers.Number]] = None,
-        offsetTop: typing.Optional[typing.Union[int, float, numbers.Number]] = None,
+        offsetBottom: typing.Optional[NumberType] = None,
+        offsetTop: typing.Optional[NumberType] = None,
         target: typing.Optional[str] = None,
-        loading_state: typing.Optional["LoadingState"] = None,
+        affixed: typing.Optional[bool] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'children', 'style', 'className', 'offsetBottom', 'offsetTop', 'target', 'data-*', 'aria-*', 'loading_state']
+        self._prop_names = ['id', 'key', 'children', 'style', 'className', 'offsetBottom', 'offsetTop', 'target', 'affixed', 'data-*', 'aria-*']
         self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'children', 'style', 'className', 'offsetBottom', 'offsetTop', 'target', 'data-*', 'aria-*', 'loading_state']
+        self.available_properties = ['id', 'key', 'children', 'style', 'className', 'offsetBottom', 'offsetTop', 'target', 'affixed', 'data-*', 'aria-*']
         self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
@@ -95,3 +82,5 @@ Keyword arguments:
         args = {k: _locals[k] for k in _explicit_args if k != 'children'}
 
         super(AntdAffix, self).__init__(children=children, **args)
+
+setattr(AntdAffix, "__init__", _explicitize_args(AntdAffix.__init__))

package/feffery_antd_components/AntdAlert.py

@@ -1,13 +1,21 @@
 # AUTO GENERATED FILE - DO NOT EDIT
 
 import typing  # noqa: F401
-import numbers # noqa: F401
 from typing_extensions import TypedDict, NotRequired, Literal # noqa: F401
 from dash.development.base_component import Component, _explicitize_args
-try:
-    from dash.development.base_component import ComponentType # noqa: F401
-except ImportError:
-    ComponentType = typing.TypeVar("ComponentType", bound=Component)
+
+ComponentType = typing.Union[
+    str,
+    int,
+    float,
+    Component,
+    None,
+    typing.Sequence[typing.Union[str, int, float, Component, None]],
+]
+
+NumberType = typing.Union[
+    typing.SupportsFloat, typing.SupportsInt, typing.SupportsComplex
+]
 
 
 class AntdAlert(Component):
@@ -22,9 +30,6 @@ Keyword arguments:
 - key (string; optional):
     对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
-- style (dict; optional):
-    当前组件css样式.
-
 - className (string | dict; optional):
     当前组件css类名，支持[动态css](/advanced-classname).
 
@@ -60,55 +65,33 @@ Keyword arguments:
     `data-*`格式属性通配.
 
 - aria-* (string; optional):
-    `aria-*`格式属性通配.
-
-- loading_state (dict; optional)
-
-    `loading_state` is a dict with keys:
-
-    - is_loading (boolean; optional):
-        Determines if the component is loading or not.
-
-    - prop_name (string; optional):
-        Holds which property is loading.
-
-    - component_name (string; optional):
-        Holds the name of the component that is loading."""
+    `aria-*`格式属性通配."""
     _children_props = ['message', 'description', 'icon', 'action']
     _base_nodes = ['message', 'description', 'icon', 'action', 'children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdAlert'
-    LoadingState = TypedDict(
-        "LoadingState",
-            {
-            "is_loading": NotRequired[bool],
-            "prop_name": NotRequired[str],
-            "component_name": NotRequired[str]
-        }
-    )
-
-    @_explicitize_args
+
+
     def __init__(
         self,
-        id: typing.Optional[str] = None,
+        id: typing.Optional[typing.Union[str, dict]] = None,
         key: typing.Optional[str] = None,
-        style: typing.Optional[dict] = None,
+        style: typing.Optional[typing.Any] = None,
         className: typing.Optional[typing.Union[str, dict]] = None,
-        message: typing.Optional[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]] = None,
-        description: typing.Optional[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]] = None,
+        message: typing.Optional[ComponentType] = None,
+        description: typing.Optional[ComponentType] = None,
         type: typing.Optional[Literal["success", "info", "warning", "error"]] = None,
         showIcon: typing.Optional[bool] = None,
-        icon: typing.Optional[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]] = None,
+        icon: typing.Optional[ComponentType] = None,
         closable: typing.Optional[bool] = None,
         messageRenderMode: typing.Optional[Literal["default", "loop-text", "marquee"]] = None,
-        action: typing.Optional[typing.Union[str, int, float, ComponentType, typing.Sequence[typing.Union[str, int, float, ComponentType]]]] = None,
+        action: typing.Optional[ComponentType] = None,
         banner: typing.Optional[bool] = None,
-        loading_state: typing.Optional["LoadingState"] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'style', 'className', 'message', 'description', 'type', 'showIcon', 'icon', 'closable', 'messageRenderMode', 'action', 'banner', 'data-*', 'aria-*', 'loading_state']
+        self._prop_names = ['id', 'key', 'style', 'className', 'message', 'description', 'type', 'showIcon', 'icon', 'closable', 'messageRenderMode', 'action', 'banner', 'data-*', 'aria-*']
         self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'style', 'className', 'message', 'description', 'type', 'showIcon', 'icon', 'closable', 'messageRenderMode', 'action', 'banner', 'data-*', 'aria-*', 'loading_state']
+        self.available_properties = ['id', 'key', 'style', 'className', 'message', 'description', 'type', 'showIcon', 'icon', 'closable', 'messageRenderMode', 'action', 'banner', 'data-*', 'aria-*']
         self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
@@ -116,3 +99,5 @@ Keyword arguments:
         args = {k: _locals[k] for k in _explicit_args}
 
         super(AntdAlert, self).__init__(**args)
+
+setattr(AntdAlert, "__init__", _explicitize_args(AntdAlert.__init__))

package/feffery_antd_components/AntdAnchor.py

@@ -1,13 +1,21 @@
 # AUTO GENERATED FILE - DO NOT EDIT
 
 import typing  # noqa: F401
-import numbers # noqa: F401
 from typing_extensions import TypedDict, NotRequired, Literal # noqa: F401
 from dash.development.base_component import Component, _explicitize_args
-try:
-    from dash.development.base_component import ComponentType # noqa: F401
-except ImportError:
-    ComponentType = typing.TypeVar("ComponentType", bound=Component)
+
+ComponentType = typing.Union[
+    str,
+    int,
+    float,
+    Component,
+    None,
+    typing.Sequence[typing.Union[str, int, float, Component, None]],
+]
+
+NumberType = typing.Union[
+    typing.SupportsFloat, typing.SupportsInt, typing.SupportsComplex
+]
 
 
 class AntdAnchor(Component):
@@ -22,9 +30,6 @@ Keyword arguments:
 - key (string; optional):
     对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
-- style (dict; optional):
-    当前组件css样式.
-
 - className (string | dict; optional):
     当前组件css类名，支持[动态css](/advanced-classname).
 
@@ -56,54 +61,32 @@ Keyword arguments:
     `data-*`格式属性通配.
 
 - aria-* (string; optional):
-    `aria-*`格式属性通配.
-
-- loading_state (dict; optional)
-
-    `loading_state` is a dict with keys:
-
-    - is_loading (boolean; optional):
-        Determines if the component is loading or not.
-
-    - prop_name (string; optional):
-        Holds which property is loading.
-
-    - component_name (string; optional):
-        Holds the name of the component that is loading."""
+    `aria-*`格式属性通配."""
     _children_props = []
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdAnchor'
-    LoadingState = TypedDict(
-        "LoadingState",
-            {
-            "is_loading": NotRequired[bool],
-            "prop_name": NotRequired[str],
-            "component_name": NotRequired[str]
-        }
-    )
-
-    @_explicitize_args
+
+
     def __init__(
         self,
-        id: typing.Optional[str] = None,
+        id: typing.Optional[typing.Union[str, dict]] = None,
         key: typing.Optional[str] = None,
-        style: typing.Optional[dict] = None,
+        style: typing.Optional[typing.Any] = None,
         className: typing.Optional[typing.Union[str, dict]] = None,
         linkDict: typing.Optional[typing.Any] = None,
         align: typing.Optional[Literal["left", "right"]] = None,
         containerId: typing.Optional[str] = None,
-        targetOffset: typing.Optional[typing.Union[int, float, numbers.Number]] = None,
+        targetOffset: typing.Optional[NumberType] = None,
         affix: typing.Optional[bool] = None,
-        bounds: typing.Optional[typing.Union[int, float, numbers.Number]] = None,
-        offsetTop: typing.Optional[typing.Union[int, float, numbers.Number]] = None,
+        bounds: typing.Optional[NumberType] = None,
+        offsetTop: typing.Optional[NumberType] = None,
         clickedLink: typing.Optional[dict] = None,
-        loading_state: typing.Optional["LoadingState"] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'style', 'className', 'linkDict', 'align', 'containerId', 'targetOffset', 'affix', 'bounds', 'offsetTop', 'clickedLink', 'data-*', 'aria-*', 'loading_state']
+        self._prop_names = ['id', 'key', 'style', 'className', 'linkDict', 'align', 'containerId', 'targetOffset', 'affix', 'bounds', 'offsetTop', 'clickedLink', 'data-*', 'aria-*']
         self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'style', 'className', 'linkDict', 'align', 'containerId', 'targetOffset', 'affix', 'bounds', 'offsetTop', 'clickedLink', 'data-*', 'aria-*', 'loading_state']
+        self.available_properties = ['id', 'key', 'style', 'className', 'linkDict', 'align', 'containerId', 'targetOffset', 'affix', 'bounds', 'offsetTop', 'clickedLink', 'data-*', 'aria-*']
         self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
@@ -111,3 +94,5 @@ Keyword arguments:
         args = {k: _locals[k] for k in _explicit_args}
 
         super(AntdAnchor, self).__init__(**args)
+
+setattr(AntdAnchor, "__init__", _explicitize_args(AntdAnchor.__init__))