feffery_antd_components 0.3.0-rc9 → 0.3.1

package/feffery_antd_components/AntdAvatarGroup.py

@@ -5,17 +5,27 @@ from dash.development.base_component import Component, _explicitize_args
 
 class AntdAvatarGroup(Component):
     """An AntdAvatarGroup component.
-
+头像组合组件AntdAvatarGroup
 
 Keyword arguments:
 
-- children (a list of or a singular dash component, string or number; optional)
+- children (a list of or a singular dash component, string or number; optional):
+    组件型，传入组内各`AntdAvatar`组件.
+
+- id (string; optional):
+    组件唯一id.
+
+- aria-* (string; optional):
+    `aria-*`格式属性通配.
 
-- id (string; optional)
+- className (string | dict; optional):
+    当前组件css类名，支持[动态css](/advanced-classname).
 
-- className (string | dict; optional)
+- data-* (string; optional):
+    `data-*`格式属性通配.
 
-- key (string; optional)
+- key (string; optional):
+    对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
 - loading_state (dict; optional)
 
@@ -30,15 +40,22 @@ Keyword arguments:
     - prop_name (string; optional):
         Holds which property is loading.
 
-- maxCount (number; optional)
+- maxCount (number; optional):
+    最多显示的头像个数，默认无限制.
 
-- maxPopoverPlacement (a value equal to: 'top', 'bottom'; default 'top')
+- maxPopoverPlacement (a value equal to: 'top', 'bottom'; default 'top'):
+    超出`maxCount`数量限制之外的头像气泡卡片弹出方位，可选项有`'top'`、`'bottom'`  默认值：`'top'`.
 
-- maxPopoverTrigger (a value equal to: 'hover', 'click'; default 'hover')
+- maxPopoverTrigger (a value equal to: 'hover', 'click'; default 'hover'):
+    超出`maxCount`数量限制之外的头像气泡卡片弹出触发方式，可选项有`'hover'`、`'click'`
+    默认值：`'hover'`.
 
-- maxStyle (dict; optional)
+- maxStyle (dict; optional):
+    头像省略部分css样式.
 
-- size (dict; default 'default')
+- size (dict; default 'default'):
+    统一设置内部头像尺寸规格，传入数值型表示像素尺寸，传入字符型表示内置规格，可选项有`'large'`、`'small'`、`'default'`，支持响应式断点
+    默认值：`'default'`.
 
     `size` is a number | a value equal to: 'large', 'small', 'default'
     | dict with keys:
@@ -55,17 +72,18 @@ Keyword arguments:
 
     - xxl (number; optional)
 
-- style (dict; optional)"""
+- style (dict; optional):
+    当前组件css样式."""
     _children_props = []
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdAvatarGroup'
     @_explicitize_args
-    def __init__(self, children=None, id=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, key=Component.UNDEFINED, maxCount=Component.UNDEFINED, maxPopoverPlacement=Component.UNDEFINED, maxPopoverTrigger=Component.UNDEFINED, maxStyle=Component.UNDEFINED, size=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['children', 'id', 'className', 'key', 'loading_state', 'maxCount', 'maxPopoverPlacement', 'maxPopoverTrigger', 'maxStyle', 'size', 'style']
-        self._valid_wildcard_attributes =            []
-        self.available_properties = ['children', 'id', 'className', 'key', 'loading_state', 'maxCount', 'maxPopoverPlacement', 'maxPopoverTrigger', 'maxStyle', 'size', 'style']
-        self.available_wildcard_properties =            []
+    def __init__(self, children=None, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, maxCount=Component.UNDEFINED, maxPopoverPlacement=Component.UNDEFINED, maxPopoverTrigger=Component.UNDEFINED, maxStyle=Component.UNDEFINED, size=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['children', 'id', 'aria-*', 'className', 'data-*', 'key', 'loading_state', 'maxCount', 'maxPopoverPlacement', 'maxPopoverTrigger', 'maxStyle', 'size', 'style']
+        self._valid_wildcard_attributes =            ['data-', 'aria-']
+        self.available_properties = ['children', 'id', 'aria-*', 'className', 'data-*', 'key', 'loading_state', 'maxCount', 'maxPopoverPlacement', 'maxPopoverTrigger', 'maxStyle', 'size', 'style']
+        self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
         _locals.update(kwargs)  # For wildcard attrs and excess named props

package/feffery_antd_components/AntdBackTop.py

@@ -5,21 +5,33 @@ from dash.development.base_component import Component, _explicitize_args
 
 class AntdBackTop(Component):
     """An AntdBackTop component.
