ex4nicegui 0.6.7__tar.gz → 0.6.9__tar.gz

{ex4nicegui-0.6.7 → ex4nicegui-0.6.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ex4nicegui
-Version: 0.6.7
+Version: 0.6.9
 Summary: Extension library based on nicegui, providing data responsive,BI functionality modules
 Home-page: https://github.com/CrystalWindSnake/ex4nicegui
 License: MIT
@@ -604,7 +604,7 @@ rxui.label("bind to ref_computed").bind_classes(
 
 ---
 
-绑定为列表
+绑定为列表或单个字符串的响应式变量
 
 ```python
 bg_color = to_ref("red")
@@ -617,10 +617,11 @@ rxui.select(["red", "green", "yellow"], label="bg color", value=bg_color)
 rxui.select(["red", "green", "yellow"], label="text color", value=text_color)
 
 rxui.label("binding to arrays").bind_classes([bg_color_class, text_color_class])
-
+rxui.label("binding to single string").bind_classes(bg_color_class)
 ```
 
-列表中每个元素为返回类名的响应式变量
+- 列表中每个元素为返回类名的响应式变量
+
 
 ---
 
@@ -887,6 +888,62 @@ rxui.radio(names, value=current_tab).props("inline")
 
 rxui.label(lambda: f"当前 tab 为:{current_tab.value}")
 ```
+---
+
+### lazy_tab_panels
+
+懒加载模式下，只有当前激活的 tab 才会渲染。
+```python
+from ex4nicegui import to_ref, rxui, on, deep_ref
+
+current_tab = to_ref("t1")
+
+with rxui.tabs(current_tab):
+    ui.tab("t1")
+    ui.tab("t2")
+
+with rxui.lazy_tab_panels(current_tab) as panels:
+
+    @panels.add_tab_panel("t1")
+    def _():
+        ui.notify("Hello from t1")
+
+    @panels.add_tab_panel("t2")
+    def _():
+        ui.notify("Hello from t2")
+
+```
+
+页面加载后，立刻显示 "Hello from t1"。当切换到 "t2" 页签，才会显示 "Hello from t2"。
+
+---
+
+### scoped_style
+
+`scoped_style` 方法允许你创建限定在组件内部的样式。
+
+```python
+# 所有子元素都会有红色轮廓，但排除自身
+with rxui.row().scoped_style("*", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+
+
+# 所有子元素都会有红色轮廓，包括自身
+with rxui.row().scoped_style(":self *", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+
+# 当鼠标悬停在 row 组件时,所有子元素都会有红色轮廓，但排除自身
+with rxui.row().scoped_style(":hover *", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+
+# 当鼠标悬停在 row 组件时,所有子元素都会有红色轮廓，包括自身
+with rxui.row().scoped_style(":self:hover *", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+```
 
 
 ---

{ex4nicegui-0.6.7 → ex4nicegui-0.6.9}/README.md

@@ -581,7 +581,7 @@ rxui.label("bind to ref_computed").bind_classes(
 
 ---
 
-绑定为列表
+绑定为列表或单个字符串的响应式变量
 
 ```python
 bg_color = to_ref("red")
@@ -594,10 +594,11 @@ rxui.select(["red", "green", "yellow"], label="bg color", value=bg_color)
 rxui.select(["red", "green", "yellow"], label="text color", value=text_color)
 
 rxui.label("binding to arrays").bind_classes([bg_color_class, text_color_class])
-
+rxui.label("binding to single string").bind_classes(bg_color_class)
 ```
 
-列表中每个元素为返回类名的响应式变量
+- 列表中每个元素为返回类名的响应式变量
+
 
 ---
 
@@ -864,6 +865,62 @@ rxui.radio(names, value=current_tab).props("inline")
 
 rxui.label(lambda: f"当前 tab 为:{current_tab.value}")
 ```
+---
+
+### lazy_tab_panels
+
+懒加载模式下，只有当前激活的 tab 才会渲染。
+```python
+from ex4nicegui import to_ref, rxui, on, deep_ref
+
+current_tab = to_ref("t1")
+
+with rxui.tabs(current_tab):
+    ui.tab("t1")
+    ui.tab("t2")
+
+with rxui.lazy_tab_panels(current_tab) as panels:
+
+    @panels.add_tab_panel("t1")
+    def _():
+        ui.notify("Hello from t1")
+
+    @panels.add_tab_panel("t2")
+    def _():
+        ui.notify("Hello from t2")
+
+```
+
+页面加载后，立刻显示 "Hello from t1"。当切换到 "t2" 页签，才会显示 "Hello from t2"。
+
+---
+
+### scoped_style
+
+`scoped_style` 方法允许你创建限定在组件内部的样式。
+
+```python
+# 所有子元素都会有红色轮廓，但排除自身
+with rxui.row().scoped_style("*", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+
+
+# 所有子元素都会有红色轮廓，包括自身
+with rxui.row().scoped_style(":self *", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+
+# 当鼠标悬停在 row 组件时,所有子元素都会有红色轮廓，但排除自身
+with rxui.row().scoped_style(":hover *", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+
+# 当鼠标悬停在 row 组件时,所有子元素都会有红色轮廓，包括自身
+with rxui.row().scoped_style(":self:hover *", "outline: 1px solid red;") as row:
+    ui.label("Hello")
+    ui.label("World")
+```
 
 
 ---

{ex4nicegui-0.6.7 → ex4nicegui-0.6.9}/ex4nicegui/__init__.py

@@ -1,6 +1,13 @@
 from ex4nicegui import reactive as rxui
+from ex4nicegui.utils.refComputed import ref_computed
+from ex4nicegui.utils.types import (
+    _TMaybeRef as TMaybeRef,
+    Ref,
+    ReadonlyRef,
+    TGetterOrReadonlyRef,
+)
+from ex4nicegui.utils.scheduler import next_tick
 from ex4nicegui.utils.signals import (
-    ref_computed,
     effect,
     effect_refreshable,
     to_raw,
@@ -10,9 +17,6 @@ from ex4nicegui.utils.signals import (
     ref,
     on,
     event_batch,
-    _TMaybeRef as TMaybeRef,
-    Ref,
-    ReadonlyRef,
     reactive,
     deep_ref,
     is_setter_ref,
@@ -21,6 +25,7 @@ from ex4nicegui.utils.signals import (
 )
 from ex4nicegui.utils.asyncComputed import async_computed
 from ex4nicegui.utils.clientScope import new_scope
+from .version import __version__
 
 __all__ = [
     "async_computed",
@@ -36,6 +41,7 @@ __all__ = [
     "on",
     "event_batch",
     "TMaybeRef",
+    "TGetterOrReadonlyRef",
     "Ref",
     "ReadonlyRef",
     "reactive",
@@ -44,6 +50,6 @@ __all__ = [
     "to_raw",
     "is_setter_ref",
     "new_scope",
+    "next_tick",
+    "__version__",
 ]
-
-__version__ = "0.6.6"

ex4nicegui-0.6.9/ex4nicegui/gsap/__init__.py

@@ -0,0 +1,23 @@
+from .gsap import set_defaults, from_, to, new, run_script
+from .timeline import Timeline as timeline
+
+
+import warnings
+
+RED = "\033[91m"
+RESET = "\033[0m"
+
+warnings.warn(
+    f"{RED}The gsap module is deprecated and will be removed in the next major version.{RESET}",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+__all__ = [
+    "set_defaults",
+    "from_",
+    "to",
+    "new",
+    "run_script",
+    "timeline",
+]

ex4nicegui-0.6.9/ex4nicegui/helper/__init__.py

@@ -0,0 +1,4 @@
+from .client_instance_locker import ClientInstanceLocker
+
+
+__all__ = ["ClientInstanceLocker"]

ex4nicegui-0.6.9/ex4nicegui/helper/client_instance_locker.py

@@ -0,0 +1,31 @@
+from typing import Callable, Optional, TypeVar, Generic
+from nicegui import ui, Client
+from weakref import WeakKeyDictionary
+
+
+_T = TypeVar("_T")
+
+
+class ClientInstanceLocker(Generic[_T]):
+    def __init__(self, factory: Callable[[], _T]):
+        """Creates a new instance locker that creates a new instance for each client.
+
+        Args:
+            factory (Callable[[], _T]):  A factory function that creates a new instance.
+        """
+        self._client_instances: WeakKeyDictionary[Client, _T] = WeakKeyDictionary()
+        self._factory = factory
+
+    def get_object(self, client: Optional[Client] = None):
+        if not ui.context.slot_stack:
+            return None
+
+        client = client or ui.context.client
+        if client not in self._client_instances:
+            self._client_instances[client] = self._factory()
+
+            @client.on_disconnect
+            def _():
+                self._client_instances.pop(client, None)
+
+        return self._client_instances[client]

{ex4nicegui-0.6.7 → ex4nicegui-0.6.9}/ex4nicegui/reactive/__init__.py

@@ -51,7 +51,9 @@ from .officials.tab import TabBindableUi as tab
 from .officials.tab_panels import TabPanelsBindableUi as tab_panels
 from .officials.tab_panel import TabPanelBindableUi as tab_panel
 from .officials.element import ElementBindableUi as element
+from .officials.tab_panels import LazyTabPanelsBindableUi as lazy_tab_panels
 from .q_pagination import PaginationBindableUi as q_pagination
+from .officials.chip import ChipBindableUi as chip
 
 from .local_file_picker import local_file_picker
 from .UseDraggable.UseDraggable import use_draggable
@@ -70,6 +72,7 @@ pagination = q_pagination
 __all__ = [
     "element",
     "tab_panels",
+    "lazy_tab_panels",
     "tab_panel",
     "tabs",
     "tab",
@@ -120,4 +123,5 @@ __all__ = [
     "q_pagination",
     "pagination",
     "mermaid",
+    "chip",
 ]