ex4nicegui 0.6.9__py3-none-any.whl → 0.7.0__py3-none-any.whl

ex4nicegui/reactive/officials/color_picker.py

@@ -68,23 +68,23 @@ class ColorPickerBindableUi(BindableUi[ui.color_picker]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_color(self, ref_ui: TGetterOrReadonlyRef[str]):
+    def bind_color(self, color: TGetterOrReadonlyRef[str]):
         @self._ui_effect
         def _():
-            self.element.set_color(to_value(ref_ui))
+            self.element.set_color(to_value(color))
 
         return self
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef[bool]):
+    def bind_value(self, value: TGetterOrReadonlyRef[bool]):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
 
         return self
 

ex4nicegui/reactive/officials/column.py

@@ -20,14 +20,14 @@ class ColumnBindableUi(BindableUi[ui.column]):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "wrap":
-            return self.bind_wrap(ref_ui)
+            return self.bind_wrap(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_wrap(self, ref_ui: TGetterOrReadonlyRef):
-        self.bind_classes({"wrap": ref_ui})
+    def bind_wrap(self, value: TGetterOrReadonlyRef):
+        self.bind_classes({"wrap": value})
 
     def __enter__(self):
         self.element.__enter__()

ex4nicegui/reactive/officials/date.py

@@ -62,15 +62,15 @@ class DateBindableUi(BindableUi[ui.date]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef[bool]):
+    def bind_value(self, value: TGetterOrReadonlyRef[bool]):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
 
         return self

ex4nicegui/reactive/officials/dialog.py

@@ -0,0 +1,49 @@
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
+from ex4nicegui.utils.signals import (
+    _TMaybeRef as TMaybeRef,
+    is_setter_ref,
+    to_value,
+    TGetterOrReadonlyRef,
+)
+from nicegui import ui
+from .base import BindableUi
+
+
+class DialogBindableUi(BindableUi[ui.dialog]):
+    def __init__(
+        self,
+        *,
+        value: TMaybeRef[bool] = False,
+    ) -> None:
+        pc = ParameterClassifier(locals(), maybeRefs=["value"])
+
+        value_kws = pc.get_values_kws()
+        element = ui.dialog(**value_kws)
+        super().__init__(element)  # type: ignore
+
+        if is_setter_ref(value):
+
+            def on_value_change():
+                value.value = element.value  # type: ignore
+
+            element.on_value_change(on_value_change)
+
+        for key, value in pc.get_bindings().items():
+            self.bind_prop(key, value)  # type: ignore
+
+    @property
+    def value(self):
+        return self.element.value
+
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
+        if prop == "value":
+            return self.bind_value(value)
+
+        return super().bind_prop(prop, value)
+
+    def bind_value(self, value: TGetterOrReadonlyRef[float]):
+        @self._ui_effect
+        def _():
+            self.element.set_value(to_value(value))
+
+        return self

ex4nicegui/reactive/officials/echarts.py

@@ -119,31 +119,30 @@ class EChartsBindableUi(BindableUi[echarts]):
 
         ## Examples
 
-        ```python
-        rxui.echarts.from_javascript(
-            r'''(myChart) => {
-                option = {...};
-                myChart.setOption(option);
-            }
-        ''')
-        ```
+        .. code-block:: python
+            rxui.echarts.from_javascript(
+                r'''(myChart) => {
+                    option = {...};
+                    myChart.setOption(option);
+                }
+            ''')
 
         """
         if isinstance(code, Path):
             code = code.read_text("utf8")
         return cls(code=code)
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "options":
-            return self.bind_options(ref_ui)
+            return self.bind_options(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_options(self, ref_ui: TGetterOrReadonlyRef[Dict]):
-        @self._ui_signal_on(ref_ui)
+    def bind_options(self, options: TGetterOrReadonlyRef[Dict]):
+        @self._ui_signal_on(options)
         def _():
             ele = self.element
-            ele.update_options(to_raw(to_value(ref_ui)), self.__update_setting)
+            ele.update_options(to_raw(to_value(options)), self.__update_setting)
             ele.update()
 
         return self
@@ -171,58 +170,57 @@ class EChartsBindableUi(BindableUi[echarts]):
         ---
 
         ### click event:
-        ```python
-        bar = rxui.echarts(opts)
 
-        def on_click(e):
-            ui.notify(f"on_click:{e}")
+        .. code-block:: python
+            bar = rxui.echarts(opts)
+
+            def on_click(e):
+                ui.notify(f"on_click:{e}")
 
-        bar.on("click", on_click)
-        ```
+            bar.on("click", on_click)
 
         ---
 
         ### Use query to trigger callback of the specified component:
 
-        ```python
-        ...
-        def on_line_click(e):
-            ui.notify(e)
+        .. code-block:: python
+            ...
+            def on_line_click(e):
+                ui.notify(e)
+
+            bar.on("click", on_line_click,query='series.line')
 
-        bar.on("click", on_line_click,query='series.line')
-        ```
 
         ---
         ### only trigger for specified series
-        ```python
-
-        opts = {
-            "xAxis": {"type": "value", "boundaryGap": [0, 0.01]},
-            "yAxis": {
-                "type": "category",
-                "data": ["Brazil", "Indonesia", "USA", "India", "China", "World"],
-            },
-            "series": [
-                {
-                    "name": "first",
-                    "type": "bar",
-                    "data": [18203, 23489, 29034, 104970, 131744, 630230],
-                },
-                {
-                    "name": "second",
-                    "type": "bar",
-                    "data": [19325, 23438, 31000, 121594, 134141, 681807],
+
+        .. code-block:: python
+            opts = {
+                "xAxis": {"type": "value", "boundaryGap": [0, 0.01]},
+                "yAxis": {
+                    "type": "category",
+                    "data": ["Brazil", "Indonesia", "USA", "India", "China", "World"],
                 },
-            ],
-        }
+                "series": [
+                    {
+                        "name": "first",
+                        "type": "bar",
+                        "data": [18203, 23489, 29034, 104970, 131744, 630230],
+                    },
+                    {
+                        "name": "second",
+                        "type": "bar",
+                        "data": [19325, 23438, 31000, 121594, 134141, 681807],
+                    },
+                ],
+            }
 
-        bar = rxui.echarts(opts)
+            bar = rxui.echarts(opts)
 
-        def on_first_series_mouseover(e):
-            ui.notify(f"on_first_series_mouseover:{e}")
+            def on_first_series_mouseover(e):
+                ui.notify(f"on_first_series_mouseover:{e}")
 
-        bar.on("mouseover", on_first_series_mouseover, query={"seriesName": "first"})
-        ```
+            bar.on("mouseover", on_first_series_mouseover, query={"seriesName": "first"})
 
         ---
         """

ex4nicegui/reactive/officials/expansion.py

@@ -45,16 +45,16 @@ class ExpansionBindableUi(BindableUi[ui.expansion]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_value(self, value: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
 
         return self
 

ex4nicegui/reactive/officials/icon.py

@@ -34,20 +34,20 @@ class IconBindableUi(BindableUi[ui.icon], TextColorableMixin):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "name":
-            return self.bind_name(ref_ui)
+            return self.bind_name(value)
 
         if prop == "color":
-            return self.bind_color(ref_ui)
+            return self.bind_color(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_name(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_name(self, name: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
             ele = cast(TextColorElement, self.element)
-            ele._props["name"] = to_value(ref_ui)
+            ele._props["name"] = to_value(name)
             ele.update()
 
         return self

ex4nicegui/reactive/officials/image.py

@@ -25,13 +25,13 @@ class ImageBindableUi(BindableUi[ui.image]):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "source":
-            return self.bind_source(ref_ui)
+            return self.bind_source(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_source(self, ref_ui: TGetterOrReadonlyRef[Union[str, Path]]):
+    def bind_source(self, source: TGetterOrReadonlyRef[Union[str, Path]]):
         @self._ui_effect
         def _():
-            self.element.set_source(to_value(ref_ui))
+            self.element.set_source(to_value(source))

ex4nicegui/reactive/officials/input.py

@@ -51,26 +51,26 @@ class InputBindableUi(BindableUi[ui.input], DisableableMixin):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
         if prop == "password":
-            return self.bind_password(ref_ui)
+            return self.bind_password(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef[str]):
+    def bind_value(self, value: TGetterOrReadonlyRef[str]):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
             self.element.update()
 
         return self
 
-    def bind_password(self, ref_ui: TGetterOrReadonlyRef[bool]):
+    def bind_password(self, password: TGetterOrReadonlyRef[bool]):
         @self._ui_effect
         def _():
-            self.element._props["type"] = "password" if to_value(ref_ui) else "text"
+            self.element._props["type"] = "password" if to_value(password) else "text"
             self.element.update()
 
         return self

ex4nicegui/reactive/officials/knob.py

@@ -61,17 +61,17 @@ class KnobBindableUi(
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
         if prop == "color":
-            return self.bind_color(ref_ui)
+            return self.bind_color(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
+    def bind_value(self, value: TGetterOrReadonlyRef[float]):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
 
         return self

ex4nicegui/reactive/officials/label.py

@@ -27,19 +27,19 @@ class LabelBindableUi(BindableUi[ui.label], HtmlTextColorableMixin):
     def text(self):
         return self.element.text
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "text":
-            return self.bind_text(ref_ui)
+            return self.bind_text(value)
 
         if prop == "color":
-            return self.bind_color(ref_ui)
+            return self.bind_color(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_text(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_text(self, text: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
-            self.element.set_text(str(to_value(ref_ui)))
+            self.element.set_text(str(to_value(text)))
             self.element.update()
 
         return self

ex4nicegui/reactive/officials/linear_progress.py

@@ -46,18 +46,18 @@ class LinearProgressBindableUi(BindableUi[ui.linear_progress], TextColorableMixi
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
         if prop == "color":
-            return self.bind_color(ref_ui)
+            return self.bind_color(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_value(self, value: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
 
         return self

ex4nicegui/reactive/officials/number.py

@@ -70,26 +70,26 @@ class NumberBindableUi(BindableUi[ui.number]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
         if prop == "precision":
-            return self._bind_precision(ref_ui)
+            return self._bind_precision(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
+    def bind_value(self, value: TGetterOrReadonlyRef[float]):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
 
         return self
 
-    def _bind_precision(self, ref_ui: TGetterOrReadonlyRef[int]):
-        @self._ui_signal_on(ref_ui, onchanges=True)
+    def _bind_precision(self, precision: TGetterOrReadonlyRef[int]):
+        @self._ui_signal_on(precision, onchanges=True)
         def _():
-            self.element.precision = to_value(ref_ui)
+            self.element.precision = to_value(precision)
             self.element.sanitize()
 
         return self

ex4nicegui/reactive/officials/radio.py

@@ -51,25 +51,25 @@ class RadioBindableUi(BindableUi[ui.radio]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
         if prop == "options":
-            return self.bind_options(ref_ui)
+            return self.bind_options(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_options(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_options(self, options: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
-            self.element.set_options(to_value(ref_ui))
+            self.element.set_options(to_value(options))
 
         return self
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_value(self, value: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
-            cast(ValueElement, self.element).set_value(to_value(ref_ui))
+            cast(ValueElement, self.element).set_value(to_value(value))
 
         return self

ex4nicegui/reactive/officials/row.py

@@ -18,14 +18,14 @@ class RowBindableUi(BindableUi[ui.row]):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
-    def bind_prop(self, prop: str, ref_ui: TMaybeRef):
+    def bind_prop(self, prop: str, value: TMaybeRef):
         if prop == "wrap":
-            return self.bind_wrap(ref_ui)
+            return self.bind_wrap(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_wrap(self, ref_ui: TMaybeRef):
-        self.bind_classes({"wrap": ref_ui})
+    def bind_wrap(self, value: TMaybeRef):
+        self.bind_classes({"wrap": value})
 
     def __enter__(self):
         self.element.__enter__()

ex4nicegui/reactive/officials/select.py

@@ -13,6 +13,7 @@ from ex4nicegui.utils.signals import (
     TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
+    to_raw,
 )
 from nicegui import ui
 from nicegui.elements.mixins.value_element import ValueElement
@@ -73,25 +74,25 @@ class SelectBindableUi(BindableUi[ui.select]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
         if prop == "options":
-            return self.bind_options(ref_ui)
+            return self.bind_options(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_options(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_options(self, options: TGetterOrReadonlyRef):
         @self._ui_effect()
         def _():
-            self.element.set_options(to_value(ref_ui))
+            self.element.set_options(to_value(options))
 
         return self
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
+    def bind_value(self, value: TGetterOrReadonlyRef):
         @self._ui_effect()
         def _():
-            cast(ValueElement, self.element).set_value(to_value(ref_ui) or None)
+            cast(ValueElement, self.element).set_value(to_raw(to_value(value)) or None)
 
         return self

ex4nicegui/reactive/officials/slider.py

@@ -58,16 +58,16 @@ class SliderBindableUi(
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
+    def bind_value(self, value: TGetterOrReadonlyRef[float]):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
             self.element.update()
 
         return self

ex4nicegui/reactive/officials/switch.py

@@ -47,15 +47,15 @@ class SwitchBindableUi(BindableUi[ui.switch]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
+    def bind_prop(self, prop: str, value: TGetterOrReadonlyRef):
         if prop == "value":
-            return self.bind_value(ref_ui)
+            return self.bind_value(value)
 
-        return super().bind_prop(prop, ref_ui)
+        return super().bind_prop(prop, value)
 
-    def bind_value(self, ref_ui: TGetterOrReadonlyRef[bool]):
+    def bind_value(self, value: TGetterOrReadonlyRef[bool]):
         @self._ui_effect
         def _():
-            self.element.set_value(to_value(ref_ui))
+            self.element.set_value(to_value(value))
 
         return self

ex4nicegui/reactive/officials/tab.py

@@ -33,12 +33,6 @@ class TabBindableUi(BindableUi[ui.tab]):
         for key, value in bindings_kws.items():
             self.bind_prop(key, value)  # type: ignore
 
-    # def bind_prop(self, prop: str, ref_ui: TMaybeRef):
-    #     if prop == "name":
-    #         return self.bind_name(ref_ui)
-
-    #     return super().bind_prop(prop, ref_ui)
-
     def __bind_label(self, binding_kws: Dict, value_kws: Dict):
         name_ref = binding_kws.get("name") or value_kws.get("name")
         label_ref = binding_kws.get("label") or value_kws.get("label")
@@ -49,9 +43,3 @@ class TabBindableUi(BindableUi[ui.tab]):
                 to_value(label_ref) if label_ref is not None else to_value(name_ref)
             )
             self.element.update()
-
-    # def bind_name(self, ref_ui: TMaybeRef):
-    #     @self._ui_effect
-    #     def _():
-    #         self.element._props["name"] = to_value(ref_ui)
-    #         self.element.update()