feffery_antd_components 0.3.15 → 0.4.0-rc5

package/tests/navigation/AntdBreadcrumb/feat_menu_item_event.py

@@ -0,0 +1,64 @@
+if True:
+    import sys
+
+    sys.path.append('../../../')
+    import json
+    from dash import Dash, html
+    import feffery_antd_components as fac
+    from dash.dependencies import Input, Output
+    from feffery_dash_utils.style_utils import style
+
+app = Dash(__name__)
+
+app.layout = html.Div(
+    [
+        fac.AntdSpace(
+            [
+                fac.AntdBreadcrumb(
+                    id='breadcrumnb-demo',
+                    items=[
+                        {'title': '首页', 'key': '首页'},
+                        {
+                            'title': '下属页面1',
+                            'key': '下属页面1',
+                            'menuItems': [
+                                {
+                                    'key': f'子节点{i}',
+                                    'title': f'子节点{i}',
+                                    'icon': 'antd-smile',
+                                }
+                                for i in range(1, 4)
+                            ],
+                        },
+                        {
+                            'title': '下属页面1-1',
+                            'key': '下属页面1-1',
+                        },
+                    ],
+                ),
+                html.Pre(id='breadcrumnb-demo-output'),
+            ],
+            size=50,
+            direction='vertical',
+            style=style(width='100%'),
+        )
+    ],
+    style=style(padding=50),
+)
+
+
+@app.callback(
+    Output('breadcrumnb-demo-output', 'children'),
+    Input('breadcrumnb-demo', 'clickedItem'),
+    prevent_initial_call=True,
+)
+def breadcrumb_callback_demo(clickedItem):
+    return json.dumps(
+        dict(clickedItem=clickedItem),
+        indent=4,
+        ensure_ascii=False,
+    )
+
+
+if __name__ == '__main__':
+    app.run(debug=True)

package/tests/navigation/AntdBreadcrumb/refactor_items.py

@@ -0,0 +1,140 @@
+if True:
+    import sys
+
+    sys.path.append('../../../')
+    import json
+    from dash import Dash, html
+    import feffery_antd_components as fac
+    from dash.dependencies import Input, Output
+    from feffery_dash_utils.style_utils import style
+
+app = Dash(__name__)
+
+app.layout = html.Div(
+    [
+        fac.AntdSpace(
+            [
+                fac.AntdBreadcrumb(
+                    items=[
+                        {'title': '首页'},
+                        {'title': '下属页面1'},
+                        {'title': '下属页面1-1'},
+                    ]
+                ),
+                fac.AntdBreadcrumb(
+                    items=[
+                        {
+                            'title': 'awesome-feffery-dash仓库主页',
+                            'href': 'https://github.com/CNFeffery/awesome-feffery-dash',
+                            'target': '_blank',
+                        },
+                        {
+                            'title': 'feffery-antd-components文档首页',
+                            'href': '/',
+                            'target': '_blank',
+                        },
+                        {
+                            'title': 'AntdBreadcrumb文档页',
+                            'href': '/AntdBreadcrumb',
+                            'target': '_blank',
+                        },
+                    ]
+                ),
+                fac.AntdBreadcrumb(
+                    items=[
+                        {
+                            'title': 'awesome-feffery-dash仓库主页',
+                            'href': 'https://github.com/CNFeffery/awesome-feffery-dash',
+                            'target': '_blank',
+                            'icon': 'antd-github',
+                        },
+                        {
+                            'title': 'feffery-antd-components文档首页',
+                            'href': '/',
+                            'target': '_blank',
+                            'icon': 'antd-home',
+                        },
+                        {
+                            'title': 'AntdBreadcrumb文档页',
+                            'href': '/AntdBreadcrumb',
+                            'target': '_blank',
+                            'icon': 'fc-approval',
+                        },
+                    ]
+                ),
+                fac.AntdBreadcrumb(
+                    items=[
+                        {
+                            'title': 'awesome-feffery-dash仓库主页',
+                            'href': 'https://github.com/CNFeffery/awesome-feffery-dash',
+                            'target': '_blank',
+                            'menuItems': [
+                                {
+                                    'title': 'feffery-utils-components',
+                                    'href': 'https://github.com/CNFeffery/feffery-utils-components',
+                                    'target': '_blank',
+                                },
+                                {
+                                    'title': 'feffery-antd-charts',
+                                    'href': 'https://github.com/CNFeffery/feffery-antd-charts',
+                                    'target': '_blank',
+                                },
+                                {
+                                    'title': 'feffery-markdown-components',
+                                    'href': 'https://github.com/CNFeffery/feffery-markdown-components',
+                                    'target': '_blank',
+                                },
+                            ],
+                        },
+                        {
+                            'title': 'feffery-antd-components文档首页',
+                            'href': '/',
+                            'target': '_blank',
+                        },
+                        {
+                            'title': 'AntdBreadcrumb文档页',
+                            'href': '/AntdBreadcrumb',
+                            'target': '_blank',
+                        },
+                    ]
+                ),
+                fac.AntdBreadcrumb(
+                    id='breadcrumnb-demo',
+                    items=[
+                        {'title': '首页', 'key': '首页'},
+                        {
+                            'title': '下属页面1',
+                            'key': '下属页面1',
+                        },
+                        {
+                            'title': '下属页面1-1',
+                            'key': '下属页面1-1',
+                        },
+                    ],
+                ),
+                html.Pre(id='breadcrumnb-demo-output'),
+            ],
+            size=50,
+            direction='vertical',
+            style=style(width='100%'),
+        )
+    ],
+    style=style(padding=50),
+)
+
+
+@app.callback(
+    Output('breadcrumnb-demo-output', 'children'),
+    Input('breadcrumnb-demo', 'clickedItem'),
+    prevent_initial_call=True,
+)
+def breadcrumb_callback_demo(clickedItem):
+    return json.dumps(
+        dict(clickedItem=clickedItem),
+        indent=4,
+        ensure_ascii=False,
+    )
+
+
+if __name__ == '__main__':
+    app.run(debug=True)

