flet 0.82.3.dev7889__tar.gz → 0.82.3.dev7890__tar.gz

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7889
+Version: 0.82.3.dev7890
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.82.3.dev7889; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7889; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7890; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7890; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==0.82.3.dev7889; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7889; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7889; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7890; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7890; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7890; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7889; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7890; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7889; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7890; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7889; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7890; extra == "web"
 
 <p align="center">
   <a href="https://flet.dev"><img src="https://raw.githubusercontent.com/flet-dev/flet/refs/heads/main/media/logo/flet-logo.svg" height="150" alt="Flet logo"></a>

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "flet"
-version = "0.82.3.dev7889"
+version = "0.82.3.dev7890"
 description = "Flet for Python - easily build interactive multi-platform apps in Python"
 authors = [{name = "Appveyor Systems Inc.", email = "hello@flet.dev"}]
 license = "Apache-2.0"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "flet-cli==0.82.3.dev7889; extra == 'cli'",
-    "flet-web==0.82.3.dev7889; extra == 'web'",
+    "flet-cli==0.82.3.dev7890; extra == 'cli'",
+    "flet-web==0.82.3.dev7890; extra == 'web'",
     "oauthlib >=3.2.2; platform_system != 'Pyodide'",
     "httpx >=0.28.1; platform_system != 'Pyodide'",
     "repath >=0.9.0",
@@ -23,15 +23,15 @@ Documentation = "https://docs.flet.dev/"
 
 [project.optional-dependencies]
 all = [
-    "flet-cli==0.82.3.dev7889",
-    "flet-web==0.82.3.dev7889",
-    "flet-desktop==0.82.3.dev7889",
+    "flet-cli==0.82.3.dev7890",
+    "flet-web==0.82.3.dev7890",
+    "flet-desktop==0.82.3.dev7890",
 ]
-cli = ["flet-cli==0.82.3.dev7889"]
+cli = ["flet-cli==0.82.3.dev7890"]
 desktop = [
-    "flet-desktop==0.82.3.dev7889",
+    "flet-desktop==0.82.3.dev7890",
 ]
-web = ["flet-web==0.82.3.dev7889"]
+web = ["flet-web==0.82.3.dev7890"]
 
 [project.scripts]
 flet = "flet.cli:main"

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/src/flet/__init__.py

@@ -423,6 +423,8 @@ from flet.controls.ref import Ref
 from flet.controls.scrollable_control import (
     OnScrollEvent,
     ScrollableControl,
+    Scrollbar,
+    ScrollbarOrientation,
     ScrollDirection,
     ScrollType,
 )
