flet 0.70.0.dev5623__py3-none-any.whl → 0.70.0.dev5771__py3-none-any.whl

flet/controls/material/container.py

@@ -41,7 +41,7 @@ class Container(LayoutControl, AdaptiveControl):
     ![overview](https://raw.githubusercontent.com/flet-dev/examples/v1-docs/python/controls/container/media/overview-padding-margin-border.png){width="80%"}
     /// caption
     ///
-    """
+    """  # noqa: E501
 
     content: Optional[Control] = None
     """
@@ -56,19 +56,17 @@ class Container(LayoutControl, AdaptiveControl):
 
     alignment: Optional[Alignment] = None
     """
-    Defines the alignment of the [`content`][flet.Container.content] inside the
-    container.
+    Defines the alignment of the [`content`][(c).] inside the container.
     """
 
     bgcolor: Optional[ColorValue] = None
     """
-    Defines the background color of the
-    container.
+    Defines the background color of this container.
     """
 
     gradient: Optional[Gradient] = None
     """
-    Defines the gradient background of the container.
+    Defines the gradient background of this container.
     """
 
     blend_mode: Optional[BlendMode] = None
@@ -95,16 +93,15 @@ class Container(LayoutControl, AdaptiveControl):
 
     clip_behavior: Optional[ClipBehavior] = None
     """
-    Defines how the [`content`][flet.Container.content] of the container is clipped.
+    Defines how the [`content`][(c).] of this container is clipped.
 
-    Defaults to `ClipBehavior.ANTI_ALIAS` if
-    [`border_radius`][flet.Container.border_radius] is not `None`;
+    Defaults to `ClipBehavior.ANTI_ALIAS` if [`border_radius`][(c).] is not `None`;
     otherwise `ClipBehavior.NONE`.
     """
 
     ink: bool = False
     """
-    `True` to produce ink ripples effect when user clicks the container.
+    `True` to produce ink ripples effect when user clicks this container.
     """
 
     image: Optional[DecorationImage] = None
@@ -127,7 +124,7 @@ class Container(LayoutControl, AdaptiveControl):
 
     blur: Optional[BlurValue] = None
     """
-    Applies Gaussian blur effect under the container.
+    Defines how Gaussian blur effect should be applied under this container.
 
     Example:
         ```python
@@ -175,56 +172,14 @@ class Container(LayoutControl, AdaptiveControl):
     """
     The URL to open when this container is clicked.
 
-    Additionally, if [`on_click`][flet.Container.on_click] event callback is provided,
+    Additionally, if an [`on_click`][(c).] callback is provided,
     it is fired after that.
     """
 
     theme: Optional[Theme] = None
     """
-    Allows setting a nested theme for all controls inside the container and down its
+    Allows setting a nested theme for all controls inside this container and down its
     tree.
-
-    Example:
-        ```python
-        import flet as ft
-
-        def main(page: ft.Page):
-            # Yellow page theme with SYSTEM (default) mode
-            page.theme = ft.Theme(
-                color_scheme_seed=ft.Colors.YELLOW,
-            )
-
-            page.add(
-                # Page theme
-                ft.Container(
-                    content=ft.Button("Page theme button"),
-                    bgcolor=ft.Colors.SURFACE_CONTAINER_HIGHEST,
-                    padding=20,
-                    width=300,
-                ),
-
-                # Inherited theme with primary color overridden
-                ft.Container(
-                    theme=ft.Theme(color_scheme=ft.ColorScheme(primary=ft.Colors.PINK)),
-                    content=ft.Button("Inherited theme button"),
-                    bgcolor=ft.Colors.SURFACE_CONTAINER_HIGHEST,
-                    padding=20,
-                    width=300,
-                ),
-
-                # Unique always DARK theme
-                ft.Container(
-                    theme=ft.Theme(color_scheme_seed=ft.Colors.INDIGO),
-                    theme_mode=ft.ThemeMode.DARK,
-                    content=ft.Button("Unique theme button"),
-                    bgcolor=ft.Colors.SURFACE_CONTAINER_HIGHEST,
-                    padding=20,
-                    width=300,
-                ),
-            )
-
-        ft.run(main)
-        ```
     """
 
     dark_theme: Optional[Theme] = None
@@ -237,7 +192,7 @@ class Container(LayoutControl, AdaptiveControl):
     """
     "Resets" parent theme and creates a new, unique scheme for all
     controls inside the container. Otherwise the styles defined in container's
-    [`theme`][flet.Container.theme] property override corresponding styles from
+    [`theme`][(c).] property override corresponding styles from
     the parent, inherited theme.
 
     Defaults to `ThemeMode.SYSTEM`.
@@ -260,52 +215,14 @@ class Container(LayoutControl, AdaptiveControl):
 
     on_click: Optional[ControlEventHandler["Container"]] = None
     """
-    Called when a user clicks the container. Will not be fired on long press.
+    Called when a user clicks the container.
+
+    It will not be called if this container is long pressed.
     """
 
     on_tap_down: Optional[EventHandler[TapEvent["Container"]]] = None
     """
     Called when a user clicks the container with or without a long press.
-
-    Info:
-        If [`ink=True`][flet.Container.ink], the event handler argument will be plain
-        [`ControlEvent`][flet.ControlEvent] with empty `data` instead of
-        [`TapEvent`][flet.TapEvent].
-
-    Example:
-        ```python
-        import flet as ft
-
-        def main(page: ft.Page):
-            page.vertical_alignment = ft.MainAxisAlignment.CENTER
-            page.horizontal_alignment = ft.CrossAxisAlignment.CENTER
-
-            def on_long_press(e):
-                print("on long press")
-                page.add(ft.Text("on_long_press triggered"))
-
-            def on_click(e):
-                print("on click")
-                page.add(ft.Text("on_click triggered"))
-
-            def on_tap_down(e: ft.ContainerTapEvent):
-                print("on tap down", e.local_x, e.local_y)
-                page.add(ft.Text("on_tap_down triggered"))
-
-            c = ft.Container(
-                bgcolor=ft.Colors.RED,
-                content=ft.Text("Test Long Press"),
-                height=100,
-                width=100,
-                on_click=on_click,
-                on_long_press=on_long_press,
-                on_tap_down=on_tap_down,
-            )
-
-            page.add(c)
-
-        ft.run(main)
-        ```
     """
 
     on_long_press: Optional[ControlEventHandler["Container"]] = None
@@ -317,32 +234,8 @@ class Container(LayoutControl, AdaptiveControl):
     """
     Called when a mouse pointer enters or exists the container area.
 
-    The `data` property of the event handler argument is `True` when the cursor
-    enters and `False` when it exits.
-
-    Example:
-        A container changing its background color on mouse hover:
-
-        ```python
-        import flet as ft
-
-        def main(page: ft.Page):
-            def on_hover(e):
-                e.control.bgcolor = "blue" if e.data == True else "red"
-                e.control.update()
-
-            page.add(
-                ft.Container(
-                    width=100,
-                    height=100,
-                    bgcolor="red",
-                    ink=False,
-                    on_hover=on_hover,
-                )
-            )
-
-        ft.run(main)
-        ```
+    The [`data`][flet.Event.] property of the event handler argument is a boolean:
+    `True` when the cursor enters and `False` when it exits this container.
     """
 
     def init(self):

flet/controls/material/datatable.py

@@ -33,7 +33,7 @@ class DataColumnSortEvent(Event["DataColumn"]):
 @control("DataColumn")
 class DataColumn(Control):
     """
-    Column configuration for a [`DataTable`][flet.DataTable].
+    Column configuration for a [`DataTable`][flet.].
 
     Raises:
         AssertionError: If the [`label`][(c).] is neither a string nor
@@ -44,9 +44,9 @@ class DataColumn(Control):
     """
     The column heading.
 
-    Typically, this will be a [`Text`][flet.Text] control.
-    It could also be an [`Icon`][flet.Icon] (typically
-    using size 18), or a combination of both in a [`Row`][flet.Row].
+    Typically, this will be a [`Text`][flet.] control.
+    It could also be an [`Icon`][flet.] (typically using size 18),
+    or a combination of both in a [`Row`][flet.].
     """
 
     numeric: bool = False
@@ -90,7 +90,7 @@ class DataColumn(Control):
 @control("DataCell")
 class DataCell(Control):
     """
-    The data for a cell of a [`DataTable`][flet.DataTable].
+    The data for a cell of a [`DataTable`][flet.].
 
     Raises:
         AssertionError: If the [`content`][(c).] is neither a string nor a visible
@@ -99,22 +99,23 @@ class DataCell(Control):
 
     content: StrOrControl
     """
-    The content of this cell. Can be a string or a control.
+    The content of this cell.
 
-    Typically a [`Text`][flet.Text] control or a [`Dropdown`][flet.Dropdown] control.
+    Typically a [`Text`][flet.] control or a [`Dropdown`][flet.] control.
 
-    If the cell has no data, then a `Text` widget with placeholder text should be
-    provided instead, and [`placeholder`][flet.DataCell.placeholder] should be set to
+    If the cell has no data, then a [`Text`][flet.] control with placeholder text
+    should be provided instead, and [`placeholder`][(c).] should be set to
     `True`.
 
-    To lay out multiple children, let this
-    control's child be a container-like control such as [`Row`][flet.Row],
-    [`Column`][flet.Column], or [`Stack`][flet.Stack], which have `controls` property.
+    Tip:
+        To lay out multiple children, set the [`content`][(c).] to a
+        container-like control such as [`Row`][flet.], [`Column`][flet.], or
+        [`Stack`][flet.], which have a `controls` property.
     """
 
     placeholder: bool = False
     """
-    Whether the child is actually a placeholder.
+    Whether the [`content`][(c).] is actually a placeholder.
 
     If this is `True`, the default text style for the cell is changed to be appropriate
     for placeholder text.
@@ -122,53 +123,44 @@ class DataCell(Control):
 
     show_edit_icon: bool = False
     """
-    Whether to show an edit icon at the end of the cell.
+    Whether to show an edit icon at the end of this cell.
 
     This does not make the cell actually editable; the caller must implement editing
-    behavior if desired (initiated from the [`on_tap`][flet.DataCell.on_tap] callback).
+    behavior if desired (initiated from the [`on_tap`][(c).] callback).
 
     Note:
-        If this is set, [`on_tap`][flet.DataCell.on_tap] should also be set,
+        If this is set, [`on_tap`][(c).] should also be set,
         otherwise tapping the icon will have no effect.
     """
 
     on_tap: Optional[ControlEventHandler["DataCell"]] = None
     """
-    Called if the cell is tapped.
+    Called if this cell is tapped.
 
     Note:
-        If this is `None` (including [`on_double_tap`][flet.DataCell.on_double_tap],
-        [`on_long_press`][flet.DataCell.on_long_press],
-        [`on_tap_cancel`][flet.DataCell.on_tap_cancel],
-        [`on_tap_down`][flet.DataCell.on_tap_down]), tapping this cell
-        will attempt to select its row (if
-        [`DataRow.on_select_change`][flet.DataRow.on_select_change] is provided).
+        If this is `None` (including [`on_double_tap`][(c).], [`on_long_press`][(c).],
+        [`on_tap_cancel`][(c).], [`on_tap_down`][(c).]), tapping this cell will
+        attempt to select its row (if [`DataRow.on_select_change`][flet.] is provided).
     """
 
     on_double_tap: Optional[ControlEventHandler["DataCell"]] = None
     """
-    Called when the cell is double tapped.
+    Called when this cell is double tapped.
 
     Note:
-        If this is `None` (including [`on_tap`][flet.DataCell.on_tap],
-        [`on_long_press`][flet.DataCell.on_long_press],
-        [`on_tap_cancel`][flet.DataCell.on_tap_cancel],
-        [`on_tap_down`][flet.DataCell.on_tap_down]), tapping this cell
-        will attempt to select its row (if
-        [`DataRow.on_select_change`][flet.DataRow.on_select_change] is provided).
+        If this is `None` (including [`on_tap`][(c).], [`on_long_press`][(c).],
+        [`on_tap_cancel`][(c).], [`on_tap_down`][(c).]), tapping this cell will
+        attempt to select its row (if [`DataRow.on_select_change`][flet.] is provided).
     """
 
     on_long_press: Optional[ControlEventHandler["DataCell"]] = None
     """
-    Called if the cell is long-pressed.
+    Called if this cell is long-pressed.
 
     Note:
-        If this is `None` (including [`on_tap`][flet.DataCell.on_tap],
-        [`on_double_tap`][flet.DataCell.on_double_tap],
-        [`on_tap_cancel`][flet.DataCell.on_tap_cancel],
-        [`on_tap_down`][flet.DataCell.on_tap_down]), tapping this cell
-        will attempt to select its row (if
-        [`DataRow.on_select_change`][flet.DataRow.on_select_change] is provided).
+        If this is `None` (including [`on_tap`][(c).], [`on_double_tap`][(c).],
+        [`on_tap_cancel`][(c).], [`on_tap_down`][(c).]), tapping this cell will attempt
+        to select its row (if [`DataRow.on_select_change`][flet.] is provided).
     """
 
     on_tap_cancel: Optional[ControlEventHandler["DataCell"]] = None
@@ -176,25 +168,19 @@ class DataCell(Control):
     Called if the user cancels a tap was started on cell.
 
     Note:
-        If this is `None` (including [`on_tap`][flet.DataCell.on_tap],
-        [`on_double_tap`][flet.DataCell.on_double_tap],
-        [`on_long_press`][flet.DataCell.on_long_press],
-        [`on_tap_down`][flet.DataCell.on_tap_down]), tapping this cell
-        will attempt to select its row (if
-        [`DataRow.on_select_change`][flet.DataRow.on_select_change] is provided).
+        If this is `None` (including [`on_tap`][(c).], [`on_double_tap`][(c).],
+        [`on_long_press`][(c).], [`on_tap_down`][(c).]), tapping this cell will
+        attempt to select its row (if [`DataRow.on_select_change`][flet.] is provided).
     """
 
     on_tap_down: Optional[EventHandler[TapEvent["DataCell"]]] = None
     """
-    Called if the cell is tapped down.
+    Called if this cell is tapped down.
 
     Note:
-        If this is `None` (including [`on_tap`][flet.DataCell.on_tap],
-        [`on_double_tap`][flet.DataCell.on_double_tap],
-        [`on_long_press`][flet.DataCell.on_long_press],
-        [`on_tap_cancel`][flet.DataCell.on_tap_cancel]), tapping this cell
-        will attempt to select its row (if
-        [`DataRow.on_select_change`][flet.DataRow.on_select_change] is provided).
+        If this is `None` (including [`on_tap`][(c).], [`on_double_tap`][(c).],
+        [`on_long_press`][(c).], [`on_tap_cancel`][(c).]), tapping this cell will
+        attempt to select its row (if [`DataRow.on_select_change`][flet.] is provided).
     """
 
     def before_update(self):
@@ -215,8 +201,7 @@ class DataRow(Control):
 
     cells: list[DataCell] = field(default_factory=list)
     """
-    The data for this row - a list of [`DataCell`][flet.DataCell]
-    controls.
+    The data for this row: a list of [`DataCell`][flet.] controls.
 
     Note:
         There must be exactly as many cells as there are columns in the table.
@@ -224,12 +209,12 @@ class DataRow(Control):
 
     color: Optional[ControlStateValue[ColorValue]] = None
     """
-    The color for the row.
+    The color of this row.
 
     By default, the color is transparent unless selected. Selected rows has a grey
     translucent color.
 
-    The effective color can depend on the [`ControlState`][flet.ControlState]
+    The effective color can depend on the [`ControlState`][flet.]
     state, if the row is selected, pressed, hovered, focused, disabled or enabled. The
     color is painted as an overlay to the row. To make sure that the row's InkWell is
     visible (when pressed, hovered and focused), it is recommended to use a translucent
@@ -249,14 +234,11 @@ class DataRow(Control):
 
     on_long_press: Optional[ControlEventHandler["DataRow"]] = None
     """
-    Called if the row is long-pressed.
+    Called when this row is long-pressed.
 
-    If a [`DataCell`][flet.DataCell] in the row has its
-    [`DataCell.on_tap`][flet.DataCell.on_tap],
-    [`DataCell.on_double_tap`][flet.DataCell.on_double_tap],
-    [`DataCell.on_long_press`][flet.DataCell.on_long_press],
-    [`DataCell.on_tap_cancel`][flet.DataCell.on_tap_cancel]
-    or [`DataCell.on_tap_down`][flet.DataCell.on_tap_down]
+    If a [`DataCell`][flet.] in the row has its [`DataCell.on_tap`][flet.],
+    [`DataCell.on_double_tap`][flet.], [`DataCell.on_long_press`][flet.],
+    [`DataCell.on_tap_cancel`][flet.] or [`DataCell.on_tap_down`][flet.]
     callback defined, that callback behavior overrides the gesture behavior of the row
     for that particular cell.
     """
@@ -275,10 +257,9 @@ class DataRow(Control):
     A row whose `on_select_change` callback is null is ignored for the purposes of
     determining the state of the "all" checkbox, and its checkbox is disabled.
 
-    If a [`DataCell`][flet.DataCell] in the row has its
-    [`DataCell.on_tap`][flet.DataCell.on_tap] callback defined, that
-    callback behavior overrides the gesture behavior of the row for that particular
-    cell.
+    If a [`DataCell`][flet.] in the row has its [`DataCell.on_tap`][flet.]
+    callback defined, that callback behavior overrides the gesture behavior of the
+    row for that particular cell.
     """
 
     def __contains__(self, item):
@@ -299,7 +280,7 @@ class DataTable(LayoutControl):
     Raises:
         AssertionError: If there are no visible [`columns`][(c).].
         AssertionError: If any visible row does not contain exactly as many visible
-            [`cells`][flet.DataRow.cells] as there are visible [`columns`][(c).].
+            [`DataRow.cells`][flet.] as there are visible [`columns`][(c).].
         AssertionError: If [`data_row_min_height`][(c).] is greater than
             [`data_row_max_height`][(c).].
         AssertionError: If [`divider_thickness`][(c).] is negative.
@@ -308,19 +289,17 @@ class DataTable(LayoutControl):
 
     columns: list[DataColumn]
     """
-    A list of [`DataColumn`][flet.DataColumn]
-    controls describing table columns.
+    A list of [`DataColumn`][flet.] controls describing table columns.
     """
 
     rows: list[DataRow] = field(default_factory=list)
     """
-    A list of [`DataRow`][flet.DataRow] controls defining table rows.
+    A list of [`DataRow`][flet.] controls defining table rows.
     """
 
     sort_ascending: bool = False
     """
-    Whether the column mentioned in
-    [`sort_column_index`][flet.DataTable.sort_column_index],
+    Whether the column mentioned in [`sort_column_index`][(c).],
     if any, is sorted in ascending order.
 
     If `True`, the order is ascending (meaning the rows with the smallest values for
@@ -335,7 +314,7 @@ class DataTable(LayoutControl):
     Whether the control should display checkboxes for selectable rows.
 
     If `True`, a checkbox will be placed at the beginning of each row that is
-    selectable. However, if [`DataRow.on_select_change`][flet.DataRow.on_select_change]
+    selectable. However, if [`DataRow.on_select_change`][flet.]
     is not set for any row, checkboxes will not be placed, even if this value is `True`.
 
     If `False`, all rows will not display a checkbox.
@@ -347,7 +326,7 @@ class DataTable(LayoutControl):
 
     If specified, indicates that the indicated column is the column by which the data
     is sorted. The number must correspond to the index of the relevant column in
-    [`columns`][flet.DataTable.columns].
+    [`columns`][(c).].
 
     Setting this will cause the relevant column to have a sort indicator displayed.
 
@@ -400,11 +379,10 @@ class DataTable(LayoutControl):
     The background color for the data rows.
 
     The effective background color can be made to depend on the
-    [`ControlState`][flet.ControlState]
-    state, i.e. if the row is selected, pressed, hovered, focused, disabled or enabled.
-    The color is painted as an overlay to the row. To make sure that the row's InkWell
-    is visible (when pressed, hovered and focused), it is recommended to use a
-    translucent background color.
+    [`ControlState`][flet.] state, i.e. if the row is selected, pressed, hovered,
+    focused, disabled or enabled. The color is painted as an overlay to the row.
+    To make sure that the row's InkWell is visible (when pressed, hovered and focused),
+    it is recommended to use a translucent background color.
     """
 
     data_row_min_height: Optional[Number] = None
@@ -414,8 +392,7 @@ class DataTable(LayoutControl):
     Defaults to `48.0`.
 
     Note:
-        Must be less than or equal to
-        [`data_row_max_height`][flet.DataTable.data_row_max_height].
+        Must be less than or equal to [`data_row_max_height`][(c).].
     """
 
     data_row_max_height: Optional[Number] = None
@@ -427,28 +404,27 @@ class DataTable(LayoutControl):
     Defaults to `48.0`.
 
     Note:
-        Must be greater than or equal to
-        [`data_row_min_height`][flet.DataTable.data_row_min_height].
+        Must be greater than or equal to [`data_row_min_height`][(c).].
     """
 
     data_text_style: Optional[TextStyle] = None
     """
-    The text style for data rows.
+    The text style of the data [`rows`][(c).].
     """
 
     bgcolor: Optional[ColorValue] = None
     """
-    The background color for the table.
+    The background color for this table.
     """
 
     gradient: Optional[Gradient] = None
     """
-    The background gradient for the table.
+    The background gradient of this table.
     """
 
     divider_thickness: Number = 1.0
     """
-    The width of the divider that appears between [`rows`][flet.DataTable.rows].
+    The width of the divider that appears between [`rows`][(c).].
 
     Note:
         Must be greater than or equal to zero.
@@ -459,7 +435,7 @@ class DataTable(LayoutControl):
     The background color for the heading row.
 
     The effective background color can be made to depend on the
-    [`ControlState`][flet.ControlState] state, i.e. if the row is pressed, hovered,
+    [`ControlState`][flet.] state, i.e. if the row is pressed, hovered,
     focused when sorted. The color is painted as an overlay to the row. To make sure
     that the row's InkWell is visible (when pressed, hovered and focused), it is
     recommended to use a translucent color.
@@ -477,7 +453,7 @@ class DataTable(LayoutControl):
 
     horizontal_margin: Optional[Number] = None
     """
-    The horizontal margin between the edges of the table and the content in the first
+    The horizontal margin between the edges of this table and the content in the first
     and last cells of each row.
 
     When a checkbox is displayed, it is also the margin between the checkbox the
@@ -486,7 +462,7 @@ class DataTable(LayoutControl):
 
     clip_behavior: ClipBehavior = ClipBehavior.NONE
     """
-    Defines how the contents of the table are clipped.
+    Defines how the contents of this table are clipped.
     """
 
     on_select_all: Optional[ControlEventHandler["DataTable"]] = None
@@ -494,13 +470,13 @@ class DataTable(LayoutControl):
     Invoked when the user selects or unselects every row, using the checkbox in the
     heading row.
 
-    If this is `None`, then the
-    [`DataRow.on_select_change`][flet.DataRow.on_select_change]
-    callback of every row in the table is invoked appropriately instead.
+    If this is `None`, then the [`DataRow.on_select_change`][flet.]
+    callback of every [row][(c).rows] of this table is invoked appropriately instead.
 
-    To control whether a particular row is selectable or not, see
-    `DataRow.on_select_change`. This callback is only relevant if any row is
-    selectable.
+    Tip:
+        To control whether a particular row is selectable or not, see
+        [`DataRow.on_select_change`][flet.]. This callback is only relevant if
+        any row is selectable.
     """
 
     def __contains__(self, item):

flet/controls/material/date_picker.py

@@ -47,8 +47,7 @@ class DatePicker(DialogControl):
     """
     A Material-style date picker dialog.
 
-    It is added to [`Page.overlay`][flet.Page.overlay] and can be opened by
-    calling [`Page.show_dialog()`][flet.Page.show_dialog] method.
+    It can be opened by calling [`Page.show_dialog()`][flet.Page.show_dialog] method.
 
     Depending on the [`date_picker_entry_mode`][(c).], it will show either a Calendar
     or an Input (TextField) for picking a date.
@@ -58,7 +57,7 @@ class DatePicker(DialogControl):
     """
     The selected date that the picker should display.
 
-    Defaults to [`current_date`][flet.DatePicker.current_date].
+    Defaults to [`current_date`][(c).].
     """
 
     modal: bool = False
@@ -153,25 +152,25 @@ class DatePicker(DialogControl):
     switch_to_calendar_icon: Optional[IconData] = None
     """
     The name of the icon displayed in the corner of the dialog when
-    [`date_picker_entry_mode`][flet.DatePicker.date_picker_entry_mode]
-    is [`DatePickerEntryMode.INPUT`][flet.DatePickerEntryMode.INPUT].
+    [`date_picker_entry_mode`][(c).]
+    is [`DatePickerEntryMode.INPUT`][flet.].
 
     Clicking on this icon changes the `date_picker_entry_mode` to
-    [`DatePickerEntryMode.CALENDAR`][flet.DatePickerEntryMode.CALENDAR].
+    [`DatePickerEntryMode.CALENDAR`][flet.].
 
-    If `None`, [`Icons.CALENDAR_TODAY`][flet.Icons.CALENDAR_TODAY] is used.
+    If `None`, [`Icons.CALENDAR_TODAY`][flet.] is used.
     """
 
     switch_to_input_icon: Optional[IconData] = None
     """
     The name of the icon displayed in the corner of the dialog when
-    [`date_picker_entry_mode`][flet.DatePicker.date_picker_entry_mode]
-    is [`DatePickerEntryMode.CALENDAR`][flet.DatePickerEntryMode.CALENDAR].
+    [`date_picker_entry_mode`][(c).]
+    is [`DatePickerEntryMode.CALENDAR`][flet.].
 
     Clicking on icon changes the `DatePickerEntryMode` to
-    [`DatePickerEntryMode.INPUT`][flet.DatePickerEntryMode.INPUT].
+    [`DatePickerEntryMode.INPUT`][flet.].
 
-    If `None`, [`Icons.EDIT_OUTLINED`][flet.Icons.EDIT_OUTLINED] is used.
+    If `None`, [`Icons.EDIT_OUTLINED`][flet.] is used.
     """
 
     barrier_color: Optional[ColorValue] = None
@@ -179,7 +178,7 @@ class DatePicker(DialogControl):
     The color of the modal barrier that
     darkens everything below the date picker.
 
-    If `None`, the [`DialogTheme.barrier_color`][flet.DialogTheme.barrier_color]
+    If `None`, the [`DialogTheme.barrier_color`][flet.]
     is used.
     If it is also `None`, then `Colors.BLACK_54` is used.
     """
@@ -187,13 +186,13 @@ class DatePicker(DialogControl):
     on_change: Optional[ControlEventHandler["DatePicker"]] = None
     """
     Called when user clicks confirm button.
-    [`value`][flet.DatePicker.value] is updated with selected date.
+    [`value`][(c).] is updated with selected date.
 
     The `data` property of the event handler argument contains the selected date.
     """
 
     on_entry_mode_change: Optional[EventHandler[DatePickerEntryModeChangeEvent]] = None
     """
-    Called when the [`date_picker_entry_mode`][flet.DatePicker.date_picker_entry_mode]
+    Called when the [`date_picker_entry_mode`][(c).]
     is changed.
     """