feffery_utils_components 0.3.4 → 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/CONTRIBUTING.md +4 -4
  2. package/DESCRIPTION +1 -1
  3. package/LICENSE +21 -21
  4. package/MANIFEST.in +6 -6
  5. package/Project.toml +1 -1
  6. package/README-en_US.md +56 -56
  7. package/README.md +56 -56
  8. package/feffery_utils_components/FefferyAPlayer.py +15 -15
  9. package/feffery_utils_components/FefferyAnimatedImage.py +1 -1
  10. package/feffery_utils_components/FefferyAutoAnimate.py +2 -2
  11. package/feffery_utils_components/FefferyAutoFit.py +7 -8
  12. package/feffery_utils_components/FefferyBarcode.py +13 -14
  13. package/feffery_utils_components/FefferyBirdsBackground.py +18 -18
  14. package/feffery_utils_components/FefferyBlockColorPicker.py +3 -3
  15. package/feffery_utils_components/FefferyBurger.py +5 -5
  16. package/feffery_utils_components/FefferyCaptcha.py +4 -4
  17. package/feffery_utils_components/FefferyCellsBackground.py +10 -10
  18. package/feffery_utils_components/FefferyCircleColorPicker.py +4 -4
  19. package/feffery_utils_components/FefferyCloudsBackground.py +13 -13
  20. package/feffery_utils_components/FefferyCloudsTwoBackground.py +11 -11
  21. package/feffery_utils_components/FefferyCompareSlider.py +4 -4
  22. package/feffery_utils_components/FefferyCookie.py +2 -2
  23. package/feffery_utils_components/FefferyCountDown.py +1 -1
  24. package/feffery_utils_components/FefferyCountUp.py +7 -7
  25. package/feffery_utils_components/FefferyDPlayer.py +23 -24
  26. package/feffery_utils_components/FefferyDebounceProp.py +1 -1
  27. package/feffery_utils_components/FefferyDebugGuardian.py +1 -1
  28. package/feffery_utils_components/FefferyDiv.py +10 -10
  29. package/feffery_utils_components/FefferyDom2Image.py +1 -1
  30. package/feffery_utils_components/FefferyDraggable.py +4 -4
  31. package/feffery_utils_components/FefferyEmojiPicker.py +15 -15
  32. package/feffery_utils_components/FefferyEventListener.py +1 -1
  33. package/feffery_utils_components/FefferyEventSource.py +2 -2
  34. package/feffery_utils_components/FefferyExternalCss.py +1 -1
  35. package/feffery_utils_components/FefferyExternalJs.py +1 -1
  36. package/feffery_utils_components/FefferyExtraSpinner.py +1 -1
  37. package/feffery_utils_components/FefferyEyeDropper.py +1 -1
  38. package/feffery_utils_components/FefferyFancyButton.py +6 -6
  39. package/feffery_utils_components/FefferyFancyMessage.py +5 -5
  40. package/feffery_utils_components/FefferyFancyNotification.py +10 -10
  41. package/feffery_utils_components/FefferyFogBackground.py +12 -12
  42. package/feffery_utils_components/FefferyFormatBytes.py +3 -3
  43. package/feffery_utils_components/FefferyFormatNumber.py +3 -3
  44. package/feffery_utils_components/FefferyFullscreen.py +2 -2
  45. package/feffery_utils_components/FefferyGithubColorPicker.py +2 -2
  46. package/feffery_utils_components/FefferyGlobeBackground.py +11 -11
  47. package/feffery_utils_components/FefferyGrid.py +29 -29
  48. package/feffery_utils_components/FefferyGuide.py +8 -8
  49. package/feffery_utils_components/FefferyHaloBackground.py +11 -11
  50. package/feffery_utils_components/FefferyHexColorPicker.py +2 -2
  51. package/feffery_utils_components/FefferyHighlightWords.py +3 -3
  52. package/feffery_utils_components/FefferyHttpRequests.py +2 -2
  53. package/feffery_utils_components/FefferyIdle.py +1 -1
  54. package/feffery_utils_components/FefferyImageCropper.py +34 -34
  55. package/feffery_utils_components/FefferyImageGallery.py +15 -15
  56. package/feffery_utils_components/FefferyImagePaste.py +1 -1
  57. package/feffery_utils_components/FefferyJsonViewer.py +14 -14
  58. package/feffery_utils_components/FefferyKeyPress.py +1 -1
  59. package/feffery_utils_components/FefferyLazyLoad.py +2 -2
  60. package/feffery_utils_components/FefferyListenPaste.py +2 -2
  61. package/feffery_utils_components/FefferyListenUnload.py +1 -1
  62. package/feffery_utils_components/FefferyLocalLargeStorage.py +1 -1
  63. package/feffery_utils_components/FefferyLocalStorage.py +1 -1
  64. package/feffery_utils_components/FefferyLongPress.py +2 -2
  65. package/feffery_utils_components/FefferyMarkdownEditor.py +49 -49
  66. package/feffery_utils_components/FefferyMotion.py +5 -5
  67. package/feffery_utils_components/FefferyMusicPlayer.py +41 -41
  68. package/feffery_utils_components/FefferyNetBackground.py +13 -13
  69. package/feffery_utils_components/FefferyPhotoSphereViewer.py +10 -10
  70. package/feffery_utils_components/FefferyPostEventSource.py +2 -2
  71. package/feffery_utils_components/FefferyQRCode.py +7 -7
  72. package/feffery_utils_components/FefferyRND.py +7 -7
  73. package/feffery_utils_components/FefferyResizable.py +4 -4
  74. package/feffery_utils_components/FefferyRgbColorPicker.py +2 -2
  75. package/feffery_utils_components/FefferyRichTextEditor.py +73 -74
  76. package/feffery_utils_components/FefferyRingsBackground.py +10 -10
  77. package/feffery_utils_components/FefferyRouteMatch.py +1 -1
  78. package/feffery_utils_components/FefferyScroll.py +3 -3
  79. package/feffery_utils_components/FefferyScrollLock.py +1 -1
  80. package/feffery_utils_components/FefferyScrollbars.py +4 -4
  81. package/feffery_utils_components/FefferySeamlessScroll.py +15 -15
  82. package/feffery_utils_components/FefferySessionStorage.py +1 -1
  83. package/feffery_utils_components/FefferyShortcutPanel.py +30 -31
  84. package/feffery_utils_components/FefferySliderCaptcha.py +8 -8
  85. package/feffery_utils_components/FefferySortable.py +6 -6
  86. package/feffery_utils_components/FefferySticky.py +2 -2
  87. package/feffery_utils_components/FefferyTextSelection.py +1 -1
  88. package/feffery_utils_components/FefferyThrottleProp.py +1 -1
  89. package/feffery_utils_components/FefferyTiltHover.py +20 -20
  90. package/feffery_utils_components/FefferyTimeout.py +1 -1
  91. package/feffery_utils_components/FefferyTopProgress.py +9 -10
  92. package/feffery_utils_components/FefferyTopologyBackground.py +9 -9
  93. package/feffery_utils_components/FefferyTrunkBackground.py +11 -11
  94. package/feffery_utils_components/FefferyTwitterColorPicker.py +3 -3
  95. package/feffery_utils_components/FefferyVditor.py +45 -46
  96. package/feffery_utils_components/FefferyWavesBackground.py +12 -12
  97. package/feffery_utils_components/FefferyWebSocket.py +2 -2
  98. package/feffery_utils_components/__init__.py +124 -124
  99. package/feffery_utils_components/alias.py +252 -252
  100. package/feffery_utils_components/async-feffery_animated_image.js +1 -1
  101. package/feffery_utils_components/async-feffery_aplayer.js +1 -1
  102. package/feffery_utils_components/async-feffery_barcode.js +1 -1
  103. package/feffery_utils_components/async-feffery_burger.js +1 -1
  104. package/feffery_utils_components/async-feffery_captcha.js +1 -2
  105. package/feffery_utils_components/async-feffery_color_pickers.js +1 -1
  106. package/feffery_utils_components/async-feffery_dom2image.js +1 -1
  107. package/feffery_utils_components/async-feffery_dplayer.js +1 -1
  108. package/feffery_utils_components/async-feffery_emoji_picker.js +1 -1
  109. package/feffery_utils_components/async-feffery_excel_preview.js +1 -1
  110. package/feffery_utils_components/async-feffery_extra_spinner.js +1 -1
  111. package/feffery_utils_components/async-feffery_extra_spinner.js.LICENSE.txt +0 -9
  112. package/feffery_utils_components/async-feffery_grid.js +1 -1
  113. package/feffery_utils_components/async-feffery_http_requests.js +1 -1
  114. package/feffery_utils_components/async-feffery_image_cropper.js +1 -1
  115. package/feffery_utils_components/async-feffery_json_viewer.js +1 -1
  116. package/feffery_utils_components/async-feffery_local_large_storage.js +1 -1
  117. package/feffery_utils_components/async-feffery_markdown_editor.js +1 -1
  118. package/feffery_utils_components/async-feffery_music_player.js +1 -1
  119. package/feffery_utils_components/async-feffery_photo_sphere_viewer.js +1 -1
  120. package/feffery_utils_components/async-feffery_photo_sphere_viewer.js.LICENSE.txt +4 -4
  121. package/feffery_utils_components/async-feffery_rich_text_editor.js +1 -1
  122. package/feffery_utils_components/async-feffery_rnd.js +1 -1
  123. package/feffery_utils_components/async-feffery_seamless_scroll.js +1 -1
  124. package/feffery_utils_components/async-feffery_shortcut_panel.js +2 -2
  125. package/feffery_utils_components/async-feffery_slider_captcha.js +1 -1
  126. package/feffery_utils_components/async-feffery_sortable.js +1 -1
  127. package/feffery_utils_components/async-feffery_vditor.js +1 -1
  128. package/feffery_utils_components/async-feffery_word_preview.js +1 -1
  129. package/feffery_utils_components/async-fuc-shared.js +1 -1
  130. package/feffery_utils_components/async-fuc-shared.js.LICENSE.txt +9 -0
  131. package/feffery_utils_components/feffery_utils_components.min.js +2 -2
  132. package/feffery_utils_components/metadata.json +1 -1
  133. package/feffery_utils_components/package-info.json +179 -165
  134. package/fuc-logo.svg +126 -126
  135. package/git-operations.md +23 -23
  136. package/package.json +179 -165
  137. package/pytest.ini +5 -5
  138. package/requirements.txt +2 -2
  139. package/review_checklist.md +47 -47
  140. package/ruff.toml +3 -3
  141. package/setup.py +33 -33
  142. package/usage.py +13 -13
  143. package/webpack.config.js +184 -183
  144. package/webpack.serve.config.js +12 -12
  145. package/feffery_utils_components/async-feffery_captcha.js.LICENSE.txt +0 -17