package/tests/other/AntdAffix/feat_listen_affixed.py

@@ -0,0 +1,41 @@
+if True:
+    import sys
+
+    sys.path.append('../../../')
+    import dash
+    from dash import html
+    import feffery_antd_components as fac
+    from dash.dependencies import Input, Output
+    from feffery_dash_utils.style_utils import style
+
+app = dash.Dash(__name__)
+
+app.layout = html.Div(
+    [
+        html.Div(
+            fac.AntdAffix(
+                fac.AntdButton(
+                    'affixed: False',
+                    id='output',
+                    type='primary',
+                ),
+                id='affix-demo',
+                offsetTop=24,
+            ),
+            style={'marginBottom': '1000px'},
+        )
+    ],
+    style=style(padding=100, height='1000vh'),
+)
+
+
+@app.callback(
+    Output('output', 'children'),
+    Input('affix-demo', 'affixed'),
+)
+def listen_affixed(affixed):
+    return 'affixed: True' if affixed else 'affixed: False'
+
+
+if __name__ == '__main__':
+    app.run(debug=True)

package/tests/other/AntdBackTop/refactor.py

@@ -0,0 +1,18 @@
+if True:
+    import sys
+
+    sys.path.append('../../../')
+    import dash
+    from dash import html
+    import feffery_antd_components as fac
+    from feffery_dash_utils.style_utils import style
+
+app = dash.Dash(__name__)
+
+app.layout = html.Div(
+    [fac.AntdBackTop()],
+    style=style(height=9999),
+)
+
+if __name__ == '__main__':
+    app.run(debug=True)

package/usage.py

@@ -3,25 +3,31 @@ from dash import html
 import feffery_antd_components as fac
 from feffery_dash_utils.style_utils import style
 
-app = dash.Dash(__name__)
+app = dash.Dash(
+    __name__,
+    # 静态资源全量加载测试
+    eager_loading=True,
+)
 