@@ -967,6 +969,8 @@ __all__ = [
     "ScrollMode",
     "ScrollType",
     "ScrollableControl",
+    "Scrollbar",
+    "ScrollbarOrientation",
     "ScrollbarTheme",
     "SearchBar",
     "SearchBarTheme",

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/src/flet/controls/base_page.py

@@ -27,6 +27,7 @@ from flet.controls.material.floating_action_button import FloatingActionButton
 from flet.controls.material.navigation_bar import NavigationBar
 from flet.controls.material.navigation_drawer import NavigationDrawer
 from flet.controls.padding import Padding, PaddingValue
+from flet.controls.scrollable_control import Scrollbar
 from flet.controls.services.service import Service
 from flet.controls.transform import OffsetValue
 from flet.controls.types import (
@@ -702,7 +703,7 @@ class BasePage(AdaptiveControl):
 
     # scroll
     @property
-    def scroll(self) -> Optional[ScrollMode]:
+    def scroll(self) -> Optional[Union[ScrollMode, Scrollbar]]:
         """
         Scroll behavior mode for root view content.
         """
@@ -710,7 +711,7 @@ class BasePage(AdaptiveControl):
         return self.__root_view().scroll
 
     @scroll.setter
-    def scroll(self, value: Optional[ScrollMode]):
+    def scroll(self, value: Optional[Union[ScrollMode, Scrollbar]]):
         self.__root_view().scroll = value
 
     # auto_scroll

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/src/flet/controls/scrollable_control.py

@@ -13,7 +13,14 @@ from flet.controls.types import (
     ScrollMode,
 )
 
-__all__ = ["OnScrollEvent", "ScrollDirection", "ScrollType", "ScrollableControl"]
+__all__ = [
+    "OnScrollEvent",
+    "ScrollDirection",
+    "ScrollType",
+    "ScrollableControl",
+    "Scrollbar",
+    "ScrollbarOrientation",
+]
 
 
 class ScrollType(Enum):
@@ -78,6 +85,111 @@ class ScrollDirection(Enum):
     """
 
 
+class ScrollbarOrientation(Enum):
+    """
+    Defines the edge/side of the viewport where the [`Scrollbar`][flet.] is shown.
+    """
+
+    LEFT = "left"
+    """
+    Places the scrollbar on the left/leading edge of a vertical scrollable.
+    """
+
+    RIGHT = "right"
+    """
+    Places the scrollbar on the right/trailing edge of a vertical scrollable.
+    """
+
+    TOP = "top"
+    """
+    Places the scrollbar above a horizontal scrollable.
+    """
+
+    BOTTOM = "bottom"
+    """
+    Places the scrollbar below a horizontal scrollable.
+    """
+
+
+@dataclass
+class Scrollbar:
+    """
+    Configures the scrollbar that scrollable controls render for their content.
+    """
+
+    thumb_visibility: Optional[bool] = None
+    """
+    Whether this scrollbar's thumb should be always be visible, even when not being
+    scrolled. When `False`, the scrollbar will be shown during scrolling and
+    will fade out otherwise.
+
+    If `None`, then [`ScrollbarTheme.thumb_visibility`][flet.] is used.
+    If that is also `None`, defaults to `False`.
+    """
+
+    track_visibility: Optional[bool] = None
+    """
+    Indicates whether the scrollbar track should be visible,
+    so long as the [thumb][(c).thumb_visibility] is visible.
+
+    If `None`, then [`ScrollbarTheme.track_visibility`][flet.] is used.
+    If that is also `None`, defaults to `False`.
+    """
+
+    thickness: Optional[Number] = None
+    """
+    Controls the cross-axis size of the scrollbar in logical pixels.
+    The thickness of the scrollbar in the cross axis of the scrollable.
+
+    If `None`, the default value is platform dependent:
+    `4.0` pixels on Android
+    ([`Page.platform`][flet.] == [`PagePlatform.ANDROID`][flet.]) and iOS
+    ([`Page.platform`][flet.] == [`PagePlatform.IOS`][flet.]);
+    [`ScrollbarTheme.thickness`][flet.] on the remaining platforms.
+    """
+
+    radius: Optional[Number] = None
+    """
+    Circular radius of the scrollbar thumb's rounded rectangle corners in logical
+    pixels. If `None`, platform defaults are used.
+
+    The radius of the scrollbar thumb's rounded rectangle corners.
+
+    If `None`, the default value is platform dependent:
+    no radius is applied on Android
+    ([`Page.platform`][flet.] == [`PagePlatform.ANDROID`][flet.]);
+    `1.5` pixels on iOS ([`Page.platform`][flet.] == [`PagePlatform.IOS`][flet.]);
+    `8.0` pixels on the remaining platforms.
+    """
+
+    interactive: Optional[bool] = None
+    """
+    Whether this scroll bar should be interactive and respond to dragging on the
+    thumb, or tapping in the track area.
+
+    When `False`, the scrollbar will not respond to gesture or hover events, and will
+    allow to click through it.
+
+    If `None`, defaults to `True`, unless on Android, where it defaults to `False`.
+    """
+
+    orientation: Optional[ScrollbarOrientation] = None
+    """
+    Specifies where the scrollbar should appear relative to the scrollable.
+
+    If `None`, for a vertical scroll, defaults to [`ScrollbarOrientation.RIGHT`][flet.]
+    for left-to-right text direction and [`ScrollbarOrientation.LEFT`][flet.]
+    for right-to-left text direction, while for a horizontal scroll, it defaults to
+    [`ScrollbarOrientation.BOTTOM`][flet.].
+
+    Note:
+        [`ScrollbarOrientation.TOP`][flet.] and [`ScrollbarOrientation.BOTTOM`][flet.]
+        can only be used with a horizontal scroll; [`ScrollbarOrientation.LEFT`][flet.]
+        and [`ScrollbarOrientation.RIGHT`][flet.] can only be used with a vertical
+        scroll.
+    """
+
+
 @dataclass
 class OnScrollEvent(Event["ScrollableControl"]):
     """
@@ -89,6 +201,7 @@ class OnScrollEvent(Event["ScrollableControl"]):
     Logical type of the scroll notification.
 
     Determines which optional fields are populated:
+
     - [`ScrollType.UPDATE`][flet.]: [`scroll_delta`][(c).]
     - [`ScrollType.USER`][flet.]: [`direction`][(c).direction]
     - [`ScrollType.OVERSCROLL`][flet.]: [`overscroll`][(c).] and [`velocity`][(c).]
@@ -222,9 +335,12 @@ class ScrollableControl(Control):
     - imperatively changing position with [`scroll_to()`][(c).scroll_to].
     """
 
-    scroll: Optional[ScrollMode] = None
+    scroll: Optional[Union[ScrollMode, Scrollbar]] = None
     """
-    Enables a vertical scrolling for the Column to prevent its content overflow.
+    Defines the scroll bar configuration of this control.
+
+    Can be a [`Scrollbar`][flet.] instance for full control over the appearance of the
+    scrollbar, or a [`ScrollMode`][flet.] value, for ready-made scrollbar behaviors.
     """
 
     auto_scroll: bool = False

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/src/flet/controls/types.py

@@ -438,28 +438,65 @@ class TextAlign(Enum):
 
 class ScrollMode(Enum):
     """
-    Weather scrolling is enabled and visibility of scroll bar options.
+    Defines scrolling behavior and scroll bar visibility for scrollable controls.
+
+    When assigned to [`ScrollableControl.scroll`][flet.], for example, each value
+    internally maps to a specific [`Scrollbar`][flet.] configuration.
     """
 
     AUTO = "auto"
     """
     Scrolling is enabled and scroll bar is only shown when scrolling occurs.
+
+    [`Scrollbar`][flet.] equivalent:
+
+    ```python
+    ft.Scrollbar(
+        thickness=4.0 if page.platform.is_mobile() and not page.web else None,
+    )
+    ```
     """
 
     ADAPTIVE = "adaptive"
     """
     Scrolling is enabled and scroll bar is always shown when running app as web or \
     desktop.
+
+    [`Scrollbar`][flet.] equivalent:
+
+    ```python
+    ft.Scrollbar(
+        thumb_visibility=page.web or not page.platform.is_mobile(),
+        thickness=4.0 if page.platform.is_mobile() and not page.web else None,
+    )
+    ```
     """
 
     ALWAYS = "always"
     """
     Scrolling is enabled and scroll bar is always shown.
+
+    [`Scrollbar`][flet.] equivalent:
+
+    ```python
+    ft.Scrollbar(
+        thumb_visibility=True,
+        thickness=4.0 if page.platform.is_mobile() and not page.web else None,
+    )
+    ```
     """
 
     HIDDEN = "hidden"
     """
     Scrolling is enabled, but scroll bar is always hidden.
+
+    [`Scrollbar`][flet.] equivalent:
+
+    ```python
+    ft.Scrollbar(
+        thickness=0,
+    )
+    ```
     """
 
 

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/src/flet/version.py

@@ -16,7 +16,7 @@ __all__ = [
 ]
 
 # set by CI
-flet_version = "0.82.3.dev7889"
+flet_version = "0.82.3.dev7890"
 """
 The Flet version in use.
 

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/src/flet.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet
-Version: 0.82.3.dev7889
+Version: 0.82.3.dev7890
 Summary: Flet for Python - easily build interactive multi-platform apps in Python
 Author-email: "Appveyor Systems Inc." <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -9,23 +9,23 @@ Project-URL: Repository, https://github.com/flet-dev/flet
 Project-URL: Documentation, https://docs.flet.dev/
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: flet-cli==0.82.3.dev7889; extra == "cli"
-Requires-Dist: flet-web==0.82.3.dev7889; extra == "web"
+Requires-Dist: flet-cli==0.82.3.dev7890; extra == "cli"
+Requires-Dist: flet-web==0.82.3.dev7890; extra == "web"
 Requires-Dist: oauthlib>=3.2.2; platform_system != "Pyodide"
 Requires-Dist: httpx>=0.28.1; platform_system != "Pyodide"
 Requires-Dist: repath>=0.9.0
 Requires-Dist: msgpack>=1.1.0
 Requires-Dist: typing-extensions; python_version < "3.11"
 Provides-Extra: all
-Requires-Dist: flet-cli==0.82.3.dev7889; extra == "all"
-Requires-Dist: flet-web==0.82.3.dev7889; extra == "all"
-Requires-Dist: flet-desktop==0.82.3.dev7889; extra == "all"
+Requires-Dist: flet-cli==0.82.3.dev7890; extra == "all"
+Requires-Dist: flet-web==0.82.3.dev7890; extra == "all"
+Requires-Dist: flet-desktop==0.82.3.dev7890; extra == "all"
 Provides-Extra: cli
-Requires-Dist: flet-cli==0.82.3.dev7889; extra == "cli"
+Requires-Dist: flet-cli==0.82.3.dev7890; extra == "cli"
 Provides-Extra: desktop
-Requires-Dist: flet-desktop==0.82.3.dev7889; extra == "desktop"
+Requires-Dist: flet-desktop==0.82.3.dev7890; extra == "desktop"
 Provides-Extra: web
-Requires-Dist: flet-web==0.82.3.dev7889; extra == "web"
+Requires-Dist: flet-web==0.82.3.dev7890; extra == "web"
 
 <p align="center">
   <a href="https://flet.dev"><img src="https://raw.githubusercontent.com/flet-dev/flet/refs/heads/main/media/logo/flet-logo.svg" height="150" alt="Flet logo"></a>

{flet-0.82.3.dev7889 → flet-0.82.3.dev7890}/src/flet.egg-info/requires.txt

@@ -2,10 +2,10 @@ repath>=0.9.0
 msgpack>=1.1.0
 
 [:extra == "cli"]
-flet-cli==0.82.3.dev7889
+flet-cli==0.82.3.dev7890
 
 [:extra == "web"]
-flet-web==0.82.3.dev7889
+flet-web==0.82.3.dev7890
 
 [:platform_system != "Pyodide"]
 oauthlib>=3.2.2
@@ -15,15 +15,15 @@ httpx>=0.28.1
 typing-extensions
 
 [all]
-flet-cli==0.82.3.dev7889
-flet-web==0.82.3.dev7889
-flet-desktop==0.82.3.dev7889
+flet-cli==0.82.3.dev7890
+flet-web==0.82.3.dev7890
+flet-desktop==0.82.3.dev7890
 
 [cli]
-flet-cli==0.82.3.dev7889
+flet-cli==0.82.3.dev7890
 
 [desktop]
-flet-desktop==0.82.3.dev7889
+flet-desktop==0.82.3.dev7890
 
 [web]
-flet-web==0.82.3.dev7889
+flet-web==0.82.3.dev7890