ex4nicegui 0.8.6__py3-none-any.whl → 0.8.7__py3-none-any.whl

ex4nicegui/reactive/EChartsComponent/ECharts.js

@@ -1,6 +1,13 @@
 import 'echarts'
 import { convertDynamicProperties } from "../../static/utils/dynamic_properties.js";
 
+const registerThemeTask = Promise.all(
+  (echarts._ex4ng_themes || []).map(async ({ name, url }) => {
+    const data = await fetch(url).then(response => response.json());
+    echarts.registerTheme(name, data);
+  })
+);
+
 function collectMapRegisterTask() {
   const tasks = new Map();
 
@@ -57,6 +64,8 @@ export default {
   async mounted() {
     await new Promise((resolve) => setTimeout(resolve, 0)); // wait for Tailwind classes to be applied
 
+    await registerThemeTask;
+
     this.chart = echarts.init(this.$el, this.theme, this.initOptions);
     this.resizeObs = new ResizeObserver(this.chart.resize)
 

ex4nicegui/reactive/EChartsComponent/ECharts.py

@@ -28,6 +28,7 @@ class echarts(Element, component="ECharts.js", dependencies=libraries):  # type:
         options: Optional[dict] = None,
         code: Optional[str] = None,
         init_options: Optional[dict] = None,
+        theme: Optional[str] = None,
     ) -> None:
         super().__init__()
 
@@ -47,6 +48,9 @@ class echarts(Element, component="ECharts.js", dependencies=libraries):  # type:
         self._props["initOptions"] = init_options
         self._props["eventTasks"] = {}
 
+        if theme:
+            self._props["theme"] = theme
+
     def update_chart(
         self,
         merge_opts: Optional[dict] = None,

ex4nicegui/reactive/officials/echarts.py

@@ -1,5 +1,5 @@
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Union, cast, Optional, Literal
+from typing import Any, Callable, Dict, List, Union, cast, Optional, Literal, ClassVar
 from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
     TGetterOrReadonlyRef,
@@ -17,10 +17,14 @@ from ex4nicegui.reactive.EChartsComponent.events import EChartsMouseEventArgumen
 from nicegui.awaitable_response import AwaitableResponse
 from nicegui import ui, app
 import orjson as json
+from contextvars import ContextVar
 
 
 class EChartsBindableUi(BindableUi[echarts]):
     EChartsMouseEventArguments = EChartsMouseEventArguments
+    _CURRENT_THEME: ClassVar[ContextVar[Optional[str]]] = ContextVar(
+        "CURRENT_THEME", default=None
+    )
 
     def __init__(
         self,
@@ -28,6 +32,8 @@ class EChartsBindableUi(BindableUi[echarts]):
         not_merge: TMaybeRef[Union[bool, None]] = None,
         code: Optional[str] = None,
         init_options: Optional[Dict] = None,
+        *,
+        theme: Optional[str] = None,
     ) -> None:
         """Create a new ECharts instance.
 
@@ -43,10 +49,11 @@ class EChartsBindableUi(BindableUi[echarts]):
         pc = ParameterClassifier(
             locals(),
             maybeRefs=["options", "code", "init_options"],
-            exclude=["not_merge"],
+            exclude=["not_merge", "theme"],
         )
 
         value_kws = pc.get_values_kws()
+        value_kws["theme"] = theme or self._CURRENT_THEME.get()
 
         element = echarts(**value_kws).classes("nicegui-echart")
 
@@ -59,6 +66,44 @@ class EChartsBindableUi(BindableUi[echarts]):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
+    @classmethod
+    def register_theme(cls, name: str, theme: Path):
+        """register a new theme to echarts.
+
+        @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#rxuiechartsregister_theme
+        @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#rxuiechartsregister_theme
+
+        Args:
+            name (str): Theme name.
+            theme (Path): Theme file path.
+
+        ## Examples
+        .. code-block:: python
+
+            @ui.page('/)
+            def index():
+                rxui.echarts.register_theme("my_theme", Path("path/to/my_theme.json"))
+                rxui.echarts(opts)
+
+        """
+
+        url = app.add_static_file(local_file=theme)
+
+        ui.add_body_html(
+            rf"""
+    <script type="module">
+        import "echarts";
+        echarts._ex4ng_themes = echarts._ex4ng_themes || [];
+        echarts._ex4ng_themes.push({{
+            name: "{name}",
+            url: "{url}"
+        }});
+    </script>
+        """
+        )
+        cls._CURRENT_THEME.set(name)
+        return cls
+
     @classmethod
     def register_map(
         cls,

{ex4nicegui-0.8.6.dist-info → ex4nicegui-0.8.7.dist-info}/METADATA

@@ -1,8 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: ex4nicegui
-Version: 0.8.6
+Version: 0.8.7
 Summary: Extension library based on nicegui, providing data responsive,BI functionality modules
-Home-page: https://github.com/CrystalWindSnake/ex4nicegui
 License: MIT
 Keywords: nicegui,ex4nicegui,webui
 Author: CrystalWindSnake
@@ -15,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: executing (>=2.0.1,<3.0.0)
 Requires-Dist: nicegui (>=2.0.0,<3.0.0)
 Requires-Dist: signe (>=0.4.22,<0.5.0)
@@ -458,6 +458,7 @@ class MyApp(rxui.ViewModel):
         - [echarts 图表鼠标事件](#echarts-图表鼠标事件)
         - [rxui.echarts.from\_javascript](#rxuiechartsfrom_javascript)
         - [rxui.echarts.register\_map](#rxuiechartsregister_map)
+        - [rxui.echarts.register\_theme](#rxuiechartsregister_theme)
       - [tab\_panels](#tab_panels)
       - [lazy\_tab\_panels](#lazy_tab_panels)
       - [scoped\_style](#scoped_style)
@@ -1346,6 +1347,35 @@ rxui.echarts.register_map(
 )
 ```
 
+---
+##### rxui.echarts.register_theme
+注册主题.
+
+```python
+@ui.page("/")
+def page():
+    # 本页范围，所有 rxui.echarts 默认主题均为 walden(最后注册的主题)
+    rxui.echarts.register_theme(
+        "my_theme", Path(__file__).parent / "echarts_theme.json"
+    ).register_theme("walden", Path(__file__).parent / "echarts_walden.json")
+
+    opts = {
+        "xAxis": {"data": ["Shirts", "Cardigans"]},
+        "yAxis": {},
+        "series": [{"type": "bar", "data": [5, 20]}],
+    }
+
+    # 主题为 walden
+    rxui.echarts(opts)
+
+    # 主题为 my_theme
+    rxui.echarts(
+        opts,
+        theme="my_theme",
+    )
+
+```
+
 ---
 
 #### tab_panels

{ex4nicegui-0.8.6.dist-info → ex4nicegui-0.8.7.dist-info}/RECORD

@@ -75,8 +75,8 @@ ex4nicegui/reactive/base.py,sha256=CQmWhrKHNMF2ql7O6VOKEOBdEcc3-yagOcERpnUPYus,1
 ex4nicegui/reactive/deferredTask.py,sha256=g78TTG1EIkBxjPih01xmrCZw9OxQG93veSVSELWKfcU,987
 ex4nicegui/reactive/dropZone/dropZone.js,sha256=7rSpFJX-Fk_W_NGZhOTyuEw0bzR-YUc8ZYPzQG9KzE0,2713
 ex4nicegui/reactive/dropZone/dropZone.py,sha256=hg9UKTayff8v8Ek-n38h_3wX1Qmiotvdyv1Hsqilh5Y,2590
-ex4nicegui/reactive/EChartsComponent/ECharts.js,sha256=K9sX34SMnghwDMCkl-IA7WsntxyryeRsboihkIwDb84,3852
-ex4nicegui/reactive/EChartsComponent/ECharts.py,sha256=jLRdKqJWCtKHzNlFAX9ePAmzP1WSXRzBQAO0KHHkfBA,4258
+ex4nicegui/reactive/EChartsComponent/ECharts.js,sha256=Dhsfzlio9zO2T3LhK5cI7IdPXHtWhbBXMdlL3uvkU24,4110
+ex4nicegui/reactive/EChartsComponent/ECharts.py,sha256=NjJocWIEF4xzvRQVbkTQSaB2fF_GIVf2_QaMKjln9hU,4359
 ex4nicegui/reactive/EChartsComponent/events.py,sha256=ln10cNw5ODiSmdKVi6KBZ6JMR3YIZ6itYZcMgNAlKhA,741
 ex4nicegui/reactive/EChartsComponent/types.py,sha256=_7AekG0IyzRpDEBZMtKRiZ3o3dUCcn6btegBk8c9Fig,1001
 ex4nicegui/reactive/EChartsComponent/utils.py,sha256=YqxodbGD_lk_Bp-K8s8XvgqSXRf_CIHmzeubrqFRuVM,1013
@@ -105,7 +105,7 @@ ex4nicegui/reactive/officials/column.py,sha256=fllKknMEUw7uNhmP7w4pgBT7HTDbpkN-d
 ex4nicegui/reactive/officials/date.py,sha256=lRiJNrgs_oNo9AZTfTX_66dYL7az4co5rfRyIzvGAIo,2440
 ex4nicegui/reactive/officials/dialog.py,sha256=3dyrvsUwM1Q7jr_PgLKt92KDA6Hris0DH90-sKamfFE,1297
 ex4nicegui/reactive/officials/drawer.py,sha256=_Ro6stOh8U3igYMeDwI4omBgi1nld5berrAk9Dv5RVw,2346
-ex4nicegui/reactive/officials/echarts.py,sha256=xRBKVbcCUwUGA8n7bw2eJj9FBQIayL4t_rzXZrjD3Pc,10895
+ex4nicegui/reactive/officials/echarts.py,sha256=ANI74NjGFLF7LoABbc8x9L2Z5nLOguptoK4iUIoSizY,12288
 ex4nicegui/reactive/officials/element.py,sha256=-qsHcxfF3fMfU0sJlKtTksX_wYPMIPJ_AgFcZbbI754,412
 ex4nicegui/reactive/officials/expansion.py,sha256=8xwJa0SpsVhFxbYwYRZtf1ul9m4oYTjgmtrRI_lqF_0,1822
 ex4nicegui/reactive/officials/grid.py,sha256=0vLLJOe7t_b351TsYOWpnrPsWKaqV_bG_010Xp-_BfY,2012
@@ -186,7 +186,7 @@ ex4nicegui/utils/scheduler.py,sha256=1gyq7Y2BkbwmPK_Q9kpRpc1MOC9H7xcpxuix-RZhN9k
 ex4nicegui/utils/signals.py,sha256=Jz0jKFPrJIRV0Gye62Bgk2kGgod1KBvDhnF-W3lRm04,7373
 ex4nicegui/utils/types.py,sha256=pE5WOSbcTHxaAhnT24FaZEd1B2Z_lTcsd46w0OKiMyc,359
 ex4nicegui/version.py,sha256=NE7u1piESstg3xCtf5hhV4iedGs2qJQw9SiC3ZSpiio,90
-ex4nicegui-0.8.6.dist-info/LICENSE,sha256=0KDDElS2dl-HIsWvbpy8ywbLzJMBFzXLev57LnMIZXs,1094
-ex4nicegui-0.8.6.dist-info/METADATA,sha256=_cFoYls_MNIYvzX1RQEo_95byNPo0WgBbj7hKZiG3c8,46125
-ex4nicegui-0.8.6.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-ex4nicegui-0.8.6.dist-info/RECORD,,
+ex4nicegui-0.8.7.dist-info/LICENSE,sha256=0KDDElS2dl-HIsWvbpy8ywbLzJMBFzXLev57LnMIZXs,1094
+ex4nicegui-0.8.7.dist-info/METADATA,sha256=FKLsKPR5EJZnSGTitaJi8RpitJ1XbTfyosp_F8_JL3Y,46832
+ex4nicegui-0.8.7.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+ex4nicegui-0.8.7.dist-info/RECORD,,

{ex4nicegui-0.8.6.dist-info → ex4nicegui-0.8.7.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: poetry-core 2.1.1
 Root-Is-Purelib: true
 Tag: py3-none-any