-app.layout = html.Div(
-    fac.AntdSpace(
-        [
-            fac.AntdButton(
-                '按钮示例', type='primary', size=size
-            )
-            for size in ['large', 'middle', 'small']
-        ],
-        align='center',
-        style=style(
-            position='fixed',
-            left='50%',
-            top='50%',
-            transform='translate(-50%, -50%)',
+app.layout = fac.AntdConfigProvider(
+    html.Div(
+        fac.AntdSpace(
+            [
+                fac.AntdButton(
+                    '按钮示例', type='primary', size=size
+                )
+                for size in ['large', 'middle', 'small']
+            ],
+            align='center',
+            style=style(
+                position='fixed',
+                left='50%',
+                top='50%',
+                transform='translate(-50%, -50%)',
+            ),
         ),
-    ),
-    style=style(padding=50),
+        style=style(padding=50),
+    )
 )
 
 if __name__ == '__main__':

package/feffery_antd_components/AntdDraggablePanel.py

@@ -1,125 +0,0 @@
-# AUTO GENERATED FILE - DO NOT EDIT
-
-from dash.development.base_component import Component, _explicitize_args
-
-
-class AntdDraggablePanel(Component):
-    """An AntdDraggablePanel component.
-可拖拽面板组件AntdDraggablePanel
-
-Keyword arguments:
-
-- id (string; optional):
-    组件唯一id.
-
-- key (string; optional):
-    对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
-
-- 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).
-
-- mode (a value equal to: 'fixed', 'float'; default 'fixed'):
-    设置面板模式，可选项有`'fixed'`（固定模式）、`'float'`（浮动窗口模式）  默认值：`'fixed'`.
-
-- defaultSize (dict; optional):
-    设置当前面板默认尺寸.
-
-    `defaultSize` is a dict with keys:
-
-    - width (number | string; optional):
-        设置像素宽度数值，或css宽度字符串.
-
-    - height (number | string; optional):
-        设置像素高度数值，或css高度字符串.
-
-- defaultPosition (dict; optional):
-    设置当前面板默认位置.
-
-    `defaultPosition` is a dict with keys:
-
-    - x (number; optional):
-        设置距离文档左端像素距离.
-
-    - y (number; optional):
-        设置距离文档顶端像素距离.
-
-- placement (a value equal to: 'right', 'left', 'top', 'bottom'; default 'right'):
-    固定模式下，用于设置面板朝向，可选项有`'right'`、`'left'`、`'top'`、`'bottom'`
-    默认值：`'right'`.
-
-- minWidth (number; optional):
-    面板最小像素宽度.
-
-- minHeight (number; optional):
-    面板最小像素高度.
-
-- maxWidth (number; optional):
-    面板最大像素宽度.
-
-- maxHeight (number; optional):
-    面板最大像素高度.
-
-- resize (dict; optional):
-    配置尺寸可调整性，可独立控制各个方向，也可直接控制所有方向是否可调整尺寸.
-
-    `resize` is a boolean | dict with keys:
-
-    - bottom (boolean; optional)
-
-    - bottomLeft (boolean; optional)
-
-    - bottomRight (boolean; optional)
-
-    - left (boolean; optional)
-
-    - right (boolean; optional)
-
-    - top (boolean; optional)
-
-    - topLeft (boolean; optional)
-
-    - topRight (boolean; optional)
-
-- expandable (boolean; default True):
-    面板是否可展开  默认值：`True`.
-
-- 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."""
-    _children_props = []
-    _base_nodes = ['children']
-    _namespace = 'feffery_antd_components'
-    _type = 'AntdDraggablePanel'
-    @_explicitize_args
-    def __init__(self, children=None, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, mode=Component.UNDEFINED, defaultSize=Component.UNDEFINED, defaultPosition=Component.UNDEFINED, placement=Component.UNDEFINED, minWidth=Component.UNDEFINED, minHeight=Component.UNDEFINED, maxWidth=Component.UNDEFINED, maxHeight=Component.UNDEFINED, resize=Component.UNDEFINED, expandable=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'key', 'children', 'style', 'className', 'mode', 'defaultSize', 'defaultPosition', 'placement', 'minWidth', 'minHeight', 'maxWidth', 'maxHeight', 'resize', 'expandable', 'data-*', 'aria-*', 'loading_state']
-        self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'children', 'style', 'className', 'mode', 'defaultSize', 'defaultPosition', 'placement', 'minWidth', 'minHeight', 'maxWidth', 'maxHeight', 'resize', 'expandable', 'data-*', 'aria-*', 'loading_state']
-        self.available_wildcard_properties =            ['data-', 'aria-']
-        _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(AntdDraggablePanel, self).__init__(children=children, **args)

package/feffery_antd_components/AntdEditorLayout.py

@@ -1,237 +0,0 @@
-# AUTO GENERATED FILE - DO NOT EDIT
-
-from dash.development.base_component import Component, _explicitize_args
-
-
-class AntdEditorLayout(Component):
-    """An AntdEditorLayout component.
-编辑器布局组件AntdEditorLayout
-
-Keyword arguments:
-
-- id (string; optional):
-    组件唯一id.
-
-- key (string; optional):
-    对当前组件的`key`值进行更新，可实现强制重绘当前组件的效果.
-
-- style (dict; optional):
-    当前组件css样式.
-
-- className (string | dict; optional):
-    当前组件css类名，支持[动态css](/advanced-classname).
-
-- header (dict; optional):
-    配置页首布局内容，设置为`False`时不显示.
-
-    `header` is a dict with keys:
-
-    - title (a list of or a singular dash component, string or number; optional):
-        页首标题元素.
-
-    - extra (a list of or a singular dash component, string or number; optional):
-        页首额外操作区元素.
-
-    - style (dict; optional):
-        页首css样式.
-
-    - className (string; optional):
-        页首css类名.
-
-    - children (a list of or a singular dash component, string or number; optional):
-        页首主要区域子元素.
-
-    - themeType (a value equal to: 'ghost', 'block', 'pure'; optional):
-        页首主题类型，可选的有`'ghost'`、`'block'`、`'pure'`. | boolean
-
-- footer (dict; optional):
-    配置页脚布局内容，设置为`False`时不显示.
-
-    `footer` is a dict with keys:
-
-    - title (a list of or a singular dash component, string or number; optional):
-        页脚标题元素.
-
-    - extra (a list of or a singular dash component, string or number; optional):
-        页脚额外操作区元素.
-
-    - style (dict; optional):
-        页脚css样式.
-
-    - className (string; optional):
-        页脚css类名.
-
-    - children (a list of or a singular dash component, string or number; optional):
-        页脚主要区域子元素.
-
-    - themeType (a value equal to: 'ghost', 'block', 'pure'; optional):
-        页脚主题类型，可选的有`'ghost'`、`'block'`、`'pure'`. | boolean
-
-- leftPannel (dict; optional):
-    配置左侧面板布局内容，设置为`False`时不显示.
-
-    `leftPannel` is a dict with keys:
-
-    - children (a list of or a singular dash component, string or number; optional):
-        面板子元素内容.
-
-    - direction (a value equal to: 'horizontal', 'vertical'; optional):
-        面板方向，可选的有`'horizontal'`、`'vertical'`.
-
-    - minWidth (number; optional):
-        面板最小像素宽度.
-
-    - minHeight (number; optional):
-        面板最小像素高度.
-
-    - maxWidth (number; optional):
-        面板最大像素宽度.
-
-    - maxHeight (number; optional):
-        面板最大像素高度.
-
-    - style (dict; optional):
-        面板css样式.
-
-    - className (string; optional):
-        面板css类名.
-
-    - themeType (a value equal to: 'ghost', 'block', 'pure'; optional):
-        面板主题类型，可选的有`'ghost'`、`'block'`、`'pure'`. | boolean
-
-- rightPannel (dict; optional):
-    配置右侧面板布局内容，设置为`False`时不显示.
-
-    `rightPannel` is a dict with keys:
-
-    - children (a list of or a singular dash component, string or number; optional):
-        面板子元素内容.
-
-    - direction (a value equal to: 'horizontal', 'vertical'; optional):
-        面板方向，可选的有`'horizontal'`、`'vertical'`.
-
-    - minWidth (number; optional):
-        面板最小像素宽度.
-
-    - minHeight (number; optional):
-        面板最小像素高度.
-
-    - maxWidth (number; optional):
-        面板最大像素宽度.
-
-    - maxHeight (number; optional):
-        面板最大像素高度.
-
-    - style (dict; optional):
-        面板css样式.
-
-    - className (string; optional):
-        面板css类名.
-
-    - themeType (a value equal to: 'ghost', 'block', 'pure'; optional):
-        面板主题类型，可选的有`'ghost'`、`'block'`、`'pure'`. | boolean
-
-- bottomPannel (dict; optional):
-    配置底部面板布局内容，设置为`False`时不显示.
-
-    `bottomPannel` is a dict with keys:
-
-    - children (a list of or a singular dash component, string or number; optional):
-        面板子元素内容.
-
-    - direction (a value equal to: 'horizontal', 'vertical'; optional):
-        面板方向，可选的有`'horizontal'`、`'vertical'`.
-
-    - minWidth (number; optional):
-        面板最小像素宽度.
-
-    - minHeight (number; optional):
-        面板最小像素高度.
-
-    - maxWidth (number; optional):
-        面板最大像素宽度.
-
-    - maxHeight (number; optional):
-        面板最大像素高度.
-
-    - style (dict; optional):
-        面板css样式.
-
-    - className (string; optional):
-        面板css类名.
-
-    - themeType (a value equal to: 'ghost', 'block', 'pure'; optional):
-        面板主题类型，可选的有`'ghost'`、`'block'`、`'pure'`. | boolean
-
-- centerPannel (dict; optional):
-    配置中心面板布局内容，设置为`False`时不显示.
-
-    `centerPannel` is a dict with keys:
-
-    - children (a list of or a singular dash component, string or number; optional):
-        面板子元素内容.
-
-    - direction (a value equal to: 'horizontal', 'vertical'; optional):
-        面板方向，可选的有`'horizontal'`、`'vertical'`.
-
-    - minWidth (number; optional):
-        面板最小像素宽度.
-
-    - minHeight (number; optional):
-        面板最小像素高度.
-
-    - maxWidth (number; optional):
-        面板最大像素宽度.
-
-    - maxHeight (number; optional):
-        面板最大像素高度.
-
-    - style (dict; optional):
-        面板css样式.
-
-    - className (string; optional):
-        面板css类名.
-
-    - themeType (a value equal to: 'ghost', 'block', 'pure'; optional):
-        面板主题类型，可选的有`'ghost'`、`'block'`、`'pure'`. | boolean
-
-- type (a value equal to: 'Left&Right', 'LeftFull', 'RightFull', 'Bottom'; optional):
-    布局类型，可选的有`'Left&Right'`、`'LeftFull'`、`'RightFull'`、`'Bottom'`.
-
-- themeType (a value equal to: 'ghost', 'block', 'pure'; optional):
-    整体主题类型，可选的有`'ghost'`、`'block'`、`'pure'`.
-
-- 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."""
-    _children_props = ['header.title', 'header.extra', 'header.children', 'footer.title', 'footer.extra', 'footer.children', 'leftPannel.children', 'rightPannel.children', 'bottomPannel.children', 'centerPannel.children']
-    _base_nodes = ['children']
-    _namespace = 'feffery_antd_components'
-    _type = 'AntdEditorLayout'
-    @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, style=Component.UNDEFINED, className=Component.UNDEFINED, header=Component.UNDEFINED, footer=Component.UNDEFINED, leftPannel=Component.UNDEFINED, rightPannel=Component.UNDEFINED, bottomPannel=Component.UNDEFINED, centerPannel=Component.UNDEFINED, type=Component.UNDEFINED, themeType=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'key', 'style', 'className', 'header', 'footer', 'leftPannel', 'rightPannel', 'bottomPannel', 'centerPannel', 'type', 'themeType', 'data-*', 'aria-*', 'loading_state']
-        self._valid_wildcard_attributes =            ['data-', 'aria-']
-        self.available_properties = ['id', 'key', 'style', 'className', 'header', 'footer', 'leftPannel', 'rightPannel', 'bottomPannel', 'centerPannel', 'type', 'themeType', 'data-*', 'aria-*', 'loading_state']
-        self.available_wildcard_properties =            ['data-', 'aria-']
-        _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(AntdEditorLayout, self).__init__(**args)