ex4nicegui 0.4.6__py3-none-any.whl → 0.4.7__py3-none-any.whl

ex4nicegui/__init__.py

@@ -19,4 +19,4 @@ from ex4nicegui.experimental_ import (
 )
 
 
-__version__ = "0.4.6"
+__version__ = "0.4.7"

ex4nicegui/bi/index.py

@@ -10,7 +10,7 @@ _TData = TypeVar("_TData")
 def data_source(data: Union[Callable[..., _TData], _TData]) -> DataSourceFacade[_TData]:
     """Create a data source
 
-    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/docs/apis/README.en.md#bidata_source
+    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#bidata_source
     @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#bidata_source
 
     Args:

ex4nicegui/reactive/officials/base.py

@@ -3,12 +3,13 @@ from __future__ import annotations
 from typing import (
     Any,
     Callable,
+    Dict,
     List,
     Optional,
     TypeVar,
     Generic,
+    Union,
     cast,
-    overload,
 )
 from typing_extensions import Self
 from ex4nicegui.utils.signals import (
@@ -18,6 +19,10 @@ from ex4nicegui.utils.signals import (
     ref_computed,
     _TMaybeRef as TMaybeRef,
     effect,
+    to_value,
+    is_ref,
+    on,
+    signe_utils,
 )
 from nicegui import Tailwind, ui
 from nicegui.elements.mixins.color_elements import (
@@ -26,11 +31,22 @@ from nicegui.elements.mixins.color_elements import (
     TAILWIND_COLORS,
 )
 from nicegui.elements.mixins.text_element import TextElement
+from nicegui.elements.mixins.disableable_element import DisableableElement
+
 
 T = TypeVar("T")
 
 TWidget = TypeVar("TWidget", bound=ui.element)
 
+_T_bind_classes_type_dict = Dict[str, TMaybeRef[bool]]
+_T_bind_classes_type_ref_dict = ReadonlyRef[Dict[str, bool]]
+_T_bind_classes_type_array = List[Union[ReadonlyRef[str], Ref[str]]]
+
+
+_T_bind_classes_type = Union[
+    _T_bind_classes_type_dict, _T_bind_classes_type_ref_dict, _T_bind_classes_type_array
+]
+
 
 class BindableUi(Generic[TWidget]):
     def __init__(self, element: TWidget) -> None:
@@ -144,6 +160,68 @@ class BindableUi(Generic[TWidget]):
     def clear(self) -> None:
         cast(ui.element, self.element).clear()
 
+    def bind_classes(self, classes: _T_bind_classes_type):
+        """data binding is manipulating an element's class list
+
+        @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#bind-class-names
+        @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#%E7%BB%91%E5%AE%9A%E7%B1%BB%E5%90%8D
+
+        Args:
+            classes (_T_bind_classes_type):
+        """
+        if isinstance(classes, dict):
+            for name, ref_obj in classes.items():
+
+                @effect
+                def _(name=name, ref_obj=ref_obj):
+                    if to_value(ref_obj):
+                        self.classes(add=name)
+                    else:
+                        self.classes(remove=name)
+
+        elif isinstance(classes, (Ref, ReadonlyRef)):
+            ref_obj = to_value(classes)
+            assert isinstance(ref_obj, dict)
+
+            @effect
+            def _():
+                for name, value in to_value(classes).items():
+                    if value:
+                        self.classes(add=name)
+                    else:
+                        self.classes(remove=name)
+        elif isinstance(classes, list):
+            for ref_name in classes:
+                if is_ref(ref_name):
+
+                    @on(ref_name)
+                    def _(state: signe_utils.WatchedState):
+                        self.classes(add=state.current, remove=state.previous)
+                else:
+                    self.classes(ref_name)  # type: ignore
+
+        return self
+
+    def bind_style(self, style: Dict[str, Union[ReadonlyRef[str], Ref[str]]]):
+        """data binding is manipulating an element's style
+
+        @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#bind-style
+        @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#bind-style
+
+        Args:
+            style (Dict[str, Union[ReadonlyRef[str], Ref[str]]]): _description_
+        """
+        if isinstance(style, dict):
+            for name, ref_obj in style.items():
+                if is_ref(ref_obj):
+
+                    @effect
+                    def _(name=name, ref_obj=ref_obj):
+                        self.element._style[name] = ref_obj.value
+                        self.element.update()
+
+        return self
+
 
 class SingleValueBindableUi(BindableUi[TWidget], Generic[T, TWidget]):
     def __init__(self, value: TMaybeRef[T], element: TWidget) -> None:
@@ -162,9 +240,6 @@ class SingleValueBindableUi(BindableUi[TWidget], Generic[T, TWidget]):
         return self
 
 
-from nicegui.elements.mixins.disableable_element import DisableableElement
-
-
 _T_DisableableBinder = TypeVar("_T_DisableableBinder", bound=DisableableElement)
 
 

ex4nicegui/utils/signals.py

@@ -96,7 +96,7 @@ def to_value(maybe_ref: _TMaybeRef[T]) -> T:
 def to_ref(maybe_ref: _TMaybeRef[T]):
     """Takes an inner value and returns a reactive and mutable ref object, which has a single property .value that points to the inner value.
 
