feffery_utils_components 0.2.0-rc15 → 0.2.0-rc17

package/DESCRIPTION

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

package/NAMESPACE

@@ -32,6 +32,7 @@ export(''FefferyMarkdownEditor)
 export(''FefferyRichTextEditor)
 export(''FefferyVditor)
 export(''FefferyAnimatedImage)
+export(''FefferyBurger)
 export(''FefferyCaptcha)
 export(''FefferyCompareSlider)
 export(''FefferyCountDown)

package/Project.toml

@@ -2,7 +2,7 @@
 name = "FefferyUtilsComponents"
 uuid = "1b08a953-4be3-4667-9a23-ea89cd6d0d23"
 authors = ["CNFeffery <fefferypzy@gmail.com>"]
-version = "0.2.0-rc15"
+version = "0.2.0-rc17"
 
 [deps]
 Dash = "1b08a953-4be3-4667-9a23-3db579824955"

package/README.md

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

package/feffery_utils_components/FefferyBurger.py

@@ -0,0 +1,77 @@
+# AUTO GENERATED FILE - DO NOT EDIT
+
+from dash.development.base_component import Component, _explicitize_args
+
+
+class FefferyBurger(Component):
+    """A FefferyBurger component.
+动态菜单图标组件FefferyBurger
+
+Keyword arguments:
+
+- id (string; optional):
+    组件唯一id.
+
+- className (string; optional):
+    当前组件css类名.
+
+- color (string; optional):
+    图标颜色.
+
+- direction (a value equal to: 'left', 'right'; default 'left'):
+    部分类型图标可用，控制动画方向，可选项有`'left'`、`'right'`  默认值：`'left'`.
+
+- distance (a value equal to: 'sm', 'md', 'lg'; default 'md'):
+    图标水平线之间的间距大小规格，可选项有`'sm'`、`'md'`、`'lg'`  默认值：`'md'`.
+
+- duration (number; default 0.3):
+    动画过程时长，单位：秒，设置为`0`时将关闭动画  默认值：`0.3`.
+
+- 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.
+
+- rounded (boolean; default False):
+    是否渲染为圆角矩形  默认值：`False`.
+
+- size (number; default 32):
+    图标像素尺寸  默认值：`32`.
+
+- style (dict; optional):
+    当前组件css样式.
+
+- toggled (boolean; optional):
+    设置或监听切换状态.
+
+- type (a value equal to: 'default', 'squash', 'cross', 'twirl', 'fade', 'slant', 'spiral', 'divide', 'turn', 'pivot', 'sling', 'squeeze', 'spin', 'rotate'; default 'default'):
+    图标类型，可选项有`'default'`、`'squash'`、`'cross'`、`'twirl'`、`'fade'`、`'slant'`、`'spiral'`
+    、`'divide'`、`'turn'`、`'pivot'`、`'sling'`、`'squeeze'`、`'spin'`、`'rotate'`
+    默认值：`'default'`."""
+    _children_props = []
+    _base_nodes = ['children']
+    _namespace = 'feffery_utils_components'
+    _type = 'FefferyBurger'
+    @_explicitize_args
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, type=Component.UNDEFINED, toggled=Component.UNDEFINED, size=Component.UNDEFINED, direction=Component.UNDEFINED, duration=Component.UNDEFINED, distance=Component.UNDEFINED, color=Component.UNDEFINED, rounded=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'className', 'color', 'direction', 'distance', 'duration', 'key', 'loading_state', 'rounded', 'size', 'style', 'toggled', 'type']
+        self._valid_wildcard_attributes =            []
+        self.available_properties = ['id', 'className', 'color', 'direction', 'distance', 'duration', 'key', 'loading_state', 'rounded', 'size', 'style', 'toggled', 'type']
+        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}
+
+        super(FefferyBurger, self).__init__(**args)

package/feffery_utils_components/FefferyHttpRequests.py

@@ -39,8 +39,9 @@ Keyword arguments:
     - headers (dict; optional):
         自定义请求头.
 