package/CONTRIBUTING.md CHANGED
@@ -1,4 +1,4 @@
1
- # CONTRIBUTING
2
-
3
- This project was generated by the [dash-component-boilerplate](https://github.com/plotly/dash-component-boilerplate) it contains the minimal set of code required to create your own custom Dash component.
4
-
1
+ # CONTRIBUTING
2
+
3
+ This project was generated by the [dash-component-boilerplate](https://github.com/plotly/dash-component-boilerplate) it contains the minimal set of code required to create your own custom Dash component.
4
+
package/DESCRIPTION CHANGED
@@ -1,6 +1,6 @@
1
1
  Package: fefferyUtilsComponents
2
2
  Title: Build more utility components for Plotly Dash.
3
- Version: 0.3.4
3
+ Version: 0.3.5
4
4
  Description: Build more utility components for Plotly Dash.
5
5
  Depends: R (>= 3.0.2)
6
6
  Imports:
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2021 CNFeffery
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2021 CNFeffery
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/MANIFEST.in CHANGED
@@ -1,6 +1,6 @@
1
- include feffery_utils_components/*.js
2
- include feffery_utils_components/*.map
3
- include *.json
4
- include README.md
5
- include LICENSE
6
- include package.json
1
+ include feffery_utils_components/*.js
2
+ include feffery_utils_components/*.map
3
+ include *.json
4
+ include README.md
5
+ include LICENSE
6
+ include package.json
package/Project.toml CHANGED
@@ -2,7 +2,7 @@
2
2
  name = "FefferyUtilsComponents"
3
3
  uuid = "1b08a953-4be3-4667-9a23-209fcf3199fa"
4
4
  authors = ["CNFeffery <fefferypzy@gmail.com>"]
5
- version = "0.3.4"
5
+ version = "0.3.5"
6
6
 
7
7
  [deps]
8
8
  Dash = "1b08a953-4be3-4667-9a23-3db579824955"
package/README-en_US.md CHANGED
@@ -1,57 +1,57 @@
1
- <p align="center">
2
- <img src="./fuc-logo.svg" height=200></img>
3
- </p>
4
- <h1 align="center">feffery-utils-components</h1>
5
- <div align="center">
6
-
7
- [![GitHub](https://img.shields.io/github/license/plotly/dash.svg?color=dark-green)](https://github.com/plotly/dash/blob/master/LICENSE)
8
- [![PyPI](https://img.shields.io/pypi/v/feffery-utils-components.svg?color=dark-green)](https://pypi.org/project/feffery-utils-components/)
9
- [![Downloads](https://pepy.tech/badge/feffery-utils-components)](https://pepy.tech/project/feffery-utils-components)
10
- [![Downloads](https://pepy.tech/badge/feffery-utils-components/month)](https://pepy.tech/project/feffery-utils-components)
11
-
12
- </div>
13
-
14
- [简体中文](./README.md) | English
15
-
16
- A sub-project of the `feffery-components` plan, this `Plotly Dash` third-party component library brings numerous practical utility components to the world of `Dash` 🥳, latest version: `0.3.4`(2025-12-28)
17
-
18
- ## Dash Version Compatibility
19
-
20
- | fuc version | Compatible Dash version |
21
- | :-----: | :----------: |
22
- | >=0.3.0 | >=3.0.0 |
23
- | <0.3.0 | <3.0.0 |
24
-
25
- ## 1 Installation Method for Latest Version
26
-
27
- ```bash
28
- pip install feffery-utils-components -U
29
- ```
30
-
31
- ## 2 Installation Method for Latest Pre-release Version
32
-
33
- > [!NOTE]
34
- > Latest pre-release version (2025-06-27): `0.3.0rc4`
35
-
36
- ```bash
37
- pip install feffery-utils-components --pre -U
38
- ```
39
-
40
- ## 3 Static Resource CDN Acceleration Method
41
-
42
- ```Python
43
- # In non-debug mode, passing serve_locally=False to Dash() forces the browser to load
44
- # dependent xxx.min.js and other static resources from unpkg cdn, avoiding server bandwidth usage
45
- # and suitable for small to medium-sized sites to accelerate access
46
- app = dash.Dash(serve_locally=False)
47
- ```
48
-
49
- ## 4 Online Documentation
50
-
51
- <a href='http://fuc.feffery.tech/' target='_blank'>Documentation Link</a>
52
-
53
- ## 5 Contributors
54
-
55
- <a href = "https://github.com/CNFeffery/feffery-utils-components/graphs/contributors">
56
- <img src = "https://contrib.rocks/image?repo=CNFeffery/feffery-utils-components"/>
1
+ <p align="center">
2
+ <img src="./fuc-logo.svg" height=200></img>
3
+ </p>
4
+ <h1 align="center">feffery-utils-components</h1>
5
+ <div align="center">
6
+
7
+ [![GitHub](https://img.shields.io/github/license/plotly/dash.svg?color=dark-green)](https://github.com/plotly/dash/blob/master/LICENSE)
8
+ [![PyPI](https://img.shields.io/pypi/v/feffery-utils-components.svg?color=dark-green)](https://pypi.org/project/feffery-utils-components/)
9
+ [![Downloads](https://pepy.tech/badge/feffery-utils-components)](https://pepy.tech/project/feffery-utils-components)
10
+ [![Downloads](https://pepy.tech/badge/feffery-utils-components/month)](https://pepy.tech/project/feffery-utils-components)
11
+
12
+ </div>
13
+
14
+ [简体中文](./README.md) | English
15
+
16
+ A sub-project of the `feffery-components` plan, this `Plotly Dash` third-party component library brings numerous practical utility components to the world of `Dash` 🥳, latest version: `0.3.5`(2026-01-16)
17
+
18
+ ## Dash Version Compatibility
19
+
20
+ | fuc version | Compatible Dash version |
21
+ | :-----: | :----------: |
22
+ | >=0.3.0 | >=3.0.0 |
23
+ | <0.3.0 | <3.0.0 |
24
+
25
+ ## 1 Installation Method for Latest Version
26
+
27
+ ```bash
28
+ pip install feffery-utils-components -U
29
+ ```
30
+
31
+ ## 2 Installation Method for Latest Pre-release Version
32
+
33
+ > [!NOTE]
34
+ > Latest pre-release version (2025-06-27): `0.3.0rc4`
35
+
36
+ ```bash
37
+ pip install feffery-utils-components --pre -U
38
+ ```
39
+
40
+ ## 3 Static Resource CDN Acceleration Method
41
+
42
+ ```Python
43
+ # In non-debug mode, passing serve_locally=False to Dash() forces the browser to load
44
+ # dependent xxx.min.js and other static resources from unpkg cdn, avoiding server bandwidth usage
45
+ # and suitable for small to medium-sized sites to accelerate access
46
+ app = dash.Dash(serve_locally=False)
47
+ ```
48
+
49
+ ## 4 Online Documentation
50
+
51
+ <a href='http://fuc.feffery.tech/' target='_blank'>Documentation Link</a>
52
+
53
+ ## 5 Contributors
54
+
55
+ <a href = "https://github.com/CNFeffery/feffery-utils-components/graphs/contributors">
56
+ <img src = "https://contrib.rocks/image?repo=CNFeffery/feffery-utils-components"/>
57
57
  </a>
package/README.md CHANGED
@@ -1,56 +1,56 @@
1
- <p align="center">
2
- <img src="./fuc-logo.svg" height=200></img>
3
- </p>
4
- <h1 align="center">feffery-utils-components</h1>
5
- <div align="center">
6
-
7
- [![GitHub](https://img.shields.io/github/license/plotly/dash.svg?color=dark-green)](https://github.com/plotly/dash/blob/master/LICENSE)
8
- [![PyPI](https://img.shields.io/pypi/v/feffery-utils-components.svg?color=dark-green)](https://pypi.org/project/feffery-utils-components/)
9
- [![Downloads](https://pepy.tech/badge/feffery-utils-components)](https://pepy.tech/project/feffery-utils-components)
10
- [![Downloads](https://pepy.tech/badge/feffery-utils-components/month)](https://pepy.tech/project/feffery-utils-components)
11
-
12
- </div>
13
-
14
- 简体中文 | [English](./README-en_US.md)
15
-
16
- `feffery-components`计划子项目,`Plotly Dash`第三方组件库,将超多实用辅助功能组件引入`Dash`的世界 🥳,最新版本:`0.3.4`(2025-12-28
17
-
18
- ## Dash版本兼容性说明
19
-
20
- | fuc版本 | 适用Dash版本 |
21
- | :-----: | :----------: |
22
- | >=0.3.0 | >=3.0.0 |
23
- | <0.3.0 | <3.0.0 |
24
-
25
- ## 1 最新版本安装方式
26
-
27
- ```bash
28
- pip install feffery-utils-components -U
29
- ```
30
-
31
- ## 2 最新预发布版本安装方式
32
-
33
- > [!NOTE]
34
- > 最新预发布版本(2025-06-27):`0.3.0rc4`
35
-
36
- ```bash
37
- pip install feffery-utils-components --pre -U
38
- ```
39
-
40
- ## 3 静态资源 CDN 加速方法
41
-
42
- ```Python
43
- # 非debug模式下对Dash()传入参数serve_locally=False会强制浏览器端从unpkg cdn加载各个依赖的
44
- # xxx.min.js等静态资源,从而避免占用服务器带宽,适合中小型站点加速访问
45
- app = dash.Dash(serve_locally=False)
46
- ```
47
-
48
- ## 4 在线文档
49
-
50
- <a href='http://fuc.feffery.tech/' target='_blank'>文档地址</a>
51
-
52
- ## 5 贡献者
53
-
54
- <a href = "https://github.com/CNFeffery/feffery-utils-components/graphs/contributors">
55
- <img src = "https://contrib.rocks/image?repo=CNFeffery/feffery-utils-components"/>
56
- </a>
1
+ <p align="center">
2
+ <img src="./fuc-logo.svg" height=200></img>
3
+ </p>
4
+ <h1 align="center">feffery-utils-components</h1>
5
+ <div align="center">
6
+
7
+ [![GitHub](https://img.shields.io/github/license/plotly/dash.svg?color=dark-green)](https://github.com/plotly/dash/blob/master/LICENSE)
8
+ [![PyPI](https://img.shields.io/pypi/v/feffery-utils-components.svg?color=dark-green)](https://pypi.org/project/feffery-utils-components/)
9
+ [![Downloads](https://pepy.tech/badge/feffery-utils-components)](https://pepy.tech/project/feffery-utils-components)
10
+ [![Downloads](https://pepy.tech/badge/feffery-utils-components/month)](https://pepy.tech/project/feffery-utils-components)
11
+
12
+ </div>
13
+
14
+ 简体中文 | [English](./README-en_US.md)
15
+
16
+ `feffery-components`计划子项目,`Plotly Dash`第三方组件库,将超多实用辅助功能组件引入`Dash`的世界 🥳,最新版本:`0.3.5`(2026-01-16
17
+
18
+ ## Dash版本兼容性说明
19
+
20
+ | fuc版本 | 适用Dash版本 |
21
+ | :-----: | :----------: |
22
+ | >=0.3.0 | >=3.0.0 |
23
+ | <0.3.0 | <3.0.0 |
24
+
25
+ ## 1 最新版本安装方式
26
+
27
+ ```bash
28
+ pip install feffery-utils-components -U
29
+ ```
30
+
31
+ ## 2 最新预发布版本安装方式
32
+
33
+ > [!NOTE]
34
+ > 最新预发布版本(2025-06-27):`0.3.0rc4`
35
+
36
+ ```bash
37
+ pip install feffery-utils-components --pre -U
38
+ ```
39
+
40
+ ## 3 静态资源 CDN 加速方法
41
+
42
+ ```Python
43
+ # 非debug模式下对Dash()传入参数serve_locally=False会强制浏览器端从unpkg cdn加载各个依赖的
44
+ # xxx.min.js等静态资源,从而避免占用服务器带宽,适合中小型站点加速访问
45
+ app = dash.Dash(serve_locally=False)
46
+ ```
47
+
48
+ ## 4 在线文档
49
+
50
+ <a href='http://fuc.feffery.tech/' target='_blank'>文档地址</a>
51
+
52
+ ## 5 贡献者
53
+
54
+ <a href = "https://github.com/CNFeffery/feffery-utils-components/graphs/contributors">
55
+ <img src = "https://contrib.rocks/image?repo=CNFeffery/feffery-utils-components"/>
56
+ </a>
@@ -34,25 +34,25 @@ Keyword arguments:
34
34
  当前组件css类名,支持[动态css](/advanced-classname).
35
35
 
36
36
  - fixed (boolean; default False):
37
- 是否开启吸底模式 默认值:`False`.
37
+ 是否开启吸底模式 默认值:`False`.
38
38
 
39
39
  - mini (boolean; default False):
40
- 是否开启迷你模式 默认值:`False`.
40
+ 是否开启迷你模式 默认值:`False`.
41
41
 
42
42
  - autoplay (boolean; default False):
43
- 音频是否自动播放 默认值:`False`.
43
+ 音频是否自动播放 默认值:`False`.
44
44
 
45
45
  - theme (string; default '#b7daff'):
46
- 设置主题色 默认值:`'#b7daff'`.
46
+ 设置主题色 默认值:`'#b7daff'`.
47
47
 
48
48
  - loop (a value equal to: 'all', 'one', 'none'; default 'all'):
49
- 设置音频循环播放, 可选值: `'all'`、`'one'`、`'none'` 默认值:`'all'`.
49
+ 设置音频循环播放, 可选值: `'all'`、`'one'`、`'none'` 默认值:`'all'`.
50
50
 
51
51
  - order (a value equal to: 'list', 'random'; default 'list'):
52
- 设置音频循环顺序, 可选值: `'list'`、`'random'` 默认值:`'list'`.
52
+ 设置音频循环顺序, 可选值: `'list'`、`'random'` 默认值:`'list'`.
53
53
 
54
54
  - preload (a value equal to: 'none', 'metadata', 'auto'; default 'auto'):
55
- 设置音频预加载,可选值: `'none'`、`'metadata'`、`'auto'` 默认值:`'auto'`.
55
+ 设置音频预加载,可选值: `'none'`、`'metadata'`、`'auto'` 默认值:`'auto'`.
56
56
 
57
57
  - volume (number; default 0.7):
58
58
  默认音量,请注意播放器会记忆用户设置,用户手动设置音量后默认音量即失效.
@@ -81,26 +81,26 @@ Keyword arguments:
81
81
  设置切换到此音频时的主题色,比上面的`theme`优先级高.
82
82
 
83
83
  - type (a value equal to: 'auto', 'hls', 'normal'; optional):
84
- 设置音频类型,可选的有`'auto'`、`'hls'`、`'normal'` 默认值:`'auto'`.
84
+ 设置音频类型,可选的有`'auto'`、`'hls'`、`'normal'` 默认值:`'auto'`.
85
85
 
86
86
  - mutex (boolean; default True):
87
- 是否互斥,阻止多个播放器同时播放,当前播放器播放时暂停其他播放器 默认值:`True`.
87
+ 是否互斥,阻止多个播放器同时播放,当前播放器播放时暂停其他播放器 默认值:`True`.
88
88
 
89
89
  - lrcType (a value equal to: 0, 1, 2, 3; default 0):
90
90
  有三种方式来给`APlayer`传递歌词,使用`lrcType`参数指明使用哪种方式,然后把歌词放到`audio.lrc`参数或者`HTML`里
91
91
  `1`表示把歌词放到`JS`字符串里面,`2`表示把歌词放到`HTML`里面,`3`表示把歌词放到`LRC`文件里,音频播放时会加载对应的`LRC`文件
92
- `audio.lrc`支持下面格式的歌词: `[mm:ss]APlayer[mm:ss.xx]is`
93
- `[mm:ss.xxx]amazing` `[mm:ss.xx][mm:ss.xx]APlayer`
94
- `[mm:ss.xx]<mm:ss.xx>is` `[mm:ss.xx]amazing[mm:ss.xx]APlayer`.
92
+ `audio.lrc`支持下面格式的歌词: `[mm:ss]APlayer[mm:ss.xx]is`
93
+ `[mm:ss.xxx]amazing` `[mm:ss.xx][mm:ss.xx]APlayer`
94
+ `[mm:ss.xx]<mm:ss.xx>is` `[mm:ss.xx]amazing[mm:ss.xx]APlayer`.
95
95
 
96
96
  - listFolded (boolean; default False):
97
- 列表是否默认折叠 默认值:`False`.
97
+ 列表是否默认折叠 默认值:`False`.
98
98
 
99
99
  - listMaxHeight (number; optional):
100
100
  设置列表最大高度.
101
101
 
102
102
  - storageName (string; default 'aplayer-setting'):
103
- 存储播放器设置的`localStorage key` 默认值:`'aplayer-setting'`.
103
+ 存储播放器设置的`localStorage key` 默认值:`'aplayer-setting'`.
104
104
 
105
105
  - play (boolean; default False):
106
106
  播放音频,每次设置为`True`后执行完相应操作后会自动置为`False`.
@@ -193,7 +193,7 @@ Keyword arguments:
193
193
 
194
194
  - type (a value equal to: 'auto', 'hls', 'normal'; optional):
195
195
 
196
- 设置音频类型,可选的有`'auto'`、`'hls'`、`'normal'` 默认值:`'auto'`.
196
+ 设置音频类型,可选的有`'auto'`、`'hls'`、`'normal'` 默认值:`'auto'`.
197
197
 
198
198
  - removeList (dict; default { isRemove: False }):
199
199
  删除播放列表中的音频,每次`isRemove`设置为`True`后执行完相应操作后会自动置为`False`.
@@ -40,7 +40,7 @@ Keyword arguments:
40
40
  动图`alt`信息.
41
41
 
42
42
  - play (boolean; default False):
43
- 初始化是否自动播放动图 默认值:`False`."""
43
+ 初始化是否自动播放动图 默认值:`False`."""
44
44
  _children_props: typing.List[str] = []
45
45
  _base_nodes = ['children']
46
46
  _namespace = 'feffery_utils_components'
@@ -37,10 +37,10 @@ Keyword arguments:
37
37
  当前组件css类名,支持[动态css](/advanced-classname).
38
38
 
39
39
  - duration (number; default 0.25):
40
- 配置动画时长,单位:秒 默认为`0.25`.
40
+ 配置动画时长,单位:秒 默认为`0.25`.
41
41
 
42
42
  - easing (string; default 'ease-in-out'):
43
- 设置过渡动画函数,同css中的`easing-function` 默认为`'ease-in-out'`."""
43
+ 设置过渡动画函数,同css中的`easing-function` 默认为`'ease-in-out'`."""
44
44
  _children_props: typing.List[str] = []
45
45
  _base_nodes = ['children']
46
46
  _namespace = 'feffery_utils_components'
@@ -31,16 +31,16 @@ Keyword arguments:
31
31
  对当前组件的`key`值进行更新,可实现强制重绘当前组件的效果.
32
32
 
33
33
  - containerId (string; default 'body'):
34
- 要进行自适应的目标元素id 默认值:`'body'`.
34
+ 要进行自适应的目标元素id 默认值:`'body'`.
35
35
 
36
36
  - dw (number; default 1920):
37
37
  设计稿的宽度,默认是1920.
38
38
 
39
39
  - dh (number; default 1080):
40
- 设计稿的高度 默认值:`1080`.
40
+ 设计稿的高度 默认值:`1080`.
41
41
 
42
42
  - resize (boolean; default True):
43
- 是否监听resize事件 默认值:`True`.
43
+ 是否监听resize事件 默认值:`True`.
44
44
 
45
45
  - ignore (list of dicts; optional):
46
46
  忽略缩放的元素列表(列表内的元素将反向缩放).
@@ -51,17 +51,16 @@ Keyword arguments:
51
51
  要忽略缩放的元素的选择器名.
52
52
 
53
53
  - transition (number; default 0):
54
- 过渡时间 默认值:`0`.
54
+ 过渡时间 默认值:`0`.
55
55
 
56
56
  - delay (number; default 0):
57
- 延迟时间 默认值:`0`.
57
+ 延迟时间 默认值:`0`.
58
58
 
59
59
  - limit (number; default 0.1):
60
- 不缩放的临界值,当缩放阈值不大于此值时不缩放,比如设置为`0.1`时,`0.9-1.1`的范围会被重置为`1`
61
- 默认值:`0.1`.
60
+ 不缩放的临界值,当缩放阈值不大于此值时不缩放,比如设置为`0.1`时,`0.9-1.1`的范围会被重置为`1` 默认值:`0.1`.
62
61
 
63
62
  - close (boolean; default False):
64
- 关闭自适应,设置为`True`执行完相应操作后会自动重置为`False` 默认为`False`."""
63
+ 关闭自适应,设置为`True`执行完相应操作后会自动重置为`False` 默认为`False`."""
65
64
  _children_props: typing.List[str] = []
66
65
  _base_nodes = ['children']
67
66
  _namespace = 'feffery_utils_components'
@@ -34,7 +34,7 @@ Keyword arguments:
34
34
  当前组件css类名,支持[动态css](/advanced-classname).
35
35
 
36
36
  - renderer (a value equal to: 'img', 'svg', 'canvas'; default 'canvas'):
37
- 渲染类型,可选的有`'img'`、`'svg'`、`'canvas'` 默认值:`'canvas'`.
37
+ 渲染类型,可选的有`'img'`、`'svg'`、`'canvas'` 默认值:`'canvas'`.
38
38
 
39
39
  - value (string; optional):
40
40
  设置条形码所表达的信息值.
@@ -44,41 +44,40 @@ Keyword arguments:
44
44
  默认值:`'CODE128'`.
45
45
 
46
46
  - width (number; default 2):
47
- 设置条形码宽度 默认值:`2`.
47
+ 设置条形码宽度 默认值:`2`.
48
48
 
49
49
  - height (number; default 100):
50
- 设置条形码高度 默认值:`100`.
50
+ 设置条形码高度 默认值:`100`.
51
51
 
52
52
  - displayValue (boolean; default True):
53
- 设置是否显示条形码所表达的信息值 默认值:`True`.
53
+ 设置是否显示条形码所表达的信息值 默认值:`True`.
54
54
 
55
55
  - text (string; optional):
56
56
  设置条形码显示的文本.
57
57
 
58
58
  - fontOptions (string; default ''):
59
- 设置条形码显示文本的字体样式 默认值:''.
59
+ 设置条形码显示文本的字体样式 默认值:''.
60
60
 
61
61
  - font (string; default 'monospace'):
62
- 设置条形码显示文本的字体种类 默认值:'monospace'.
62
+ 设置条形码显示文本的字体种类 默认值:'monospace'.
63
63
 
64
64
  - fontSize (number; default 20):
65
- 设置条形码显示文本的字体大小 默认值:`20`.
65
+ 设置条形码显示文本的字体大小 默认值:`20`.
66
66
 
67
67
  - textAlign (a value equal to: 'left', 'center', 'right'; default 'center'):
68
- 设置条形码显示文本的水平对齐方式,可选的有`'left'`、`'center'`、`'right'`
69
- 默认值:`'center'`.
68
+ 设置条形码显示文本的水平对齐方式,可选的有`'left'`、`'center'`、`'right'` 默认值:`'center'`.
70
69
 
71
70
  - textPosition (a value equal to: 'top', 'bottom'; default 'bottom'):
72
- 设置条形码显示文本的垂直位置,可选的有`'top'`、`'bottom'` 默认值:`'bottom'`.
71
+ 设置条形码显示文本的垂直位置,可选的有`'top'`、`'bottom'` 默认值:`'bottom'`.
73
72
 
74
73
  - textMargin (number; default 2):
75
- 设置条形码和显示文本之间的间距 默认值:`2`.
74
+ 设置条形码和显示文本之间的间距 默认值:`2`.
76
75
 
77
76
  - background (string; default '#ffffff'):
78
- 设置条形码的背景颜色 默认值:`'#ffffff'`.
77
+ 设置条形码的背景颜色 默认值:`'#ffffff'`.
79
78
 
80
79
  - lineColor (string; default '#000000'):
81
- 设置条形码的线条和显示文本颜色 默认值:`'#000000'`.
80
+ 设置条形码的线条和显示文本颜色 默认值:`'#000000'`.
82
81
 
83
82
  - margin (number; default 10):
84
83
  设置条形码周围的间距边距,如果未设置`marginTop`、`marginBottom`、`marginLeft`、`marginRight`,则这四个参数将继承`margins`的值
@@ -97,7 +96,7 @@ Keyword arguments:
97
96
  设置条形码周围的右间距边距.
98
97
 
99
98
  - flat (boolean; default False):
100
- 设置条形码是否保持平整,仅适用于`EAN8`和`EAN13` 默认值:`False`."""
99
+ 设置条形码是否保持平整,仅适用于`EAN8`和`EAN13` 默认值:`False`."""
101
100
  _children_props: typing.List[str] = []
102
101
  _base_nodes = ['children']
103
102
  _namespace = 'feffery_utils_components'
@@ -37,62 +37,62 @@ Keyword arguments:
37
37
  当前组件css类名,支持[动态css](/advanced-classname).
38
38
 
39
39
  - mouseControls (boolean; default True):
40
- 设置是否开启鼠标控 默认为`True`.
40
+ 设置是否开启鼠标控 默认为`True`.
41
41
 
42
42
  - touchControls (boolean; default True):
43
- 设置是否开启触摸控制 默认为`True`.
43
+ 设置是否开启触摸控制 默认为`True`.
44
44
 
45
45
  - gyroControls (boolean; default False):
46
- 设置是否开启陀螺仪控制 默认为`False`.
46
+ 设置是否开启陀螺仪控制 默认为`False`.
47
47
 
48
48
  - minHeight (number; default 200.00):
49
- 设置最小高度 默认为`200.00`.
49
+ 设置最小高度 默认为`200.00`.
50
50
 
51
51
  - minWidth (number; default 200.00):
52
- 设置最小宽度 默认为`200.00`.
52
+ 设置最小宽度 默认为`200.00`.
53
53
 
54
54
  - scale (number; default 1.00):
55
- 设置比例 默认为`1.00`.
55
+ 设置比例 默认为`1.00`.
56
56
 
57
57
  - scaleMobile (number; default 1.00):
58
- 设置移动端比例 默认为`1.00`.
58
+ 设置移动端比例 默认为`1.00`.
59
59
 
60
60
  - backgroundColor (string; default '#000000'):
61
- 设置背景颜色 默认为`'#000000'`.
61
+ 设置背景颜色 默认为`'#000000'`.
62
62
 
63
63
  - backgroundAlpha (number; default 1):
64
- 设置背景颜色透明度,范围`0`到`1` 默认为`1`.
64
+ 设置背景颜色透明度,范围`0`到`1` 默认为`1`.
65
65
 
66
66
  - color1 (string; default '#ff0000'):
67
- 设置birds颜色1 默认为`'#ff0000'`.
67
+ 设置birds颜色1 默认为`'#ff0000'`.
68
68
 
69
69
  - color2 (string; default '#13becf'):
70
- 设置birds颜色2 默认为`'#13becf'`.
70
+ 设置birds颜色2 默认为`'#13becf'`.
71
71
 
72
72
  - colorMode (a value equal to: 'lerp', 'variance', 'lerpGradient', 'varianceGradient'; default 'varianceGradient'):
73
73
  设置颜色模式,可选的有`'lerp'`、`'variance'`、`'lerpGradient'`、`'varianceGradient'`
74
74
  默认为`'varianceGradient'`.
75
75
 
76
76
  - quantity (number; default 5):
77
- 设置背景质量,范围`1`到`5` 默认为`5`.
77
+ 设置背景质量,范围`1`到`5` 默认为`5`.
78
78
 
79
79
  - birdSize (number; default 1):
80
- 设置birds大小,范围`1`到`4` 默认为`1`.
80
+ 设置birds大小,范围`1`到`4` 默认为`1`.
81
81
 
82
82
  - wingSpan (number; default 30):
83
- 设置birds翼展,范围`10`到`40` 默认为`30`.
83
+ 设置birds翼展,范围`10`到`40` 默认为`30`.
84
84
 
85
85
  - speedLimit (number; default 5):
86
- 设置birds速度限制,范围`1`到`10` 默认为`5`.
86
+ 设置birds速度限制,范围`1`到`10` 默认为`5`.
87
87
 
88
88
  - separation (number; default 20):
89
- 设置birds分离大小,范围`1`到`100 默认为`20`.
89
+ 设置birds分离大小,范围`1`到`100 默认为`20`.
90
90
 
91
91
  - alignment (number; default 20):
92
- 设置birds对齐大小,范围`1`到`100` 默认为`20`.
92
+ 设置birds对齐大小,范围`1`到`100` 默认为`20`.
93
93
 
94
94
  - cohesion (number; default 20):
95
- 设置birds内聚大小,范围`1`到`100` 默认为`20`."""
95
+ 设置birds内聚大小,范围`1`到`100` 默认为`20`."""
96
96
  _children_props: typing.List[str] = []
97
97
  _base_nodes = ['children']
98
98
  _namespace = 'feffery_utils_components'
@@ -34,18 +34,18 @@ Keyword arguments:
34
34
  当前组件css类名.
35
35
 
36
36
  - width (string; default '170px'):
37
- 整体宽度 默认值:`'170px'`.
37
+ 整体宽度 默认值:`'170px'`.
38
38
 
39
39
  - color (string; optional):
40
40
  监听或设置当前选中色彩对应16进制颜色值.
41
41
 
42
42
  - colors (list of strings; default ['#D9E3F0', '#F47373', '#697689', '#37D67A', '#2CCCE4', '#555555', '#dce775', '#ff8a65', '#ba68c8']):
43
- 设置可选色彩对应16进制颜色值数组 默认值:`['#D9E3F0', '#F47373', '#697689',
43
+ 设置可选色彩对应16进制颜色值数组 默认值:`['#D9E3F0', '#F47373', '#697689',
44
44
  '#37D67A', '#2CCCE4', '#555555', '#dce775', '#ff8a65',
45
45
  '#ba68c8']`.
46
46
 
47
47
  - triangle (a value equal to: 'hide', 'top'; default 'top'):
48
- 顶部箭头方位,可选项有`'hide'`、`'top'` 默认值:`'top'`."""
48
+ 顶部箭头方位,可选项有`'hide'`、`'top'` 默认值:`'top'`."""
49
49
  _children_props: typing.List[str] = []
50
50
  _base_nodes = ['children']
51
51
  _namespace = 'feffery_utils_components'