-    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/docs/apis/README.en.md#to_ref
+    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#to_ref
     @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#to_ref
 
 
@@ -141,7 +141,7 @@ def effect(
 ) -> signe_utils._TEffect_Fn[None]:
     """Runs a function immediately while reactively tracking its dependencies and re-runs it whenever the dependencies are changed.
 
-    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/docs/apis/README.en.md#effect
+    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#effect
     @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#effect
 
 
@@ -192,7 +192,7 @@ def ref_computed(
 ) -> ReadonlyRef[T]:
     """Takes a getter function and returns a readonly reactive ref object for the returned value from the getter. It can also take an object with get and set functions to create a writable ref object.
 
-    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/docs/apis/README.en.md#ref_computed
+    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#ref_computed
     @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#ref_computed
 
 
@@ -291,7 +291,7 @@ def on(
 ):
     """Watches one or more reactive data sources and invokes a callback function when the sources change.
 
-    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/docs/apis/README.en.md#on
+    @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#on
     @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#on
 
 

{ex4nicegui-0.4.6.dist-info → ex4nicegui-0.4.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ex4nicegui
-Version: 0.4.6
+Version: 0.4.7
 Summary: ...
 Home-page: 
 Author: carson_jia
@@ -13,7 +13,7 @@ Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3.8
 Requires-Python: >=3.8
 License-File: LICENSE
-Requires-Dist: signe (>=0.2.5)
+Requires-Dist: signe (>=0.2.6)
 Requires-Dist: nicegui (>=1.4.0)
 Requires-Dist: typing-extensions
 

{ex4nicegui-0.4.6.dist-info → ex4nicegui-0.4.7.dist-info}/RECORD

@@ -1,8 +1,8 @@
-ex4nicegui/__init__.py,sha256=FMWX8J1VTa_sX2E6rwemvu6ZmfTgTNyxrywuqx-VugY,425
+ex4nicegui/__init__.py,sha256=bZbEF9bSM74gyuksehaPjdaUWmQSf6sV83wFF7YHu5w,425
 ex4nicegui/bi/__init__.py,sha256=eu-2CuzzrcHCyKQOfoo87v6C9nSwFDdeLhjY0cRV13M,315
 ex4nicegui/bi/dataSource.py,sha256=sQzuQvNWBf20n9cz--1OX5gxT6RUAhwrq_xTQEpSa0o,7691
 ex4nicegui/bi/dataSourceFacade.py,sha256=W2i3gacEJhzClyRWuPSm9O4K-x---257vY9eO92gUyU,8757
-ex4nicegui/bi/index.py,sha256=b9QM0YR2jYOHygWdjNT1aghnmoaRdtVZbaQaq5JGbVE,2072
+ex4nicegui/bi/index.py,sha256=ZuwFxUD1KcxBpKvTLO7CGQQ5gN7FDpaHo9tfAS3UpQ4,2067
 ex4nicegui/bi/protocols.py,sha256=EWODxokdWI1BtAgFm3iWVVRAgOlMEoXTmfT4g24HPU4,4566
 ex4nicegui/bi/types.py,sha256=9aX-ChGUi6HVKNdFeBnSxW2j2D98wF-WSoD6RFv8778,389
 ex4nicegui/bi/elements/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -63,7 +63,7 @@ ex4nicegui/reactive/mermaid/mermaid.js,sha256=Ds5VevGWZE1_N0WKf-uITd8xSCO9gQzVUs
 ex4nicegui/reactive/mermaid/mermaid.py,sha256=6bJHK0hjkHKlGZRi994jj3az7Ym30vmyCelYCE2E5TI,2058
 ex4nicegui/reactive/officials/__init__.py,sha256=8xPx079EFXpEWtEc1vCbgQJt1TRZuRf91YOaqhkyRIo,1527
 ex4nicegui/reactive/officials/aggrid.py,sha256=-qWUyZjJMHic2ogoA3bk0hnusZEkvN3qDya0tu75PgE,2757
-ex4nicegui/reactive/officials/base.py,sha256=g2xWcsmmRcmE3mewSExjQ3TE9zHfIpP0AGOeXpp7Zpc,5645
+ex4nicegui/reactive/officials/base.py,sha256=gTddy6SjoyueztAsXoHCWXLDnsoE6Uq9AyISHpRnv50,8378
 ex4nicegui/reactive/officials/button.py,sha256=wWupfLQHcDMobPZgKs73yxXoHUaE0YWwjWyidQVmWr0,1951
 ex4nicegui/reactive/officials/card.py,sha256=8-tBwm3xfVybolQ87i8lAYUpBV6FdaVdeSH6xu0736U,1275
 ex4nicegui/reactive/officials/checkbox.py,sha256=i7IhJJLHAuEPxv55kQmeJTwXWtV7vlUj1KTT1rkYL3Q,1855
@@ -97,9 +97,9 @@ ex4nicegui/tools/debug.py,sha256=HCKlVzhHx5av-983ADgwgMkScKwTreSluLA7uikGYa0,488
 ex4nicegui/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ex4nicegui/utils/clientScope.py,sha256=gciC34QDwHlhln8dkS5IJS0YnzHE8grJRp1uFlqlLVA,1143
 ex4nicegui/utils/common.py,sha256=7P0vboDadLun6EMxNi3br9rKJgKt0QT4sy_66cHEwb4,994
-ex4nicegui/utils/signals.py,sha256=hzDsNjJaD_vcaCy3HqjA-StIWkxydSzZGw8AFqBbs2g,9610
-ex4nicegui-0.4.6.dist-info/LICENSE,sha256=0KDDElS2dl-HIsWvbpy8ywbLzJMBFzXLev57LnMIZXs,1094
-ex4nicegui-0.4.6.dist-info/METADATA,sha256=WP89OdOr_r1IYiBTQN1tCSqL4NRa2SMlor-mW876ooI,532
-ex4nicegui-0.4.6.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-ex4nicegui-0.4.6.dist-info/top_level.txt,sha256=VFwMiO9AFjj5rfLMJwN1ipLRASk9fJXB8tM6DNrpvPQ,11
-ex4nicegui-0.4.6.dist-info/RECORD,,
+ex4nicegui/utils/signals.py,sha256=QVmrtFxIFVV_EXXn8tXZz8AAvgAwhO2cWLdvFfVHVWI,9590
+ex4nicegui-0.4.7.dist-info/LICENSE,sha256=0KDDElS2dl-HIsWvbpy8ywbLzJMBFzXLev57LnMIZXs,1094
+ex4nicegui-0.4.7.dist-info/METADATA,sha256=hby2SsODlZpRRT3H7KAEO8-nRz7t3c6dVZ5_p6DnM74,532
+ex4nicegui-0.4.7.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+ex4nicegui-0.4.7.dist-info/top_level.txt,sha256=VFwMiO9AFjj5rfLMJwN1ipLRASk9fJXB8tM6DNrpvPQ,11
+ex4nicegui-0.4.7.dist-info/RECORD,,