feffery_antd_components 0.4.0 → 0.4.2

package/DESCRIPTION

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

package/NAMESPACE

@@ -106,8 +106,7 @@ export('feffery'AntdAffix)
 export('feffery'AntdBackTop)
 export('feffery'AntdConfigProvider)
 export('feffery'AntdCopyText)
+export('feffery'AntdHappyProvider)
 export('feffery'AntdTour)
 export('feffery'AntdWatermark)
 export('feffery'Fragment)
-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.4.0"
+version = "0.4.2"
 
 [deps]
 Dash = "1b08a953-4be3-4667-9a23-3db579824955"

package/README-en_US.md

@@ -15,7 +15,7 @@
 
 [简体中文](./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.15` (2025-01-30)
+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.4.2` (2025-08-20)
 
 ## Dash Version Compatibility Notes
 
@@ -52,7 +52,7 @@ app = dash.Dash(serve_locally=False)
 
 ## 5 Internationalization
 
-Some components in `fac` have built-in copy information, and internationalization settings can be made through the parameter `locale`. The default is `'zh-cn'`, which is Simplified Chinese. You can set it to `'en-us'` and `'de-de'` to use English and German copy, respectively. For example:
+Some components in `fac` have built-in copy information, and internationalization settings can be made through the parameter `locale`. The default is `'zh-cn'`, which is Simplified Chinese. You can set it to `'en-us'`, `'de-de'`, or `'ru-ru'` to use different languages, for example:
 
 ```Python
 fac.AntdDatePicker(locale='en-us')

package/README.md

@@ -15,7 +15,7 @@
 
 简体中文 | [English](./README-en_US.md)
 
-`feffery-components`计划子项目，`Plotly Dash`第三方组件库，基于`Antd`，将超多具有丰富功能的通用网页常用交互组件引入`Dash`的生态中 🥳，最新稳定版本：`0.3.15`（2025-01-30）
+`feffery-components`计划子项目，`Plotly Dash`第三方组件库，基于`Antd`，将超多具有丰富功能的通用网页常用交互组件引入`Dash`的生态中 🥳，最新稳定版本：`0.4.2`（2025-08-20）
 
 ## Dash版本兼容性说明
 
@@ -53,7 +53,7 @@ app = dash.Dash(serve_locally=False)
 
 ## 5 国际化
 
-`fac`中的部分组件具有自带的文案信息，通过参数`locale`可以进行国际化设置，默认为`'zh-cn'`即简体中文，你可以设置为`'en-us'`和`'de-de'`来使用英文文案和德语文案，譬如：
+`fac`中的部分组件具有自带的文案信息，通过参数`locale`可以进行国际化设置，默认为`'zh-cn'`即简体中文，你可以设置为`'en-us'`、`'de-de'`、`'ru-ru'`来使用不同语言，譬如：
 
 ```Python
 fac.AntdDatePicker(locale='en-us')

package/feffery_antd_components/AntdHappyProvider.py

@@ -0,0 +1,63 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+import typing  # noqa: F401
+from typing_extensions import TypedDict, NotRequired, Literal # noqa: F401
+from dash.development.base_component import Component, _explicitize_args
+
+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 AntdHappyProvider(Component):
+    """An AntdHappyProvider component.
+快乐工作特效组件AntdHappyProvider
+
+Keyword arguments:
+
+- id (string; optional):
+    组件唯一id.
+
+- key (string; optional):
+    对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
+
+- children (a list of or a singular dash component, string or number; optional):
+    组件型，内嵌元素.
+
+- disabled (boolean; default False):
+    是否禁用当前特效  默认值：`False`."""
+    _children_props = []
+    _base_nodes = ['children']
+    _namespace = 'feffery_antd_components'
+    _type = 'AntdHappyProvider'
+
+
+    def __init__(
+        self,
+        children: typing.Optional[ComponentType] = None,
+        id: typing.Optional[typing.Union[str, dict]] = None,
+        key: typing.Optional[str] = None,
+        disabled: typing.Optional[bool] = None,
+        **kwargs
+    ):
+        self._prop_names = ['id', 'key', 'children', 'disabled']
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['id', 'key', 'children', 'disabled']
+        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 if k != 'children'}
+
+        super(AntdHappyProvider, self).__init__(children=children, **args)
+
+setattr(AntdHappyProvider, "__init__", _explicitize_args(AntdHappyProvider.__init__))

package/feffery_antd_components/AntdModal.py

@@ -196,6 +196,9 @@ Keyword arguments:
 - okClickClose (boolean; default True):
     是否点击确认按钮触发对话框关闭  默认值：`True`.
 
+- preventClose (boolean; default False):
+    是否阻止通过点击关闭图标、点击遮罩层区域、点击取消、按下ESC等方式自动触发的对话框关闭行为  默认值：`False`.
+
 - zIndex (number; default 1000):
     模态框z-index  默认值：`1000`.
 
