flet 0.70.0.dev6491__py3-none-any.whl → 0.70.0.dev6519__py3-none-any.whl

flet/__init__.py

@@ -311,7 +311,6 @@ from flet.controls.material.navigation_bar import (
 from flet.controls.material.navigation_drawer import (
     NavigationDrawer,
     NavigationDrawerDestination,
-    NavigationDrawerPosition,
 )
 from flet.controls.material.navigation_rail import (
     NavigationRail,
@@ -778,7 +777,6 @@ __all__ = [
     "NavigationBarTheme",
     "NavigationDrawer",
     "NavigationDrawerDestination",
-    "NavigationDrawerPosition",
     "NavigationDrawerTheme",
     "NavigationRail",
     "NavigationRailDestination",

flet/controls/animation.py

@@ -86,6 +86,16 @@ class Animation:
 
 @dataclass
 class AnimationStyle:
+    """
+    Used to override the default parameters of an animation.
+
+    Note:
+        If [`duration`][(c).] and [`reverse_duration`][(c).] are set to
+        [`Duration()`][flet.Duration], the corresponding animation will be disabled.
+        See [`no_animation()`][(c).no_animation] method for a convenient way to create
+        such an instance.
+    """
+
     duration: Optional[DurationValue] = None
     """
     The duration of the animation.
@@ -106,6 +116,16 @@ class AnimationStyle:
     The curve to use for the reverse animation.
     """
 
+    @staticmethod
+    def no_animation() -> "AnimationStyle":
+        """
+        Creates an instance of `AnimationStyle` with no animation.
+        """
+        return AnimationStyle(
+            duration=Duration(),
+            reverse_duration=Duration(),
+        )
+
     def copy(
         self,
         *,

flet/controls/base_control.py

@@ -116,6 +116,7 @@ class BaseControl:
     """
     Arbitrary data of any type.
     """
+
     key: Optional[KeyValue] = None
 
     ref: InitVar[Optional[Ref["BaseControl"]]] = None
@@ -124,6 +125,9 @@ class BaseControl:
     _internals: dict = field(
         default_factory=dict, init=False, repr=False, compare=False
     )
+    """
+    A dictionary for storing internal control configuration.
+    """
 
     def __post_init__(self, ref: Optional[Ref[Any]]):
         self.__class__.__hash__ = BaseControl.__hash__

flet/controls/base_page.py

@@ -372,6 +372,36 @@ class BasePage(AdaptiveControl):
         dialog.update()
         return dialog
 
+    async def show_drawer(self):
+        """
+        Show the drawer.
+
+        Raises:
+            ValueError: If no [`drawer`][(c).] is defined.
+        """
+        await self.__default_view().show_drawer()
+
+    async def close_drawer(self):
+        """
+        Close the drawer.
+        """
+        await self.__default_view().close_drawer()
+
+    async def show_end_drawer(self):
+        """
+        Show the end drawer.
+
+        Raises:
+            ValueError: If no [`end_drawer`][(c).] is defined.
+        """
+        await self.__default_view().show_end_drawer()
+
+    async def close_end_drawer(self):
+        """
+        Close the end drawer.
+        """
+        await self.__default_view().close_end_drawer()
+
     async def take_screenshot(
         self,
         pixel_ratio: Optional[Number] = None,

flet/controls/core/image.py

@@ -29,7 +29,7 @@ class Image(LayoutControl):
 
     ```python
     ft.Image(
-        src_base64="iVBORw0KGgoAAAANSUhEUgAAABkAAAAgCAYAAADnnNMGAAAACXBIWXMAAAORAAADkQFnq8zdAAAAGXRFWHRTb2Z0d2FyZQB3d3cuaW5rc2NhcGUub3Jnm+48GgAAA6dJREFUSImllltoHFUYx3/fzOzm0lt23ZrQ1AQbtBehNpvQohgkBYVo410RwQctNE3Sh0IfiiBoIAjqi6TYrKnFy4O3oiiRavDJFi3mXomIBmOxNZe63ay52GR3Zj4f2sTEzmx3m//TYf7/c35zvgPnO6KqrESXqpq3muocAikv6m+/zytj3ejik1VN21G31YA9CgJ6xC+bMyQZPVCuarciPAMYC99V6Vw5pLbFSibHmlVoRVj9P3cmPBM8tSJI/M6mzabpfoAQ9fIF7WK4bd5vvuFnLGgy2vi0abg94A0AcJGvMq3hDxGRyar9r4F+iLAm0yIiRk8m37tctS1WsrIhhrI30+Srmg+J87OXUf3lWGS1q89dC6ltsSanxk4Aj2QBABii96300g87P/rtlrWr8l+vyDMfdlXSyyEikqxsiOUAQJCBhfHdXRfCq1LSsSlcWG+KBAGStvvrMkgiuv8lUc2mREukPwLUfHG+uTQv8Eown7VL3XlbBxYhf1c17hbVF3MDwA9bts280TnaU1YYqPby07aeFlUlHt27wSQ4CLo+F8AvoTCvHmyKF+ZbEb/M77P2LgvAwmrTHAHflN3KZxVbMC2jMFNOpgPnrMSOhvvFkMezXdwV4ePbtvHtxnJAMQ0j4JtVnO+eLb5oiSlt5HDbv7t1O90lpYCCCKbhfzW5kAIwUAazR0BlfII8Ow0I6uoVmI9MyAMwbMs8CExmDbk4zgu931MyO4OI4KrYflkRjOoTI+uM9d1vjotwKPu9QMk/sxzuO8POiVFcdZ1M2YBVsMEAKOqLvaPIe7mACuw0z/80SMH58SMplxlfiDhVi7dw2pltRhjKBQTQdrSja2KKTfE551NHuaZ0QVPvWYQUn31/Vm2nDvgjF4grVJx6suSvrvrSJ/6cSW2Oz9mf264uNrB806xZ1k/CZ49dUKgDEtlCROX2hfHpx8pGuuo3PpqYulw8fjndOp1yhgtNKRevJ1FyR2Ola+jXAjdnwTkZ6o896GdWdxDw7IxFg+0DpmXchTKSBWQnIuJn9u4j7dt+13UfHXEkXQOcuQ4kMhVtqsgUyPiQiPQfHw1NB2sRjmXKuTg1NwwBYLhtPtQX26eqTwGXPDOqvmcC4Hnwfrrad94GrVsOYTqUTkQY+iTlNe/6O1miSP/x0VB/+wMIDwHn/vtV1iQC4Xv95uUEWVCoL9Y5Z+gdovoyMHUFJHv88jmVy0vTuw7cZNv2YaA61Bfb7ZX5F8SaUv2xwZevAAAAAElFTkSuQmCC",
+        src="https://flet.dev/img/logo.svg",
         width=100,
         height=100,
     )

flet/controls/core/pagelet.py

@@ -107,27 +107,36 @@ class Pagelet(LayoutControl, AdaptiveControl):
         if not self.content.visible:
             raise ValueError("content must be visible")
 
-    # todo: deprecate show_* in favor of a open/close methods, or page.open/close
-    # Drawer
-    #
-    def show_drawer(self, drawer: NavigationDrawer):
-        self.drawer = drawer
-        self.drawer.open = True
-        self.update()
-
-    def close_drawer(self):
-        if self.drawer is not None:
-            self.drawer.open = False
-            self.update()
-
-    # End_drawer
-    #
-    def show_end_drawer(self, end_drawer: NavigationDrawer):
-        self.end_drawer = end_drawer
-        self.end_drawer.open = True
-        self.update()
-
-    def close_end_drawer(self):
-        if self.end_drawer is not None:
-            self.end_drawer.open = False
-            self.update()
+    async def show_drawer(self):
+        """
+        Show the drawer.
+
+        Raises:
+            ValueError: If no [`drawer`][(c).] is defined.
+        """
+        if self.drawer is None:
+            raise ValueError("No drawer defined")
+        await self._invoke_method("show_drawer")
+
+    async def close_drawer(self):
+        """
+        Close the drawer.
+        """
+        await self._invoke_method("close_drawer")
+
+    async def show_end_drawer(self):
+        """
+        Show the end drawer.
+
+        Raises:
+            ValueError: If no [`end_drawer`][(c).] is defined.
+        """
+        if self.end_drawer is None:
+            raise ValueError("No end_drawer defined")
+        await self._invoke_method("show_end_drawer")
+
+    async def close_end_drawer(self):
+        """
+        Close the end drawer.
+        """
+        await self._invoke_method("close_end_drawer")

flet/controls/core/shader_mask.py

@@ -17,6 +17,22 @@ class ShaderMask(LayoutControl):
 
     For example, it can be used to gradually fade out the edge of a control by
     using a [`LinearGradient`][flet.] mask.
+
+    ```python
+    ft.ShaderMask(
+        blend_mode=ft.BlendMode.MULTIPLY,
+        shader=ft.LinearGradient(
+            begin=ft.Alignment.CENTER_LEFT,
+            end=ft.Alignment.CENTER_RIGHT,
+            colors=[ft.Colors.WHITE, ft.Colors.BLACK],
+            tile_mode=ft.GradientTileMode.CLAMP,
+        ),
+        content=ft.Image(
+            src="https://picsum.photos/id/288/300/300",
+            height=300,
+            fit=ft.BoxFit.FILL,
+        )
+    ```
     """
 
     shader: Gradient

flet/controls/core/view.py

@@ -158,9 +158,6 @@ class View(ScrollableControl, LayoutControl):
     can_pop: bool = True
     on_confirm_pop: Optional[ControlEventHandler["View"]] = None
 
-    async def confirm_pop(self, should_pop: bool) -> None:
-        await self._invoke_method("confirm_pop", {"should_pop": should_pop})
-
     def init(self):
         super().init()
         self._internals["host_expanded"] = True
@@ -168,3 +165,40 @@ class View(ScrollableControl, LayoutControl):
     # Magic methods
     def __contains__(self, item: Control) -> bool:
         return item in self.controls
+
+    async def confirm_pop(self, should_pop: bool) -> None:
+        await self._invoke_method("confirm_pop", {"should_pop": should_pop})
+
+    async def show_drawer(self):
+        """
+        Show the drawer.
+
+        Raises:
+            ValueError: If no [`drawer`][(c).] is defined.
+        """
+        if self.drawer is None:
+            raise ValueError("No drawer defined")
+        await self._invoke_method("show_drawer")
+
+    async def close_drawer(self):
+        """
+        Close the drawer.
+        """
+        await self._invoke_method("close_drawer")
+
+    async def show_end_drawer(self):
+        """
+        Show the end drawer.
+
+        Raises:
+            ValueError: If no [`end_drawer`][(c).] is defined.
+        """
+        if self.end_drawer is None:
+            raise ValueError("No end_drawer defined")
+        await self._invoke_method("show_end_drawer")
+
+    async def close_end_drawer(self):
+        """
+        Close the end drawer.
+        """
+        await self._invoke_method("close_end_drawer")

flet/controls/cupertino/cupertino_sliding_segmented_button.py

@@ -21,12 +21,12 @@ class CupertinoSlidingSegmentedButton(LayoutControl):
 
     ```python
     ft.CupertinoSlidingSegmentedButton(
+        selected_index=1,
         controls=[
             ft.Text("One"),
             ft.Text("Two"),
             ft.Text("Three"),
         ],
-        selected_index=1,
     )
     ```
     """
@@ -39,8 +39,7 @@ class CupertinoSlidingSegmentedButton(LayoutControl):
         Must contain at least two visible Controls.
 
     Raises:
-        ValueError: If [`controls`][(c).] does not contain at least two
-            visible controls.
+        ValueError: If it does not contain at least two visible controls.
     """
 
     selected_index: int = 0
@@ -48,8 +47,7 @@ class CupertinoSlidingSegmentedButton(LayoutControl):
     The index (starting from 0) of the selected segment in the [`controls`][(c).] list.
 
     Raises:
-        IndexError: If [`selected_index`][(c).] is out of range relative to the
-            visible controls.
+        IndexError: If it is out of range relative to the visible controls.
     """
 
     bgcolor: ColorValue = CupertinoColors.TERTIARY_SYSTEM_FILL

flet/controls/material/dropdown.py

@@ -220,7 +220,7 @@ class Dropdown(LayoutControl):
     Called when the selected item of this dropdown has changed.
     """
 
-    on_change: Optional[ControlEventHandler["Dropdown"]] = None
+    on_text_change: Optional[ControlEventHandler["Dropdown"]] = None
     """
     Called when the text input of this dropdown has changed.
     """

flet/controls/material/expansion_panel.py

@@ -149,8 +149,8 @@ class ExpansionPanelList(LayoutControl):
     """
     Called when an item of [`controls`][(c).] is expanded or collapsed.
 
-    The event's [`data`][flet.Event.], contains the index of the
-    child panel (in [`controls`][(c).]) which triggered this event.
+    The [`data`][flet.Event.] property of the event handler argument contains the
+    index of the child panel (in [`controls`][(c).]) which triggered this event.
     """
 
     def before_update(self):

flet/controls/material/expansion_tile.py

@@ -3,6 +3,7 @@ from typing import Optional
 
 from flet.controls.adaptive_control import AdaptiveControl
 from flet.controls.alignment import Alignment
+from flet.controls.animation import AnimationStyle
 from flet.controls.base_control import control
 from flet.controls.buttons import OutlinedBorder
 from flet.controls.control import Control
@@ -23,9 +24,29 @@ __all__ = ["ExpansionTile", "TileAffinity"]
 
 
 class TileAffinity(Enum):
+    """
+    Where to place a control in controls that use [`ListTile`][flet.] to position a
+    control next to a label.
+    """
+
     LEADING = "leading"
+    """
+    Positions the control on the leading edge, and the secondary control, if
+    any, on the trailing edge.
+    """
+
     TRAILING = "trailing"
+    """
+    Positions the control on the trailing edge, and the secondary control, if
+    any, on the leading edge.
+    """
+
     PLATFORM = "platform"
+    """
+    Positions the control relative to the text in the fashion that is typical
+    for the current platform, and place the secondary control on the opposite
+    side.
+    """
 
 
 @control("ExpansionTile")
@@ -39,145 +60,212 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
         width=400,
         title="Account",
         subtitle="Manage profile and security",
+        expanded=True,
         controls=[
             ft.ListTile(title=ft.Text("Profile")),
             ft.ListTile(title=ft.Text("Security")),
         ],
-        initially_expanded=True,
     )
     ```
     """
 
     title: StrOrControl
     """
-    A `Control` to display as primary content of the tile.
+    A Control to display as primary content of this tile.
 
     Typically a [`Text`][flet.] control.
 
     Raises:
-        ValueError: If [`title`][(c).] is neither a string nor a visible Control.
+        ValueError: If it is neither a string nor a visible Control.
     """
 
     controls: Optional[list[Control]] = None
     """
-    The controls to be displayed when the tile expands.
+    The controls to be displayed when this tile [expands][(c).expanded].
 
     Typically a list of [`ListTile`][flet.] controls.
     """
 
     subtitle: Optional[StrOrControl] = None
     """
-    Additional content displayed below the title.
+    Additional content displayed below the [`title`][(c).].
 
     Typically a [`Text`][flet.] control.
     """
 
     leading: Optional[IconDataOrControl] = None
     """
-    A `Control` to display before the title.
+    A Control to display before the [`title`][(c).].
+
+    Typically a [`CircleAvatar`][flet.] control.
+
+    Depending on the value of [`affinity`][(c).], this control
+    may replace the rotating expansion arrow icon.
     """
 
     trailing: Optional[IconDataOrControl] = None
     """
-    A `Control` to display after the title.
+    A Control to display after the [`title`][(c).].
 
     Typically an [`Icon`][flet.] control.
+
+    Depending on the value of [`affinity`][(c).], this control
+    may replace the rotating expansion arrow icon.
     """
 
     controls_padding: Optional[PaddingValue] = None
     """
-    Defines the padding around the `controls`.
+    Defines the padding around the [`controls`][(c).].
+
+    If `None`, [`ExpansionTileTheme.controls_padding`][flet.] is used;
+    if that is also `None`, then defaults to `Padding.all(0)`.
     """
 
     tile_padding: Optional[PaddingValue] = None
     """
-    Defines the tile's padding. Default value is `Padding.symmetric(horizontal=16.0)`.
+    Defines the tile's padding.
+
+    Analogous to [`ListTile.content_padding`][flet.], this property defines the
+    insets for the [`leading`][(c).], [`title`][(c).], [`subtitle`][(c).] and
+    [`trailing`][(c).] controls. It does not inset the expanded
+    [`controls`][(c).] widgets.
+
+    If `None`, [`ExpansionTileTheme.tile_padding`][flet.] is used;
+    if that is also `None`, then defaults to `Padding.symmetric(horizontal=16.0)`.
     """
 
     affinity: Optional[TileAffinity] = None
     """
-    Typically used to force the expansion arrow icon to the tile's `leading` or
-    `trailing` edge.
+    Typically used to force the expansion arrow icon to the tile's [`leading`][(c).] or
+    [`trailing`][(c).] edge.
 
-    Defaults to `TileAffinity.PLATFORM`.
+    If `None`, [`ListTileTheme.affinity`][flet.] is used;
+    if that is also `None`, then defaults to [`TileAffinity.TRAILING`][flet.]
+    (the expansion arrow icon appears on the tile's trailing edge).
     """
 
     expanded_alignment: Optional[Alignment] = None
     """
-    Defines the alignment of children, which are arranged in a column when the tile is
-    expanded.
+    Defines the alignment of [`controls`][(c).], which are arranged in a column when
+    the tile is expanded.
+
+    If `None`, [`ExpansionTileTheme.expanded_alignment`][flet.] is used;
+    if that is also `None`, then defaults to [`Alignment.CENTER`][flet.].
     """
 
     expanded_cross_axis_alignment: CrossAxisAlignment = CrossAxisAlignment.CENTER
     """
-    Defines the alignment of each child control within `controls` when the tile is
-    expanded.
+    Defines the alignment of each child control within [`controls`][(c).] when the
+    tile is expanded.
+
+    Raises:
+        ValueError: If set to [`CrossAxisAlignment.BASELINE`][flet.].
     """
 
     clip_behavior: Optional[ClipBehavior] = None
     """
-    The content will be clipped (or not) according to this option.
+    Defines how the content of this tile is clipped.
 
-    Defaults to `ClipBehavior.NONE`.
-    """
+    If set and a custom collapsed or expanded shape is provided,
+    this value determines how this tile is clipped.
 
-    initially_expanded: bool = False
-    """
-    A boolean value which defines whether the tile is initially expanded or collapsed.
+    If `None`, [`ExpansionTileTheme.clip_behavior`][flet.] is used;
+    if that is also `None`, then defaults to [`ClipBehavior.ANTI_ALIAS`][flet.].
     """
 
     maintain_state: bool = False
     """
-    A boolean value which defines whether the state of the `controls` is maintained
-    when the tile expands and collapses.
+    A boolean value which defines whether the state of the [`controls`][(c).] is
+    maintained when this tile [expands][(c).expanded] and collapses.
+
+    When `True`, the children are kept in the tree while the tile is collapsed.
+    When `False` (default), the [`controls`][(c).] are removed from the tree when
+    the tile is collapsed and recreated upon expansion.
     """
 
     text_color: Optional[ColorValue] = None
     """
-    The color of the tile's titles when the sublist is expanded.
+    The color of this tile's titles when the sublist is [`expanded`][(c).].
+
+    If `None`, [`ExpansionTileTheme.text_color`][flet.] is used;
+    if that is also `None`, then defaults to [`body_large`][flet.TextTheme.]
+    of the [`Theme.text_theme`][flet.].
     """
 
     icon_color: Optional[ColorValue] = None
     """
-    The icon color of tile's expansion arrow icon when the sublist is expanded.
+    The icon color of this tile's expansion arrow icon
+    when the sublist is [`expanded`][(c).].
+
+    If `None`, [`ExpansionTileTheme.icon_color`][flet.] is used;
+    if that is also `None`, then defaults to [`ColorScheme.primary`][flet.]
+    of the [`Page.theme`][flet.].
     """
 
     shape: Optional[OutlinedBorder] = None
     """
-    The tile's border shape when the sublist is expanded.
+    The border shape of this tile when the sublist is [`expanded`][(c).].
+
+    If `None`, [`ExpansionTileTheme.shape`][flet.] is used;
+    if that is also `None`, then defaults to a [`Border`][flet.] with vertical sides
+    of color [`Theme.divider_color`][flet.].
     """
 
     bgcolor: Optional[ColorValue] = None
     """
-    The  color to display behind the sublist when expanded.
+    The color to display behind the sublist when [`expanded`][(c).].
+
+    If `None`, [`ExpansionTileTheme.bgcolor`][flet.] is used;
+    if that is also `None`, then defaults to [`Colors.TRANSPARENT`][flet.].
     """
 
     collapsed_bgcolor: Optional[ColorValue] = None
     """
-    Defines the background color of tile when the sublist is collapsed.
+    Defines the background color of this tile when the sublist
+    is collapsed ([`expanded`][(c).] is False).
+
+    If `None`, [`ExpansionTileTheme.collapsed_bgcolor`][flet.] is used;
+    if that is also `None`, then defaults to [`Colors.TRANSPARENT`][flet.].
     """
 
     collapsed_icon_color: Optional[ColorValue] = None
     """
-    The icon color of tile's expansion arrow icon when the sublist is collapsed.
+    The icon color of this tile's expansion arrow icon when the sublist
+    is collapsed ([`expanded`][(c).] is False).
+
+    If `None`, [`ExpansionTileTheme.collapsed_icon_color`][flet.] is used;
+    if that is also `None`, then defaults to [`ColorScheme.on_surface`][flet.]
+    of the [`Page.theme`][flet.].
     """
 
     collapsed_text_color: Optional[ColorValue] = None
     """
-    The color of the tile's titles when the sublist is collapsed.
+    The color of this tile's titles when the sublist
+    is collapsed ([`expanded`][(c).] is False).
+
+    If `None`, [`ExpansionTileTheme.collapsed_text_color`][flet.] is used;
+    if that is also `None`, then defaults to [`body_large`][flet.TextTheme.]
+    of the [`Theme.text_theme`][flet.].
     """
 
     collapsed_shape: Optional[OutlinedBorder] = None
     """
     The tile's border shape when the sublist is collapsed.
+
+    If `None`, [`ExpansionTileTheme.shape`][flet.] is used;
+    if that is also `None`, then defaults to a [`Border`][flet.] with vertical sides
+    of color [`Colors.TRANSPARENT`][flet.].
     """
 
     dense: Optional[bool] = None
     """
-    Whether this list tile is part of a vertically dense list. Dense list tiles default
-    to a smaller height.
+    Whether this list tile is part of a vertically dense list.
+
+    Dense tiles default to having a smaller height.
 
     It is not recommended to set this property to `True` when in Material3.
+
+    If `None`, then its value is based on [`ListTileTheme.dense`][flet.].
     """
 
     enable_feedback: bool = True
@@ -189,26 +277,75 @@ class ExpansionTile(LayoutControl, AdaptiveControl):
 
     show_trailing_icon: bool = True
     """
-    Whether to show the trailing icon (be it the default icon or the custom `trailing`,
-    if specified and visible).
+    Whether this tile should build/show a default trailing icon, if
+    [`trailing`][(c).] is `None`.
     """
 
     min_tile_height: Optional[Number] = None
     """
-    The minimum height of the tile.
+    The minimum height of this tile.
+
+    If `None`, the default tile heights are `56.0`, `72.0`, and `88.0` for one, two,
+    and three lines of text respectively. If [`dense`][(c).] is `True`, these defaults
+    are changed to `48.0`, `64.0`, and `76.0`. A visual density value or a large title
+    will also adjust the default tile heights.
+    """
+
+    expanded: bool = False
+    """
+    The expansion state of this tile.
+
+    `True` - expanded, `False` - collapsed.
     """
 
     visual_density: Optional[VisualDensity] = None
     """
-    Defines how compact the control's layout will be.
+    Defines how compact this tile's layout will be.
+    """
+
+    animation_style: Optional[AnimationStyle] = None
+    """
+    Defines the animation style (curve and duration) for this tile's expansion and
+    collapse.
+
+    If [`AnimationStyle.duration`][flet.] is provided, it will be used to override
+    the expansion animation duration. If it is `None`, then
+    [`AnimationStyle.duration`][flet.] from the
+    [`ExpansionTileTheme.animation_style`][(c).] will be used. If that is also
+    `None`, `Duration(milliseconds=200)` will be used as default.
+
+    If [`AnimationStyle.curve`][flet.] is provided, it will be used to override
+    the expansion animation curve. If it is `None`, then
+    [`AnimationStyle.curve`][flet.] from the
+    [`ExpansionTileTheme.animation_style`][(c).] will be used. If that is also
+    `None`, [`Curves.EASE_IN`][flet.] will be used as default.
+
+    If [`AnimationStyle.reverse_curve`][flet.] is provided, it will be used to override
+    the collapse animation curve. If it is `None`, then
+    [`AnimationStyle.reverse_curve`][flet.] from the
+    [`ExpansionTileTheme.animation_style`][(c).] will be used. If that is also
+    `None`, the expansion curve will be used as default.
+
+    Tip:
+        To disable the animations, use
+        [`AnimationStyle.no_animation()`][flet.AnimationStyle.no_animation].
     """
 
     on_change: Optional[ControlEventHandler["ExpansionTile"]] = None
     """
     Called when a user clicks or taps the list tile.
+
+    The [`data`][flet.Event.] property of the event handler argument is a boolean
+    representing the [`expanded`][(c).] state of the tile after the change.
     """
 
     def before_update(self):
         super().before_update()
         if isinstance(self.title, Control) and not self.title.visible:
             raise ValueError("title must be visible")
+        if self.expanded_cross_axis_alignment == CrossAxisAlignment.BASELINE:
+            raise ValueError(
+                "expanded_cross_axis_alignment cannot be CrossAxisAlignment.BASELINE "
+                "since the expanded controls are aligned in a column, not a row. "
+                "Try aligning the controls differently."
+            )