-
+回到顶部组件AntdBackTop
 
 Keyword arguments:
 
-- id (string; optional)
+- id (string; optional):
+    组件唯一id.
+
+- aria-* (string; optional):
+    `aria-*`格式属性通配.
 
-- className (string | dict; optional)
+- className (string | dict; optional):
+    当前组件css类名，支持[动态css](/advanced-classname).
 
-- containerId (string; optional)
+- containerId (string; optional):
+    滚动事件监听的特定目标容器id.
 
-- containerSelector (string; optional)
+- containerSelector (string; optional):
+    滚动事件监听的特定目标容器js选择代码，优先级低于containerId.
 
-- duration (number; default 0.45)
+- data-* (string; optional):
+    `data-*`格式属性通配.
 
-- key (string; optional)
+- duration (number; default 0.45):
+    回到顶部过程耗时，单位：秒  默认值：`0.45`.
+
+- key (string; optional):
+    对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
 - loading_state (dict; optional)
 
@@ -34,19 +46,24 @@ Keyword arguments:
     - prop_name (string; optional):
         Holds which property is loading.
 
-- style (dict; optional)
+- nClicks (number; default 0):
+    监听回到顶部按钮累计被点击次数  默认值：`0`.
+
+- style (dict; optional):
+    当前组件css样式.
 
-- visibilityHeight (number; default 400)"""
+- visibilityHeight (number; default 400):
+    回到顶部按钮显示时对应的页面滚动像素高度阈值  默认值：`400`."""
     _children_props = []
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdBackTop'
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, key=Component.UNDEFINED, duration=Component.UNDEFINED, visibilityHeight=Component.UNDEFINED, containerId=Component.UNDEFINED, containerSelector=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'className', 'containerId', 'containerSelector', 'duration', 'key', 'loading_state', 'style', 'visibilityHeight']
-        self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'className', 'containerId', 'containerSelector', 'duration', 'key', 'loading_state', 'style', 'visibilityHeight']
-        self.available_wildcard_properties =            []
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, duration=Component.UNDEFINED, visibilityHeight=Component.UNDEFINED, containerId=Component.UNDEFINED, containerSelector=Component.UNDEFINED, nClicks=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'aria-*', 'className', 'containerId', 'containerSelector', 'data-*', 'duration', 'key', 'loading_state', 'nClicks', 'style', 'visibilityHeight']
+        self._valid_wildcard_attributes =            ['data-', 'aria-']
+        self.available_properties = ['id', 'aria-*', 'className', 'containerId', 'containerSelector', 'data-*', 'duration', 'key', 'loading_state', 'nClicks', 'style', 'visibilityHeight']
+        self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
         _locals.update(kwargs)  # For wildcard attrs and excess named props

package/feffery_antd_components/AntdBadge.py