@@ -326,6 +329,7 @@ Keyword arguments:
         mask: typing.Optional[bool] = None,
         maskClosable: typing.Optional[bool] = None,
         okClickClose: typing.Optional[bool] = None,
+        preventClose: typing.Optional[bool] = None,
         zIndex: typing.Optional[NumberType] = None,
         okCounts: typing.Optional[NumberType] = None,
         cancelCounts: typing.Optional[NumberType] = None,
@@ -339,9 +343,9 @@ Keyword arguments:
         loading: typing.Optional[bool] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
+        self._prop_names = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'preventClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
         self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
+        self.available_properties = ['id', 'key', 'children', 'style', 'className', 'styles', 'classNames', 'locale', 'visible', 'title', 'renderFooter', 'okText', 'okButtonProps', 'cancelText', 'cancelButtonProps', 'width', 'centered', 'keyboard', 'closable', 'mask', 'maskClosable', 'okClickClose', 'preventClose', 'zIndex', 'okCounts', 'cancelCounts', 'closeCounts', 'confirmAutoSpin', 'loadingOkText', 'confirmLoading', 'transitionType', 'forceRender', 'destroyOnClose', 'loading', 'data-*', 'aria-*']
         self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_antd_components/AntdProgress.py

@@ -40,8 +40,8 @@ Keyword arguments:
     进度条尺寸规格，可选项有`'small'`、`'default'`、`'large'`，传入数值型表示像素尺寸，传入字典型可分别控制宽度和高度
     默认值：`'default'`.
 
-    `size` is a number | list of numbers | a value equal to: 'small',
-    'default' | dict with keys:
+    `size` is a number | list of number | strings | a value equal to:
+    'small', 'default' | dict with keys:
 
     - width (number; optional):
         像素宽度.
@@ -96,16 +96,27 @@ Keyword arguments:
 - showInfo (boolean; default True):
     是否显示进度数值或状态图标  默认值：`True`.
 
+- percentPosition (dict; optional):
+    适用于`'line'`型进度条，配置进度条附带进度数值信息显示位置.
+
+    `percentPosition` is a dict with keys:
+
+    - align (a value equal to: 'start', 'center', 'end'; optional):
+        对齐方式，可选项有`'start'`、`'center'`、`'end'`.
+
+    - type (a value equal to: 'inner', 'outer'; optional):
+        内外位置，可选项有`'inner'`、`'outer'`.
+
 - strokeColor (dict; optional):
     配置进度条颜色，支持渐变色.
 
-    `strokeColor` is a string | dict with keys:
+    `strokeColor` is a string | list of strings | dict with keys:
 
     - from (string; optional):
         渐变色开端颜色.
 
     - to (string; optional):
-        渐变色末端颜色.
+        渐变色末端颜色. | dict with strings as keys and values of type string
 
 - strokeLinecap (a value equal to: 'round', 'butt', 'square'; optional):
     进度条线型，可选项有`'round'`、`'butt'`、`'square'`  默认值：`'round'`.
@@ -123,8 +134,16 @@ Keyword arguments:
     仪表盘缺口方向，可选项有`'top'`、`'bottom'`、`'left'`、`'right'`，仅`type='dashboard'`时可用
     默认值：`'bottom'`.
 
-- steps (number; optional):
-    进度条分段数量.
+- steps (dict; optional):
+    配置进度条分段数量，针对`'circle'`、`'dashboard'`型进度条支持传入字典型进行更详细的配置.
+
+    `steps` is a number | dict with keys:
+
+    - count (number; optional):
+        分段数量.
+
+    - gap (number; optional):
+        分段间隔像素大小.
 
 - data-* (string; optional):
     `data-*`格式属性通配.
@@ -168,6 +187,14 @@ Keyword arguments:
         }
     )
 
+    PercentPosition = TypedDict(
+        "PercentPosition",
+            {
+            "align": NotRequired[Literal["start", "center", "end"]],
+            "type": NotRequired[Literal["inner", "outer"]]
+        }
+    )
+
     StrokeColor = TypedDict(
         "StrokeColor",
             {
@@ -176,6 +203,14 @@ Keyword arguments:
         }
     )
 
