ex4nicegui 0.6.6__py3-none-any.whl → 0.6.7__py3-none-any.whl

ex4nicegui/libs/gsap/gsap.mjs

@@ -0,0 +1,6 @@
+import { gsap, Power0, Power1, Power2, Power3, Power4, Linear, Quad, Cubic, Quart, Quint, Strong, Elastic, Back, SteppedEase, Bounce, Sine, Expo, Circ, TweenLite, TimelineLite, TimelineMax } from "./gsap-core.js";
+import { CSSPlugin } from "./CSSPlugin.js";
+var gsapWithCSS = gsap.registerPlugin(CSSPlugin) || gsap,
+    // to protect from tree shaking
+TweenMaxWithCSS = gsapWithCSS.core.Tween;
+export { gsapWithCSS as gsap, gsapWithCSS as default, CSSPlugin, TweenMaxWithCSS as TweenMax, TweenLite, TimelineMax, TimelineLite, Power0, Power1, Power2, Power3, Power4, Linear, Quad, Cubic, Quart, Quint, Strong, Elastic, Back, SteppedEase, Bounce, Sine, Expo, Circ };

ex4nicegui/reactive/EChartsComponent/ECharts.js

@@ -5,13 +5,23 @@ function collectMapRegisterTask() {
 
   if (typeof window.ex4ngEchartsMapTasks !== "undefined") {
 
-    for (const [mapName, src] of window.ex4ngEchartsMapTasks.entries()) {
-
+    for (const [mapName, opt] of window.ex4ngEchartsMapTasks.entries()) {
+      const { src, type: mapDataType, specialAreas } = opt;
       const registerPromise = new Promise((resolve, reject) => {
         fetch(src)
-          .then((response) => response.json())
+          .then((response) => {
+            if (mapDataType === "genJSON") {
+              return response.json();
+            }
+
+            return response.text();
+          })
           .then((data) => {
-            echarts.registerMap(mapName, data);
+            if (mapDataType === "svg") {
+              data = { svg: data }
+            }
+
+            echarts.registerMap(mapName, data, specialAreas);
             resolve();
           });
 
@@ -46,10 +56,6 @@ export default {
   async mounted() {
     await this.$nextTick(); // wait for Tailwind classes to be applied
 
-    if (hasMapOrGeo(this.options)) {
-      await Promise.all(Array.from(mapRegisterTasks.values()));
-    }
-
     this.chart = echarts.init(this.$el, this.theme);
 
     this.resizeObs = new ResizeObserver(this.chart.resize)
@@ -63,10 +69,14 @@ export default {
     this.chart.on("finished", createResizeObserver);
 
     if (this.options) {
+      if (hasMapOrGeo(this.options)) {
+        await Promise.all(Array.from(mapRegisterTasks.values()));
+      }
       this.update_chart();
     } else {
       const fn = new Function('return ' + this.code)()
-      fn(this.chart)
+      await Promise.all(Array.from(mapRegisterTasks.values()));
+      fn(this.chart, echarts)
       this.$emit("__update_options_from_client", this.chart.getOption())
     }
     this.chart.getZr().on("click", (e) => {

ex4nicegui/reactive/officials/aggrid.py

@@ -6,11 +6,11 @@ from typing import (
     Optional,
 )
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
     is_ref,
     ref_computed,
     to_value,
     _TMaybeRef as TMaybeRef,
+    TGetterOrReadonlyRef,
 )
 from ex4nicegui.utils.apiEffect import ui_effect
 from nicegui import ui
@@ -78,13 +78,13 @@ class AggridBindableUi(BindableUi[ui.aggrid]):
         options = {"columnDefs": columnDefs, "rowData": rowData}
         return cls(options, **org_kws)
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef[Any]):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef[Any]):
         if prop == "options":
             return self.bind_options(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_options(self, ref_ui: ReadonlyRef[List[Dict]]):
+    def bind_options(self, ref_ui: TGetterOrReadonlyRef[List[Dict]]):
         @ui_effect
         def _():
             ele = self.element

ex4nicegui/reactive/officials/base.py

@@ -128,6 +128,16 @@ class BindableUi(Generic[TWidget]):
         return self.element.remove(element)
 
     def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef[Any]):
+        """data binding is manipulating an element's property
+
+        @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#bind_prop
+        @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#bind_prop
+
+        Args:
+            prop (str): property name
+            ref_ui (TGetterOrReadonlyRef[Any]): a reference to the value to bind to
+
+        """
         if prop == "visible":
             return self.bind_visible(ref_ui)
 

ex4nicegui/reactive/officials/button.py

@@ -5,7 +5,7 @@ from typing import (
 )
 from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -33,7 +33,7 @@ class ButtonBindableUi(BindableUi[ui.button], DisableableMixin):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "text":
             return self.bind_text(ref_ui)
         if prop == "icon":
@@ -41,7 +41,7 @@ class ButtonBindableUi(BindableUi[ui.button], DisableableMixin):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_text(self, ref_ui: ReadonlyRef):
+    def bind_text(self, ref_ui: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
             ele = self.element
@@ -50,7 +50,7 @@ class ButtonBindableUi(BindableUi[ui.button], DisableableMixin):
 
         return self
 
-    def bind_icon(self, ref_ui: ReadonlyRef):
+    def bind_icon(self, ref_ui: TGetterOrReadonlyRef[str]):
         @self._ui_effect
         def _():
             ele = self.element

ex4nicegui/reactive/officials/checkbox.py

@@ -7,7 +7,7 @@ from typing import (
 from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -44,13 +44,13 @@ class CheckboxBindableUi(BindableUi[ui.checkbox], DisableableMixin):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[bool]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[bool]):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/circular_progress.py

@@ -5,7 +5,7 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -50,13 +50,13 @@ class CircularProgressBindableUi(
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[float]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/color_picker.py

@@ -8,7 +8,7 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     Ref,
     _TMaybeRef as TMaybeRef,
     is_setter_ref,
@@ -69,20 +69,20 @@ class ColorPickerBindableUi(BindableUi[ui.color_picker]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_color(self, ref_ui: ReadonlyRef[str]):
+    def bind_color(self, ref_ui: TGetterOrReadonlyRef[str]):
         @ui_effect
         def _():
             self.element.set_color(to_value(ref_ui))
 
         return self
 
-    def bind_value(self, ref_ui: ReadonlyRef[bool]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[bool]):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/column.py

@@ -3,6 +3,7 @@ from typing import (
 )
 from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.signals import (
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
 )
 from nicegui import ui
@@ -19,13 +20,13 @@ 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: TMaybeRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "wrap":
             return self.bind_wrap(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_wrap(self, ref_ui: TMaybeRef):
+    def bind_wrap(self, ref_ui: TGetterOrReadonlyRef):
         self.bind_classes({"wrap": ref_ui})
 
     def __enter__(self):

ex4nicegui/reactive/officials/date.py

@@ -4,7 +4,7 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -45,13 +45,8 @@ class DateBindableUi(BindableUi[ui.date]):
         pc = ParameterClassifier(
             locals(),
             maybeRefs=[
-                "label",
                 "value",
-                "placeholder",
-                "password",
-                "password_toggle_button",
-                "autocomplete",
-                "validation",
+                "mask",
             ],
             v_model=("value", "on_change"),
             events=["on_change"],
@@ -68,13 +63,13 @@ class DateBindableUi(BindableUi[ui.date]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[bool]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[bool]):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/echarts.py

@@ -1,8 +1,8 @@
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Union, cast, Optional
+from typing import Any, Callable, Dict, List, Union, cast, Optional, Literal
 from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     is_ref,
     ref_computed,
     _TMaybeRef as TMaybeRef,
@@ -17,6 +17,7 @@ from ex4nicegui.reactive.EChartsComponent.events import EChartsMouseEventArgumen
 
 from nicegui.awaitable_response import AwaitableResponse
 from nicegui import ui, app
+import orjson as json
 
 
 class EChartsBindableUi(BindableUi[echarts]):
@@ -46,7 +47,14 @@ class EChartsBindableUi(BindableUi[echarts]):
             self.bind_prop(key, value)  # type: ignore
 
     @classmethod
-    def register_map(cls, map_name: str, src: Union[str, Path]):
+    def register_map(
+        cls,
+        map_name: str,
+        src: Union[str, Path],
+        *,
+        type: Literal["geoJSON", "svg"] = "geoJSON",
+        special_areas: Optional[Dict[str, Any]] = None,
+    ):
         """Registers available maps. This can only be used after including geo component or chart series of map.
 
         @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#rxuiechartsregister_map
@@ -55,6 +63,8 @@ class EChartsBindableUi(BindableUi[echarts]):
         Args:
             map_name (str): Map name, referring to map value set in geo component or map.
             src (Union[str, Path]): Map data. If str, it should be a network address. If path, it should be a valid file.
+            type (Literal["geoJSON", "svg"], optional): Map data type. Defaults to "geoJSON".
+            special_areas (Optional[Dict[str, Any]], optional): Special areas. Defaults to None.
         """
         if isinstance(src, Path):
             src = app.add_static_file(local_file=src)
@@ -63,13 +73,21 @@ class EChartsBindableUi(BindableUi[echarts]):
 
         ui.add_body_html(
             rf"""
-            <script>
-                if (typeof window.ex4ngEchartsMapTasks === "undefined") {{ 
-                    window.ex4ngEchartsMapTasks = new Map();
-                }}
-
-                window.ex4ngEchartsMapTasks.set('{map_name}', '{src}');
-            </script>
+<script>
+    (function () {{
+        if (typeof window.ex4ngEchartsMapTasks === "undefined") {{
+            window.ex4ngEchartsMapTasks = new Map();
+        }}
+
+        const value = {{
+            src: '{src}',
+            type: '{type}',
+            specialAreas: {json.dumps(special_areas).decode('utf-8')}
+        }}
+
+        window.ex4ngEchartsMapTasks.set('{map_name}', value);
+    }})()
+</script>
         """
         )
 
@@ -116,13 +134,13 @@ class EChartsBindableUi(BindableUi[echarts]):
             code = code.read_text("utf8")
         return cls(code=code)
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "options":
             return self.bind_options(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_options(self, ref_ui: ReadonlyRef[Dict]):
+    def bind_options(self, ref_ui: TGetterOrReadonlyRef[Dict]):
         @on(ref_ui)
         def _():
             ele = self.element

ex4nicegui/reactive/officials/expansion.py

@@ -3,6 +3,7 @@ from nicegui import ui
 from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 from ex4nicegui.utils.signals import (
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -45,13 +46,13 @@ class ExpansionBindableUi(BindableUi[ui.expansion]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TMaybeRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: TMaybeRef):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/icon.py

@@ -6,7 +6,7 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -35,7 +35,7 @@ class IconBindableUi(BindableUi[ui.icon]):
         for key, value in pc.get_bindings().items():
             self.bind_prop(key, value)  # type: ignore
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "name":
             return self.bind_name(ref_ui)
 
@@ -44,10 +44,10 @@ class IconBindableUi(BindableUi[ui.icon]):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_color(self, ref_ui: ReadonlyRef):
+    def bind_color(self, ref_ui: TGetterOrReadonlyRef):
         return _bind_color(self, ref_ui)
 
-    def bind_name(self, ref_ui: ReadonlyRef):
+    def bind_name(self, ref_ui: TGetterOrReadonlyRef):
         @ui_effect
         def _():
             ele = cast(TextColorElement, self.element)

ex4nicegui/reactive/officials/image.py

@@ -6,7 +6,7 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -27,13 +27,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: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "source":
             return self.bind_source(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_source(self, ref_ui: ReadonlyRef[Union[str, Path]]):
+    def bind_source(self, ref_ui: TGetterOrReadonlyRef[Union[str, Path]]):
         @ui_effect
         def _():
             self.element.set_source(to_value(ref_ui))

ex4nicegui/reactive/officials/input.py

@@ -3,7 +3,7 @@ from ex4nicegui.utils.apiEffect import ui_effect
 
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     Ref,
     _TMaybeRef as TMaybeRef,
     effect,
@@ -53,7 +53,7 @@ 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: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
         if prop == "password":
@@ -61,7 +61,7 @@ class InputBindableUi(BindableUi[ui.input], DisableableMixin):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[str]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[str]):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))
@@ -69,7 +69,7 @@ class InputBindableUi(BindableUi[ui.input], DisableableMixin):
 
         return self
 
-    def bind_password(self, ref_ui: ReadonlyRef[bool]):
+    def bind_password(self, ref_ui: TGetterOrReadonlyRef[bool]):
         @ui_effect
         def _():
             self.element._props["type"] = "password" if to_value(ref_ui) else "text"

ex4nicegui/reactive/officials/knob.py

@@ -7,9 +7,9 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
+    TGetterOrReadonlyRef,
 )
 from nicegui import ui
 from .base import BindableUi, DisableableMixin
@@ -61,13 +61,13 @@ class KnobBindableUi(
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[float]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/label.py

@@ -1,6 +1,7 @@
 from typing import Any
 from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.signals import (
+    TGetterOrReadonlyRef,
     to_value,
     _TMaybeRef as TMaybeRef,
 )
@@ -25,7 +26,7 @@ class LabelBindableUi(BindableUi[ui.label]):
     def text(self):
         return self.element.text
 
-    def bind_prop(self, prop: str, ref_ui: TMaybeRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "text":
             return self.bind_text(ref_ui)
 
@@ -34,7 +35,7 @@ class LabelBindableUi(BindableUi[ui.label]):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_color(self, ref_ui: TMaybeRef):
+    def bind_color(self, ref_ui: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
             ele = self.element
@@ -42,7 +43,7 @@ class LabelBindableUi(BindableUi[ui.label]):
             ele._style["color"] = color
             ele.update()
 
-    def bind_text(self, ref_ui: TMaybeRef):
+    def bind_text(self, ref_ui: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
             self.element.set_text(str(to_value(ref_ui)))

ex4nicegui/reactive/officials/linear_progress.py

@@ -5,7 +5,7 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -47,7 +47,7 @@ class LinearProgressBindableUi(BindableUi[ui.linear_progress]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
@@ -56,10 +56,10 @@ class LinearProgressBindableUi(BindableUi[ui.linear_progress]):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_color(self, ref_ui: ReadonlyRef):
+    def bind_color(self, ref_ui: TGetterOrReadonlyRef):
         return _bind_color(self, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/number.py

@@ -10,9 +10,10 @@ from ex4nicegui.reactive.utils import ParameterClassifier
 from ex4nicegui.utils.apiEffect import ui_effect
 
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
+    on,
 )
 from nicegui import ui
 from .base import BindableUi
@@ -20,6 +21,10 @@ from .base import BindableUi
 T = TypeVar("T")
 
 
+def _default_vmodel_args_getter(e):
+    return e.sender.value
+
+
 class NumberBindableUi(BindableUi[ui.number]):
     def __init__(
         self,
@@ -29,6 +34,7 @@ class NumberBindableUi(BindableUi[ui.number]):
         value: Optional[Union[TMaybeRef[float], TMaybeRef[int]]] = None,
         min: Optional[TMaybeRef[float]] = None,
         max: Optional[TMaybeRef[float]] = None,
+        precision: Optional[TMaybeRef[int]] = None,
         step: Optional[TMaybeRef[float]] = None,
         prefix: Optional[TMaybeRef[str]] = None,
         suffix: Optional[TMaybeRef[str]] = None,
@@ -44,6 +50,7 @@ class NumberBindableUi(BindableUi[ui.number]):
                 "value",
                 "min",
                 "max",
+                "precision",
                 "step",
                 "prefix",
                 "suffix",
@@ -52,10 +59,10 @@ class NumberBindableUi(BindableUi[ui.number]):
             ],
             v_model=("value", "on_change"),
             events=["on_change"],
+            v_model_arg_getter=_default_vmodel_args_getter,
         )
 
         value_kws = pc.get_values_kws()
-
         element = ui.number(**value_kws)
         super().__init__(element)  # type: ignore
 
@@ -66,15 +73,26 @@ class NumberBindableUi(BindableUi[ui.number]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
+        if prop == "precision":
+            return self._bind_precision(ref_ui)
+
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[float]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
         @ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))
 
         return self
+
+    def _bind_precision(self, ref_ui: TGetterOrReadonlyRef[int]):
+        @on(ref_ui, onchanges=True)
+        def _():
+            self.element.precision = to_value(ref_ui)
+            self.element.sanitize()
+
+        return self