@@ -5,15 +5,21 @@ from dash.development.base_component import Component, _explicitize_args
 
 class AntdBadge(Component):
     """An AntdBadge component.
-
+徽标组件AntdBadge
 
 Keyword arguments:
 
-- children (a list of or a singular dash component, string or number; optional)
+- children (a list of or a singular dash component, string or number; optional):
+    组件型，定义徽标添加目标元素.
+
+- id (string; optional):
+    组件唯一id.
 
-- id (string; optional)
+- aria-* (string; optional):
+    `aria-*`格式属性通配.
 
-- className (string | dict; optional)
+- className (string | dict; optional):
+    当前组件css类名，支持[动态css](/advanced-classname).
 
 - classNames (dict; optional):
     细分控制子元素css类.
@@ -26,13 +32,20 @@ Keyword arguments:
     - root (string; optional):
         控制根元素css类.
 
-- color (string; optional)
+- color (string; optional):
+    徽标颜色.
+
+- count (number; optional):
+    徽标显示的数字.
 
-- count (number; optional)
+- data-* (string; optional):
+    `data-*`格式属性通配.
 
-- dot (boolean; default False)
+- dot (boolean; default False):
+    是否用圆点代替数字显示  默认值：`False`.
 
-- key (string; optional)
+- key (string; optional):
+    对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
 - loading_state (dict; optional)
 
@@ -47,19 +60,26 @@ Keyword arguments:
     - prop_name (string; optional):
         Holds which property is loading.
 
-- nClicks (number; default 0)
+- nClicks (number; default 0):
+    监听徽标累计被点击次数  默认值：`0`.
 
-- offset (list of numbers; optional)
+- offset (list of numbers; optional):
+    徽标在水平、竖直方向上的像素偏移，格式为`[水平偏移, 竖直偏移]`.
 
-- overflowCount (number; default 99)
+- overflowCount (number; default 99):
+    数字显示上限，超出会以显示`+`后缀  默认值：`99`.
 
-- showZero (boolean; default False)
+- showZero (boolean; default False):
+    当`count=0`时，是否强制显示数字  默认值：`False`.
 
-- size (a value equal to: 'default', 'small'; default 'default')
+- size (a value equal to: 'default', 'small'; default 'default'):
+    徽标尺寸规格，可选项有`'default'`、`'small'`.
 
-- status (a value equal to: 'success', 'processing', 'default', 'error', 'warning'; optional)
+- status (a value equal to: 'success', 'processing', 'default', 'error', 'warning'; optional):
+    徽标状态，可选项有`'success'`、`'processing'`、`'default'`、`'error'`、`'warning'`.
 
-- style (dict; optional)
+- style (dict; optional):
+    当前组件css样式.
 
 - styles (dict; optional):
     细分控制子元素css样式.
@@ -72,19 +92,21 @@ Keyword arguments:
     - root (dict; optional):
         控制根元素css样式.
 
-- text (string; optional)
+- text (string; optional):
+    参数`status`有效时，设置徽标文本内容.
 
-- title (string; optional)"""
+- title (string; optional):
+    徽标鼠标悬停显示文字内容."""
     _children_props = []
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdBadge'
     @_explicitize_args
-    def __init__(self, children=None, id=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, styles=Component.UNDEFINED, classNames=Component.UNDEFINED, key=Component.UNDEFINED, color=Component.UNDEFINED, count=Component.UNDEFINED, dot=Component.UNDEFINED, showZero=Component.UNDEFINED, overflowCount=Component.UNDEFINED, offset=Component.UNDEFINED, status=Component.UNDEFINED, text=Component.UNDEFINED, title=Component.UNDEFINED, size=Component.UNDEFINED, nClicks=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['children', 'id', 'className', 'classNames', 'color', 'count', 'dot', 'key', 'loading_state', 'nClicks', 'offset', 'overflowCount', 'showZero', 'size', 'status', 'style', 'styles', 'text', 'title']
-        self._valid_wildcard_attributes =            []
-        self.available_properties = ['children', 'id', 'className', 'classNames', 'color', 'count', 'dot', 'key', 'loading_state', 'nClicks', 'offset', 'overflowCount', 'showZero', 'size', 'status', 'style', 'styles', 'text', 'title']
-        self.available_wildcard_properties =            []
+    def __init__(self, children=None, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, styles=Component.UNDEFINED, classNames=Component.UNDEFINED, color=Component.UNDEFINED, count=Component.UNDEFINED, dot=Component.UNDEFINED, showZero=Component.UNDEFINED, overflowCount=Component.UNDEFINED, offset=Component.UNDEFINED, status=Component.UNDEFINED, text=Component.UNDEFINED, title=Component.UNDEFINED, size=Component.UNDEFINED, nClicks=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['children', 'id', 'aria-*', 'className', 'classNames', 'color', 'count', 'data-*', 'dot', 'key', 'loading_state', 'nClicks', 'offset', 'overflowCount', 'showZero', 'size', 'status', 'style', 'styles', 'text', 'title']
+        self._valid_wildcard_attributes =            ['data-', 'aria-']
+        self.available_properties = ['children', 'id', 'aria-*', 'className', 'classNames', 'color', 'count', 'data-*', 'dot', 'key', 'loading_state', 'nClicks', 'offset', 'overflowCount', 'showZero', 'size', 'status', 'style', 'styles', 'text', 'title']
+        self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
         _locals.update(kwargs)  # For wildcard attrs and excess named props

package/feffery_antd_components/AntdBreadcrumb.py

@@ -12,6 +12,9 @@ Keyword arguments:
 - id (string; optional):
     组件唯一id.
 
+- aria-* (string; optional):
+    `aria-*`格式属性通配.
+
 - className (string | dict; optional):
     当前组件css类名，支持[动态css](/advanced-classname).
 
@@ -29,6 +32,9 @@ Keyword arguments:
     - timestamp (number; optional):
         点击事件时间戳.
 
+- data-* (string; optional):
+    `data-*`格式属性通配.
+
 - items (list of dicts; optional):
     面包屑节点数据结构.
 
@@ -108,10 +114,10 @@ Keyword arguments:
     _type = 'AntdBreadcrumb'
     @_explicitize_args
     def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, items=Component.UNDEFINED, separator=Component.UNDEFINED, clickedItem=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'className', 'clickedItem', 'items', 'key', 'loading_state', 'separator', 'style']
-        self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'className', 'clickedItem', 'items', 'key', 'loading_state', 'separator', 'style']
-        self.available_wildcard_properties =            []
+        self._prop_names = ['id', 'aria-*', 'className', 'clickedItem', 'data-*', 'items', 'key', 'loading_state', 'separator', 'style']
+        self._valid_wildcard_attributes =            ['data-', 'aria-']
+        self.available_properties = ['id', 'aria-*', 'className', 'clickedItem', 'data-*', 'items', 'key', 'loading_state', 'separator', 'style']
+        self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
         _locals.update(kwargs)  # For wildcard attrs and excess named props

package/feffery_antd_components/AntdButton.py

@@ -15,6 +15,12 @@ Keyword arguments:
 - id (string; optional):
     组件唯一id.
 
+- aria-* (string; optional):
+    `aria-*`格式属性通配.
+
+- autoInsertSpace (boolean; default True):
+    按钮两个汉字内是否插入空格  默认值：`True`.
+
 - autoSpin (boolean; default False):
     当前按钮在每次点击后是否自动进入加载中状态  默认值：`False`.
 
@@ -38,15 +44,15 @@ Keyword arguments:
 - danger (boolean; default False):
     按钮是否呈现危险样式  默认值：`False`.
 
+- data-* (string; optional):
+    `data-*`格式属性通配.
+
 - debounceWait (number; default 0):
     按钮点击事件监听防抖延时，单位：毫秒  默认值：`0`.
 
 - disabled (boolean; default False):
     按钮是否呈现禁用状态  默认值：`False`.
 
-- extraProps (dict; optional):
-    为当前组件补充额外自定义键值对参数.
-
 - ghost (boolean; default False):
     按钮是否呈现透明背景状态  默认值：`False`.
 
@@ -56,6 +62,9 @@ Keyword arguments:
 - icon (a list of or a singular dash component, string or number; optional):
     组件型，按钮内嵌前缀图标元素.
 
+- iconPosition (a value equal to: 'start', 'end'; default 'start'):
+    按钮图标组件的位置，可选项有`'start'`、`'end'`  默认值：`'start'`.
+
 - key (string; optional):
     对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
@@ -104,19 +113,22 @@ Keyword arguments:
 - target (string; default '_blank'):
     按钮点击跳转链接方式  默认值：`'_blank'`.
 
-- type (a value equal to: 'default', 'primary', 'ghost', 'dashed', 'link', 'text'; default 'default'):
-    按钮类型，可选项有`'default'`、`'primary'`、`'ghost'`、`'dashed'`、`'link'`、`'text'`
+- title (string; optional):
+    原生按钮title属性.
+
+- type (a value equal to: 'default', 'primary', 'dashed', 'link', 'text'; default 'default'):
+    按钮类型，可选项有`'default'`、`'primary'`、`'dashed'`、`'link'`、`'text'`
     默认值：`'default'`."""
     _children_props = ['loadingChildren', 'icon']
     _base_nodes = ['loadingChildren', 'icon', 'children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdButton'
     @_explicitize_args
-    def __init__(self, children=None, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, styles=Component.UNDEFINED, classNames=Component.UNDEFINED, loadingChildren=Component.UNDEFINED, type=Component.UNDEFINED, href=Component.UNDEFINED, target=Component.UNDEFINED, block=Component.UNDEFINED, danger=Component.UNDEFINED, disabled=Component.UNDEFINED, ghost=Component.UNDEFINED, shape=Component.UNDEFINED, size=Component.UNDEFINED, nClicks=Component.UNDEFINED, clickExecuteJsString=Component.UNDEFINED, debounceWait=Component.UNDEFINED, icon=Component.UNDEFINED, loading=Component.UNDEFINED, autoSpin=Component.UNDEFINED, motionType=Component.UNDEFINED, extraProps=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['children', 'id', 'autoSpin', 'block', 'className', 'classNames', 'clickExecuteJsString', 'danger', 'debounceWait', 'disabled', 'extraProps', 'ghost', 'href', 'icon', 'key', 'loading', 'loadingChildren', 'loading_state', 'motionType', 'nClicks', 'shape', 'size', 'style', 'styles', 'target', 'type']
-        self._valid_wildcard_attributes =            []
-        self.available_properties = ['children', 'id', 'autoSpin', 'block', 'className', 'classNames', 'clickExecuteJsString', 'danger', 'debounceWait', 'disabled', 'extraProps', 'ghost', 'href', 'icon', 'key', 'loading', 'loadingChildren', 'loading_state', 'motionType', 'nClicks', 'shape', 'size', 'style', 'styles', 'target', 'type']
-        self.available_wildcard_properties =            []
+    def __init__(self, children=None, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, styles=Component.UNDEFINED, classNames=Component.UNDEFINED, loadingChildren=Component.UNDEFINED, type=Component.UNDEFINED, href=Component.UNDEFINED, target=Component.UNDEFINED, autoInsertSpace=Component.UNDEFINED, block=Component.UNDEFINED, danger=Component.UNDEFINED, disabled=Component.UNDEFINED, ghost=Component.UNDEFINED, shape=Component.UNDEFINED, size=Component.UNDEFINED, nClicks=Component.UNDEFINED, clickExecuteJsString=Component.UNDEFINED, debounceWait=Component.UNDEFINED, icon=Component.UNDEFINED, iconPosition=Component.UNDEFINED, loading=Component.UNDEFINED, autoSpin=Component.UNDEFINED, motionType=Component.UNDEFINED, title=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['children', 'id', 'aria-*', 'autoInsertSpace', 'autoSpin', 'block', 'className', 'classNames', 'clickExecuteJsString', 'danger', 'data-*', 'debounceWait', 'disabled', 'ghost', 'href', 'icon', 'iconPosition', 'key', 'loading', 'loadingChildren', 'loading_state', 'motionType', 'nClicks', 'shape', 'size', 'style', 'styles', 'target', 'title', 'type']
+        self._valid_wildcard_attributes =            ['data-', 'aria-']
+        self.available_properties = ['children', 'id', 'aria-*', 'autoInsertSpace', 'autoSpin', 'block', 'className', 'classNames', 'clickExecuteJsString', 'danger', 'data-*', 'debounceWait', 'disabled', 'ghost', 'href', 'icon', 'iconPosition', 'key', 'loading', 'loadingChildren', 'loading_state', 'motionType', 'nClicks', 'shape', 'size', 'style', 'styles', 'target', 'title', 'type']
+        self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
         _locals.update(kwargs)  # For wildcard attrs and excess named props

package/feffery_antd_components/AntdCalendar.py

@@ -5,19 +5,59 @@ from dash.development.base_component import Component, _explicitize_args
 
 class AntdCalendar(Component):
     """An AntdCalendar component.
-
+日历组件AntdCalendar
 
 Keyword arguments:
 
-- id (string; optional)
+- id (string; optional):
+    组件唯一id.
+
+- aria-* (string; optional):
+    `aria-*`格式属性通配.
+
+- cellClickEvent (dict; optional):
+    监听日期单元格点击事件.
+
+    `cellClickEvent` is a dict with keys:
+
+    - timestamp (number; optional):
+        事件发生时间戳.
+
+    - type (string; optional):
+        记录面板类型.
+
+- className (string | dict; optional):
+    当前组件css类名，支持[动态css](/advanced-classname).
+
+- customCells (list of dicts; optional):
+    自定义对应月份、日期的单元格显示内容.
+
+    `customCells` is a list of dicts with keys:
+
+    - content (a list of or a singular dash component, string or number; optional):
+        自定义内容.
+
+    - date (number; optional):
+        当前项匹配的日期值.
+
+    - month (number; optional):
+        当前项匹配的月份值.
+
+    - type (a value equal to: 'month', 'date'; required):
+        必填，当前项对应类型，可选项有`'month'`、`'date'`.
 
-- className (string | dict; optional)
+- data-* (string; optional):
+    `data-*`格式属性通配.
 
-- defaultValue (string; optional)
+- defaultValue (string; optional):
+    初始化选中日期值.
 
-- format (string; default 'YYYY-MM-DD')
+- format (string; default 'YYYY-MM-DD'):
+    日期显示格式，[参考资料](https://day.js.org/docs/en/display/format)
+    默认值：`'YYYY-MM-DD'`.
 
-- key (string; optional)
+- key (string; optional):
+    对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
 
 - loading_state (dict; optional)
 
@@ -32,45 +72,40 @@ Keyword arguments:
     - prop_name (string; optional):
         Holds which property is loading.
 
-- locale (a value equal to: 'zh-cn', 'en-us'; default 'zh-cn')
+- locale (a value equal to: 'zh-cn', 'en-us'; default 'zh-cn'):
+    组件文案语种，可选项有`'zh-cn'`、`'en-us'`  默认值：`'zh-cn'`.
 
 - name (string; optional):
-    用于在基于AntdForm的表单值自动搜集功能中，充当当前表单项的字段名  缺省时会以id作为字段名.
+    配合`AntdForm`表单批量值搜集/控制功能使用，充当当前表单项的字段名，以`id`作为缺省值.
 
 - persisted_props (list of a value equal to: 'value's; default ['value']):
-    Properties whose user interactions will persist after refreshing
-    the  component or the page. Since only `value` is allowed this
-    prop can  normally be ignored.
+    开启属性持久化功能的若干属性名，可选项有`'value'`  默认值：`['value']`.
 
 - persistence (boolean | string | number; optional):
-    Used to allow user interactions in this component to be persisted
-    when  the component - or the page - is refreshed. If `persisted`
-    is truthy and  hasn't changed from its previous value, a `value`
-    that the user has  changed while using the app will keep that
-    change, as long as  the new `value` also matches what was given
-    originally.  Used in conjunction with `persistence_type`.
+    是否开启[属性持久化](/prop-persistence).
 
 - persistence_type (a value equal to: 'local', 'session', 'memory'; default 'local'):
-    Where persisted user changes will be stored:  memory: only kept in
-    memory, reset on page refresh.  local: window.localStorage, data
-    is kept after the browser quit.  session: window.sessionStorage,
-    data is cleared once the browser quit.
+    属性持久化存储类型，可选项有`'local'`（本地持久化），`'session'`（会话持久化），`'memory'`（内存持久化）
+    默认值：`'local'`.
 
-- size (a value equal to: 'default', 'large'; default 'default')
+- size (a value equal to: 'default', 'large'; default 'default'):
+    日历尺寸规格，可选项有`'default'`、`'large'`  默认值：`'default'`.
 
-- style (dict; optional)
+- style (dict; optional):
+    当前组件css样式.
 
-- value (string; optional)"""
-    _children_props = []
+- value (string; optional):
+    监听或设置当前选中日期值."""
+    _children_props = ['customCells[].content']
     _base_nodes = ['children']
     _namespace = 'feffery_antd_components'
     _type = 'AntdCalendar'
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, key=Component.UNDEFINED, name=Component.UNDEFINED, locale=Component.UNDEFINED, format=Component.UNDEFINED, size=Component.UNDEFINED, value=Component.UNDEFINED, defaultValue=Component.UNDEFINED, loading_state=Component.UNDEFINED, persistence=Component.UNDEFINED, persisted_props=Component.UNDEFINED, persistence_type=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'className', 'defaultValue', 'format', 'key', 'loading_state', 'locale', 'name', 'persisted_props', 'persistence', 'persistence_type', 'size', 'style', 'value']
-        self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'className', 'defaultValue', 'format', 'key', 'loading_state', 'locale', 'name', 'persisted_props', 'persistence', 'persistence_type', 'size', 'style', 'value']
-        self.available_wildcard_properties =            []
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, name=Component.UNDEFINED, locale=Component.UNDEFINED, format=Component.UNDEFINED, size=Component.UNDEFINED, value=Component.UNDEFINED, defaultValue=Component.UNDEFINED, customCells=Component.UNDEFINED, cellClickEvent=Component.UNDEFINED, loading_state=Component.UNDEFINED, persistence=Component.UNDEFINED, persisted_props=Component.UNDEFINED, persistence_type=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'aria-*', 'cellClickEvent', 'className', 'customCells', 'data-*', 'defaultValue', 'format', 'key', 'loading_state', 'locale', 'name', 'persisted_props', 'persistence', 'persistence_type', 'size', 'style', 'value']
+        self._valid_wildcard_attributes =            ['data-', 'aria-']
+        self.available_properties = ['id', 'aria-*', 'cellClickEvent', 'className', 'customCells', 'data-*', 'defaultValue', 'format', 'key', 'loading_state', 'locale', 'name', 'persisted_props', 'persistence', 'persistence_type', 'size', 'style', 'value']
+        self.available_wildcard_properties =            ['data-', 'aria-']
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()
         _locals.update(kwargs)  # For wildcard attrs and excess named props