+    Steps = TypedDict(
+        "Steps",
+            {
+            "count": NotRequired[NumberType],
+            "gap": NotRequired[NumberType]
+        }
+    )
+
 
     def __init__(
         self,
@@ -184,24 +219,25 @@ Keyword arguments:
         style: typing.Optional[typing.Any] = None,
         className: typing.Optional[typing.Union[str, dict]] = None,
         type: typing.Optional[Literal["line", "circle", "dashboard"]] = None,
-        size: typing.Optional[typing.Union[NumberType, typing.Sequence[NumberType], Literal["small", "default"], "Size"]] = None,
+        size: typing.Optional[typing.Union[NumberType, typing.Sequence[typing.Union[NumberType, str]], Literal["small", "default"], "Size"]] = None,
         percent: typing.Optional[NumberType] = None,
         success: typing.Optional["Success"] = None,
         format: typing.Optional["Format"] = None,
         status: typing.Optional[Literal["success", "exception", "normal", "active"]] = None,
         showInfo: typing.Optional[bool] = None,
-        strokeColor: typing.Optional[typing.Union[str, "StrokeColor"]] = None,
+        percentPosition: typing.Optional["PercentPosition"] = None,
+        strokeColor: typing.Optional[typing.Union[str, typing.Sequence[str], "StrokeColor", typing.Dict[typing.Union[str, float, int], str]]] = None,
         strokeLinecap: typing.Optional[Literal["round", "butt", "square"]] = None,
         strokeWidth: typing.Optional[NumberType] = None,
         trailColor: typing.Optional[str] = None,
         gapDegree: typing.Optional[NumberType] = None,
         gapPosition: typing.Optional[Literal["top", "bottom", "left", "right"]] = None,
-        steps: typing.Optional[NumberType] = None,
+        steps: typing.Optional[typing.Union[NumberType, "Steps"]] = None,
         **kwargs
     ):
-        self._prop_names = ['id', 'key', 'style', 'className', 'type', 'size', 'percent', 'success', 'format', 'status', 'showInfo', 'strokeColor', 'strokeLinecap', 'strokeWidth', 'trailColor', 'gapDegree', 'gapPosition', 'steps', 'data-*', 'aria-*']
+        self._prop_names = ['id', 'key', 'style', 'className', 'type', 'size', 'percent', 'success', 'format', 'status', 'showInfo', 'percentPosition', 'strokeColor', 'strokeLinecap', 'strokeWidth', 'trailColor', 'gapDegree', 'gapPosition', 'steps', 'data-*', 'aria-*']
         self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'style', 'className', 'type', 'size', 'percent', 'success', 'format', 'status', 'showInfo', 'strokeColor', 'strokeLinecap', 'strokeWidth', 'trailColor', 'gapDegree', 'gapPosition', 'steps', 'data-*', 'aria-*']
+        self.available_properties = ['id', 'key', 'style', 'className', 'type', 'size', 'percent', 'success', 'format', 'status', 'showInfo', 'percentPosition', 'strokeColor', 'strokeLinecap', 'strokeWidth', 'trailColor', 'gapDegree', 'gapPosition', 'steps', 'data-*', 'aria-*']
         self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_antd_components/AntdTable.py

@@ -92,8 +92,45 @@ Keyword arguments:
             当`renderType`为`'mini-line'`、`'mini-area'`、`'mini-bar'`时，设置用于渲染信息卡片的`javascript`函数字符串.
 
         - progressOneHundredPercentColor (string; optional):
-            当`renderType`为`'mini-progress'`、`'mini-ring-progress'`时，设置进度完成状态下的填充色
-            默认值：`'#52c41a'`.
+            当`renderType`为`'mini-progress'`、`'mini-ring-progress'`时，设置进度完成状态下的填充色.
+
+        - progressShowPercent (boolean; optional):
+            当`renderType`为`'mini-progress'`时，设置进度条是否附带进度数值信息
+            默认值：`False`.
+
+        - progressPercentPrecision (number; optional):
+            当`renderType`为`'mini-progress'`时，设置进度条附带进度数值信息的小数位数，默认保持原始数值的精度.
+
+        - progressPercentPosition (dict; optional):
+            当`renderType`为`'mini-progress'`时，设置进度条附带进度数值信息显示的位置.
+
+            `progressPercentPosition` is a dict with keys:
+
+            - align (a value equal to: 'start', 'center', 'end'; optional):
+                对齐方式，可选项有`'start'`、`'center'`、`'end'`.
+
+            - type (a value equal to: 'inner', 'outer'; optional):
+                内外位置，可选项有`'inner'`、`'outer'`.
+
+        - progressStrokeLinecap (a value equal to: 'square', 'round'; optional):
+            当`renderType`为`'mini-progress'`时，设置进度条形状类型，可选项有`'square'`、`'round'`
+            默认值：`'square'`.
+
+        - progressSize (number; optional):
+            当`renderType`为`'mini-progress'`时，设置进度条像素尺寸.
+
+        - progressColor (dict; optional):
+            当`renderType`为`'mini-progress'`时，设置进度条主体部分颜色，支持通过字段`'from'`、`'to'`配置渐变色.
+
+            `progressColor` is a string
+
+          Or dict with keys:
+
+    - from (string; optional):
+        渐变色起始颜色.
+
+    - to (string; optional):
+        渐变色结束颜色.
 
         - ringProgressFontSize (number; optional):
             当`renderType='mini-ring-progress'`时，设置进度数值像素大小.