-    - method (a value equal to: 'get', 'post'; optional):
-        请求类型，可选项有`'get'`、`'post'`  默认值：`'get'`.
+    - method (a value equal to: 'get', 'post', 'put', 'patch', 'delete'; optional):
+        请求类型，可选项有`'get'`、`'post'`、`'put'`、`'patch'`、`'delete'`
+        默认值：`'get'`.
 
     - params (dict; optional):
         自定义请求参数.

package/feffery_utils_components/FefferyMarkdownEditor.py

@@ -44,6 +44,9 @@ Keyword arguments:
     - syntaxType (a value equal to: 'inline', 'block'; optional):
         自定义语法类型，'inline'表示行内语法，'block'表示段落语法.
 
+- debounceWait (number; default 200):
+    用于配置value变化更新的防抖等待时长（单位：毫秒），默认为200.
+
 - drawioIframeUrl (string; default ''):
     打开draw.io编辑页的url，如果为空则drawio按钮失效.
 
@@ -411,7 +414,7 @@ Keyword arguments:
 
     - label (a value equal to: '默认', '暗黑', '明亮', '清新', '热情', '淡雅', '清幽'; optional)
 
-- toolbars (dict; default {
    theme: 'dark',
    showToolbar: True,
    toolbar: [
        'bold',
        'italic',
        'strikethrough',
        '|',
        'color',
        'header',
        'ruby',
        '|',
        'list',
        'panel',
        'detail',
        {
            insert: ['image', 'audio', 'video', 'link', 'hr', 'br', 'code', 'formula', 'toc', 'table', 'line-table', 'bar-table', 'pdf', 'word']
        },
        'settings',
    ],
    toolbarRight: [],
    sidebar: [],
    bubble: ['bold', 'italic', 'underline', 'strikethrough', 'sub', 'sup', 'quote', '|', 'size', 'color'],
    float: ['h1', 'h2', 'h3', '|', 'checklist', 'quote', 'table', 'code'],
    shortcutKey: {},
    config: {
        formula: {
            showLatexLive: True,
            templateConfig: False,
        },
    },
+- toolbars (dict; default {
    theme: 'dark',
    showToolbar: True,
    toolbar: [
        'bold',
        'italic',
        'strikethrough',
        '|',
        'color',
        'header',
        'ruby',
        '|',
        'list',
        'panel',
        'detail',
        {
            insert: ['image', 'audio', 'video', 'link', 'hr', 'br', 'code', 'formula', 'toc', 'table', 'pdf', 'word']
        },
        'settings',
    ],
    toolbarRight: [],
    sidebar: [],
    bubble: ['bold', 'italic', 'underline', 'strikethrough', 'sub', 'sup', 'quote', '|', 'size', 'color'],
    float: ['h1', 'h2', 'h3', '|', 'checklist', 'quote', 'table', 'code'],
    shortcutKey: {},
    config: {
        formula: {
            showLatexLive: True,
            templateConfig: False,
        },
    },
     工具栏配置.
 
     `toolbars` is a dict with keys:
@@ -498,10 +501,10 @@ Keyword arguments:
     _namespace = 'feffery_utils_components'
     _type = 'FefferyMarkdownEditor'
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, key=Component.UNDEFINED, value=Component.UNDEFINED, html=Component.UNDEFINED, engine=Component.UNDEFINED, editor=Component.UNDEFINED, toolbars=Component.UNDEFINED, drawioIframeUrl=Component.UNDEFINED, fileTypeLimitMap=Component.UNDEFINED, uploadConfig=Component.UNDEFINED, fineControl=Component.UNDEFINED, previewer=Component.UNDEFINED, theme=Component.UNDEFINED, isPreviewOnly=Component.UNDEFINED, autoScrollByCursor=Component.UNDEFINED, forceAppend=Component.UNDEFINED, locale=Component.UNDEFINED, autoScrollByHashAfterInit=Component.UNDEFINED, customSyntax=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'autoScrollByCursor', 'autoScrollByHashAfterInit', 'className', 'customSyntax', 'drawioIframeUrl', 'editor', 'engine', 'fileTypeLimitMap', 'fineControl', 'forceAppend', 'html', 'isPreviewOnly', 'key', 'loading_state', 'locale', 'previewer', 'style', 'theme', 'toolbars', 'uploadConfig', 'value']
+    def __init__(self, id=Component.UNDEFINED, className=Component.UNDEFINED, style=Component.UNDEFINED, key=Component.UNDEFINED, debounceWait=Component.UNDEFINED, value=Component.UNDEFINED, html=Component.UNDEFINED, engine=Component.UNDEFINED, editor=Component.UNDEFINED, toolbars=Component.UNDEFINED, drawioIframeUrl=Component.UNDEFINED, fileTypeLimitMap=Component.UNDEFINED, uploadConfig=Component.UNDEFINED, fineControl=Component.UNDEFINED, previewer=Component.UNDEFINED, theme=Component.UNDEFINED, isPreviewOnly=Component.UNDEFINED, autoScrollByCursor=Component.UNDEFINED, forceAppend=Component.UNDEFINED, locale=Component.UNDEFINED, autoScrollByHashAfterInit=Component.UNDEFINED, customSyntax=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'autoScrollByCursor', 'autoScrollByHashAfterInit', 'className', 'customSyntax', 'debounceWait', 'drawioIframeUrl', 'editor', 'engine', 'fileTypeLimitMap', 'fineControl', 'forceAppend', 'html', 'isPreviewOnly', 'key', 'loading_state', 'locale', 'previewer', 'style', 'theme', 'toolbars', 'uploadConfig', 'value']
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'autoScrollByCursor', 'autoScrollByHashAfterInit', 'className', 'customSyntax', 'drawioIframeUrl', 'editor', 'engine', 'fileTypeLimitMap', 'fineControl', 'forceAppend', 'html', 'isPreviewOnly', 'key', 'loading_state', 'locale', 'previewer', 'style', 'theme', 'toolbars', 'uploadConfig', 'value']
+        self.available_properties = ['id', 'autoScrollByCursor', 'autoScrollByHashAfterInit', 'className', 'customSyntax', 'debounceWait', 'drawioIframeUrl', 'editor', 'engine', 'fileTypeLimitMap', 'fineControl', 'forceAppend', 'html', 'isPreviewOnly', 'key', 'loading_state', 'locale', 'previewer', 'style', 'theme', 'toolbars', 'uploadConfig', 'value']
         self.available_wildcard_properties =            []
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_utils_components/FefferyPhotoSphereViewer.py

@@ -27,14 +27,20 @@ Keyword arguments:
 - height (string; optional):
     设置查看器高度，同css中的height属性.
 
+- hideNavbarButton (boolean; default False):
+    是否渲染底部导航栏隐藏按钮  默认值：`False`.
+
 - key (string; optional):
     辅助刷新用唯一标识key值.
 
 - lang (dict; optional):
-    为相关功能控件设置鼠标悬停提示信息文案.
+    为相关功能控件或场景设置鼠标悬停提示信息文案.
 
     `lang` is a dict with keys:
 
+    - autorotate (string; optional):
+        自动旋转调节.
+
     - download (string; optional):
         下载操作.
 
@@ -44,6 +50,9 @@ Keyword arguments:
     - littlePlanetButton (string; optional):
         小星球模式.
 
+    - loadError (string; optional):
+        资源加载失败.
+
     - moveDown (string; optional):
         下移操作.
 
@@ -93,10 +102,27 @@ Keyword arguments:
 - moveSpeed (number; default 1):
     设置鼠标平移速度  默认：1.
 
-- navbar (list of a value equal to: 'zoom', 'move', 'download', 'caption', 'fullscreen's | boolean; default ['caption']):
-    配置导航栏中需要显示的功能项及顺序，设置为False时将隐藏导航栏
-    可选的有'zoom'、'move'、'download'、'caption'、'fullscreen'
-    默认：['caption'].
+- navbar (list of a value equal to: 'zoom', 'move', 'download', 'caption', 'fullscreen', 'autorotate's | boolean; default ['caption']):
+    配置导航栏中需要显示的功能项及顺序，设置为`False`时将隐藏导航栏
+    可选的有`'zoom'`、`'move'`、`'download'`、`'caption'`、`'fullscreen'`、`'autorotate'`
+    默认值：`['caption']`.
+
+- plugins (list of dicts; optional):
+    用于配置额外插件功能.
+
+    `plugins` is a list of dicts with keys:
+
+    - autorotateSpeed (string; optional):
+        `Autorotate`模式下，自动旋转速度  默认值：`2rpm`.
+
+    - autostartDelay (number; optional):
+        `Autorotate`模式下，从用户无操作到恢复自动旋转的延时，单位：毫秒  默认值：`2000`.
+
+    - autostartOnIdle (boolean; optional):
+        `Autorotate`模式下，是否在用户无操作一段时间后恢复自动旋转  默认值：`True`.
+
+    - type (a value equal to: 'Autorotate'; required):
+        必填，插件类型，可选项有`'Autorotate'`.
 
 - src (string; optional):
     设置全景图片资源地址.
@@ -111,10 +137,10 @@ Keyword arguments:
     _namespace = 'feffery_utils_components'
     _type = 'FefferyPhotoSphereViewer'
     @_explicitize_args
-    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, src=Component.UNDEFINED, width=Component.UNDEFINED, height=Component.UNDEFINED, littlePlanet=Component.UNDEFINED, containerClass=Component.UNDEFINED, navbar=Component.UNDEFINED, caption=Component.UNDEFINED, downloadUrl=Component.UNDEFINED, loadingImg=Component.UNDEFINED, loadingTxt=Component.UNDEFINED, mousewheel=Component.UNDEFINED, mousemove=Component.UNDEFINED, moveSpeed=Component.UNDEFINED, zoomSpeed=Component.UNDEFINED, fisheye=Component.UNDEFINED, lang=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
-        self._prop_names = ['id', 'caption', 'containerClass', 'downloadUrl', 'fisheye', 'height', 'key', 'lang', 'littlePlanet', 'loadingImg', 'loadingTxt', 'loading_state', 'mousemove', 'mousewheel', 'moveSpeed', 'navbar', 'src', 'width', 'zoomSpeed']
+    def __init__(self, id=Component.UNDEFINED, key=Component.UNDEFINED, src=Component.UNDEFINED, width=Component.UNDEFINED, height=Component.UNDEFINED, littlePlanet=Component.UNDEFINED, containerClass=Component.UNDEFINED, navbar=Component.UNDEFINED, caption=Component.UNDEFINED, downloadUrl=Component.UNDEFINED, loadingImg=Component.UNDEFINED, loadingTxt=Component.UNDEFINED, mousewheel=Component.UNDEFINED, mousemove=Component.UNDEFINED, moveSpeed=Component.UNDEFINED, zoomSpeed=Component.UNDEFINED, fisheye=Component.UNDEFINED, lang=Component.UNDEFINED, hideNavbarButton=Component.UNDEFINED, plugins=Component.UNDEFINED, loading_state=Component.UNDEFINED, **kwargs):
+        self._prop_names = ['id', 'caption', 'containerClass', 'downloadUrl', 'fisheye', 'height', 'hideNavbarButton', 'key', 'lang', 'littlePlanet', 'loadingImg', 'loadingTxt', 'loading_state', 'mousemove', 'mousewheel', 'moveSpeed', 'navbar', 'plugins', 'src', 'width', 'zoomSpeed']
         self._valid_wildcard_attributes =            []
-        self.available_properties = ['id', 'caption', 'containerClass', 'downloadUrl', 'fisheye', 'height', 'key', 'lang', 'littlePlanet', 'loadingImg', 'loadingTxt', 'loading_state', 'mousemove', 'mousewheel', 'moveSpeed', 'navbar', 'src', 'width', 'zoomSpeed']
+        self.available_properties = ['id', 'caption', 'containerClass', 'downloadUrl', 'fisheye', 'height', 'hideNavbarButton', 'key', 'lang', 'littlePlanet', 'loadingImg', 'loadingTxt', 'loading_state', 'mousemove', 'mousewheel', 'moveSpeed', 'navbar', 'plugins', 'src', 'width', 'zoomSpeed']
         self.available_wildcard_properties =            []
         _explicit_args = kwargs.pop('_explicit_args')
         _locals = locals()

package/feffery_utils_components/FefferyVditor.py

@@ -136,7 +136,7 @@ Keyword arguments:
     设置编辑区域最小高度.
 
 - mode (a value equal to: 'wysiwyg', 'ir', 'sv'; default 'ir'):
-    设置模式，可选的有：sv、ir和 wysiwyg，默认为'ir'.
+    设置模式，可选的有：'sv'(分屏预览)、'ir'(即时渲染)和'wysiwyg'(所见即所得)，默认为'ir'(所见即所得).
 
 - outline (dict; optional):
     大纲配置.
@@ -327,7 +327,7 @@ Keyword arguments:
 - theme (a value equal to: 'classic', 'dark'; default 'classic'):
     设置编辑器主题，可选的有：'classic'和'dark'，默认为'classic'.
 
-- toolbar (list of a value equal to: 'emoji', 'headings', 'bold', 'italic', 'strike', '|', 'line', 'quote', 'list', 'ordered-list', 'check', 'outdent', 'indent', 'code', 'inline-code', 'insert-after', 'insert-before', 'undo', 'redo', 'upload', 'link', 'table', 'record', 'edit-mode', 'both', 'preview', 'fullscreen', 'outline', 'code-theme', 'content-theme', 'export', 'devtools', 'info', 'help', 'br's; optional):
+- toolbar (default [
    "emoji",
    "headings",
    "bold",
    "italic",
    "strike",
    "link",
    "|",
    "list",
    "ordered-list",
    "check",
    "outdent",
    "indent",
    "|",
    "quote",
    "line",
    "code",
    "inline-code",
    "insert-before",
    "insert-after",
    "|",
    "upload",
    "record",
    "table",
    "|",
    "undo",
    "redo",
    "|",
    "fullscreen",
    "edit-mode",
    {
        name: "more",
        toolbar: [
            "both",
            "code-theme",
            "content-theme",
            "export",
            "outline",
            "preview"
        ],
    },
     设置工具栏.
 
 - toolbarConfig (dict; default {
    hide: False,
    pin: False

package/feffery_utils_components/__init__.py

@@ -61,7 +61,8 @@ async_resources = [
     'feffery_dom2image',
     'feffery_slider_captcha',
     'feffery_vditor',
-    'feffery_http_requests'
+    'feffery_http_requests',
+    'feffery_burger'
 ]
 
 _js_dist = []

package/feffery_utils_components/_imports_.py

@@ -30,6 +30,7 @@ from .FefferyMarkdownEditor import FefferyMarkdownEditor
 from .FefferyRichTextEditor import FefferyRichTextEditor
 from .FefferyVditor import FefferyVditor
 from .FefferyAnimatedImage import FefferyAnimatedImage
+from .FefferyBurger import FefferyBurger
 from .FefferyCaptcha import FefferyCaptcha
 from .FefferyCompareSlider import FefferyCompareSlider
 from .FefferyCountDown import FefferyCountDown
@@ -141,6 +142,7 @@ __all__ = [
     "FefferyRichTextEditor",
     "FefferyVditor",
     "FefferyAnimatedImage",
+    "FefferyBurger",
     "FefferyCaptcha",
     "FefferyCompareSlider",
     "FefferyCountDown",

package/feffery_utils_components/alias.py

@@ -27,6 +27,7 @@ from .FefferyGrid import FefferyGrid as Grid
 from .FefferyGridItem import FefferyGridItem as GridItem
 from .FefferyRND import FefferyRND as RND
 from .FefferyAnimatedImage import FefferyAnimatedImage as AnimatedImage
+from .FefferyBurger import FefferyBurger as Burger
 from .FefferyCaptcha import FefferyCaptcha as Captcha
 from .FefferyCompareSlider import FefferyCompareSlider as CompareSlider
 from .FefferyCountDown import FefferyCountDown as CountDown
@@ -136,6 +137,7 @@ __all__ = [
     "GridItem",
     "RND",
     "AnimatedImage",
+    "Burger",
     "Captcha",
     "CompareSlider",
     "CountDown",