@@ -272,6 +309,18 @@ Keyword arguments:
     - iconRenderer (a value equal to: 'AntdIcon', 'fontawesome'; optional):
         适用于`'button'`模式，按钮前缀图标渲染方式，可选项有`'AntdIcon'`、`'fontawesome'`.
 
+    - tooltip (dict; optional):
+        适用于`'button'`模式，为当前按钮添加额外的文字提示功能.
+
+        `tooltip` is a dict with keys:
+
+        - title (string; optional):
+            文字提示内容.
+
+        - placement (a value equal to: 'top', 'left', 'right', 'bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight'; optional):
+            文字提示弹出方向，可选项有`'top'`、`'left'`、`'right'`、`'bottom'`、`'topLeft'`、`'topRight'`、`'bottomLeft'`、`'bottomRight'`、`'leftTop'`、`'leftBottom'`、`'rightTop'`、`'rightBottom'`
+            默认值：`'top'`.
+
     - custom (boolean | number | string | dict | list; optional):
         适用于`'button'`模式，额外补充信息. | list of dicts with keys:
 
@@ -976,6 +1025,22 @@ Keyword arguments:
         }
     )
 
+    ColumnsRenderOptionsProgressPercentPosition = TypedDict(
+        "ColumnsRenderOptionsProgressPercentPosition",
+            {
+            "align": NotRequired[Literal["start", "center", "end"]],
+            "type": NotRequired[Literal["inner", "outer"]]
+        }
+    )
+
+    ColumnsRenderOptionsProgressColor = TypedDict(
+        "ColumnsRenderOptionsProgressColor",
+            {
+            "from": NotRequired[str],
+            "to": NotRequired[str]
+        }
+    )
+
     ColumnsRenderOptionsDropdownProps = TypedDict(
         "ColumnsRenderOptionsDropdownProps",
             {
@@ -998,6 +1063,12 @@ Keyword arguments:
             "miniChartColor": NotRequired[str],
             "tooltipCustomContent": NotRequired[str],
             "progressOneHundredPercentColor": NotRequired[str],
+            "progressShowPercent": NotRequired[bool],
+            "progressPercentPrecision": NotRequired[NumberType],
+            "progressPercentPosition": NotRequired["ColumnsRenderOptionsProgressPercentPosition"],
+            "progressStrokeLinecap": NotRequired[Literal["square", "round"]],
+            "progressSize": NotRequired[NumberType],
+            "progressColor": NotRequired[typing.Union[str, "ColumnsRenderOptionsProgressColor"]],
             "ringProgressFontSize": NotRequired[NumberType],
             "dropdownProps": NotRequired["ColumnsRenderOptionsDropdownProps"]
         }
@@ -1072,6 +1143,14 @@ Keyword arguments:
         }
     )
 
+    DataTooltip = TypedDict(
+        "DataTooltip",
+            {
+            "title": NotRequired[str],
+            "placement": NotRequired[Literal["top", "left", "right", "bottom", "topLeft", "topRight", "bottomLeft", "bottomRight"]]
+        }
+    )
+
     DataSize = TypedDict(
         "DataSize",
             {

package/feffery_antd_components/_imports_.py

@@ -104,6 +104,7 @@ from .AntdAffix import AntdAffix
 from .AntdBackTop import AntdBackTop
 from .AntdConfigProvider import AntdConfigProvider
 from .AntdCopyText import AntdCopyText
+from .AntdHappyProvider import AntdHappyProvider
 from .AntdTour import AntdTour
 from .AntdWatermark import AntdWatermark
 from .Fragment import Fragment
@@ -215,6 +216,7 @@ __all__ = [
     "AntdBackTop",
     "AntdConfigProvider",
     "AntdCopyText",
+    "AntdHappyProvider",
     "AntdTour",
     "AntdWatermark",
     "Fragment"

package/feffery_antd_components/alias.py

@@ -104,6 +104,7 @@ from .AntdAffix import AntdAffix as Affix
 from .AntdBackTop import AntdBackTop as BackTop
 from .AntdConfigProvider import AntdConfigProvider as ConfigProvider
 from .AntdCopyText import AntdCopyText as CopyText
+from .AntdHappyProvider import AntdHappyProvider as HappyProvider
 from .AntdTour import AntdTour as Tour
 from .AntdWatermark import AntdWatermark as Watermark
 from .Fragment import Fragment
@@ -215,6 +216,7 @@ __all__ = [
     "BackTop",
     "ConfigProvider",
     "CopyText",
+    "HappyProvider",
     "Tour",
     "Watermark",
     "Fragment",