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

flet/controls/material/navigation_rail.py

@@ -66,7 +66,7 @@ class NavigationRailDestination(Control):
     indicator_color: Optional[ColorValue] = None
     """
     The color of the
-    [`indicator_shape`][flet.NavigationRailDestination.indicator_shape] when
+    [`indicator_shape`][(c).] when
     this destination is selected.
     """
 
@@ -153,7 +153,7 @@ class NavigationRail(LayoutControl):
 
     Its location is not affected by `group_alignment`.
 
-    Typically a [`FloatingActionButton`][flet.FloatingActionButton], but
+    Typically a [`FloatingActionButton`][flet.], but
     may also be a non-button, such as a logo.
     """
 
@@ -204,7 +204,7 @@ class NavigationRail(LayoutControl):
 
     selected_label_text_style: Optional[TextStyle] = None
     """
-    The [`TextStyle`][flet.TextStyle] of a
+    The [`TextStyle`][flet.] of a
     destination's label when it is selected.
 
     When a destination is not selected, `unselected_label_text_style` will instead be
@@ -213,7 +213,7 @@ class NavigationRail(LayoutControl):
 
     unselected_label_text_style: Optional[TextStyle] = None
     """
-    The [`TextStyle`][flet.TextStyle] of a
+    The [`TextStyle`][flet.] of a
     destination's label when it is not selected.
 
     When a destination is selected, `selected_label_text_style` will instead be used.
@@ -223,15 +223,15 @@ class NavigationRail(LayoutControl):
     """
     Whether to add a rounded navigation indicator behind the selected destination's icon.
 
-    The indicator's shape will be circular if [`label_type`][flet.NavigationRail.label_type]
-    is [`NavigationRailLabelType.NONE`][flet.NavigationRailLabelType.NONE], or a
-    [`StadiumBorder`][flet.StadiumBorder] if [`label_type`][flet.NavigationRail.label_type]
-    is [`NavigationRailLabelType.ALL`][flet.NavigationRailLabelType.ALL] or
-    [`NavigationRailLabelType.SELECTED`][flet.NavigationRailLabelType.SELECTED].
+    The indicator's shape will be circular if [`label_type`][(c).]
+    is [`NavigationRailLabelType.NONE`][flet.], or a
+    [`StadiumBorder`][flet.] if [`label_type`][(c).]
+    is [`NavigationRailLabelType.ALL`][flet.] or
+    [`NavigationRailLabelType.SELECTED`][flet.].
 
     If `None`, defaults to
-    [`NavigationRailTheme.use_indicator`][flet.NavigationRailTheme.use_indicator].
-    If that is also `None`, defaults to [`Theme.use_material3`][flet.Theme.use_material3].
+    [`NavigationRailTheme.use_indicator`][flet.].
+    If that is also `None`, defaults to [`Theme.use_material3`][flet.].
     """  # noqa: E501
 
     on_change: Optional[ControlEventHandler["NavigationRail"]] = None

flet/controls/material/outlined_button.py

@@ -61,7 +61,7 @@ class OutlinedButton(LayoutControl, AdaptiveControl):
     """
     The URL to open when this button is clicked.
 
-    Additionally, if [`on_click`][flet.OutlinedButton.on_click] event callback is
+    Additionally, if [`on_click`][(c).] event callback is
     provided, it is fired after that.
     """
 

flet/controls/material/popup_menu_button.py

@@ -43,7 +43,7 @@ class PopupMenuItem(Control):
     Whether this menu item is checked.
 
     If set to `True`, a checkmark will be shown on the left of the
-    [`content`][flet.PopupMenuItem.content].
+    [`content`][(c).].
     """
 
     height: Number = 48.0
@@ -58,11 +58,11 @@ class PopupMenuItem(Control):
     Defaults to `Padding.symmetric(horizontal=12)`.
 
     Note:
-        The [`height`][flet.PopupMenuItem.height] value of this menu item may
+        The [`height`][(c).] value of this menu item may
         influence the applied padding.
 
         For example, if a `height` greater than the height of the sum of the padding
-        and a [`content`][flet.PopupMenuItem.content] is provided, then the padding's
+        and a [`content`][(c).] is provided, then the padding's
         effect will not be visible.
     """
 

flet/controls/material/progress_bar.py

@@ -64,28 +64,23 @@ class ProgressBar(LayoutControl):
     """
     The color of the stop indicator.
 
-    If [`ProgressBar.year2023`][flet.ProgressBar.year_2023] is `True` or
-    [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then no stop
-    indicator will be drawn.
+    If [`ProgressBar.year_2023`][flet.] is `True` or [`Theme.use_material3`][flet.]
+    is `False`, then no stop indicator will be drawn.
 
-    If not set, then the
-    [`ProgressIndicatorTheme.stop_indicator_color`][flet.ProgressIndicatorTheme.stop_indicator_color]
-    will be used. If that is not set, then the
-    [`ColorScheme.primary`][flet.ColorScheme.primary] will be used.
+    If not set, then the [`ProgressIndicatorTheme.stop_indicator_color`][flet.] will
+    be used. If that is not set, then the [`ColorScheme.primary`][flet.] will be used.
     """
 
     stop_indicator_radius: Optional[Number] = None
     """
     The radius of the stop indicator.
 
-    If [`ProgressBar.year2023`][flet.ProgressBar.year_2023] is `True` or
-    [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then no stop
-    indicator will be drawn.
+    If [`ProgressBar.year_2023`][flet.] is `True` or [`Theme.use_material3`][flet.] is
+    `False`, then no stop indicator will be drawn.
 
     Set `stop_indicator_radius` to `0` to hide the stop indicator.
 
-    If not set, then the
-    [`ProgressIndicatorTheme.stop_indicator_radius`][flet.ProgressIndicatorTheme.stop_indicator_radius]
+    If not set, then the [`ProgressIndicatorTheme.stop_indicator_radius`][flet.]
     will be used. If that is not set, then defaults to `2`.
     """
 
@@ -93,15 +88,15 @@ class ProgressBar(LayoutControl):
     """
     The gap between the indicator and the track.
 
-    If [`ProgressBar.year2023`][flet.ProgressBar.year_2023] is `True` or
-    [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then no track gap
+    If [`ProgressBar.year_2023`][flet.] is `True` or
+    [`Theme.use_material3`][flet.] is `False`, then no track gap
     will be drawn.
 
-    Set `track_gap` to `0` to hide the track gap.
-
-    If not set, then the
-    [`ProgressIndicatorTheme.track_gap`][flet.ProgressIndicatorTheme.track_gap] will be
+    If not set, then the [`ProgressIndicatorTheme.track_gap`][flet.] will be
     used. If that is not set, then defaults to `4`.
+
+    Tip:
+        Set `track_gap` to `0` to hide the track gap.
     """
 
     year_2023: Optional[bool] = None
@@ -111,12 +106,10 @@ class ProgressBar(LayoutControl):
 
     When `True`, the ProgressBar will use the 2023 Material Design 3 appearance.
 
-    If not set, then the
-    [`ProgressIndicatorTheme.year_2023`][flet.ProgressIndicatorTheme.year_2023] will be
+    If not set, then the [`ProgressIndicatorTheme.year_2023`][flet.] will be
     used, which is `False` by default.
 
-    If [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then this property
-    is ignored.
+    If [`Theme.use_material3`][flet.] is `False`, then this property is ignored.
     """
 
     def before_update(self):

flet/controls/material/progress_ring.py

@@ -53,7 +53,7 @@ class ProgressRing(LayoutControl):
 
     A value of 0 (center stroke) will center the border on the edge of the control.
 
-    If [`ProgressRing.year_2023`][flet.ProgressRing.year_2023] is `True`, then the
+    If [`ProgressRing.year_2023`][flet.] is `True`, then the
     default value is `0`. Otherwise, the default value is `-1`.
     """
 
@@ -77,13 +77,13 @@ class ProgressRing(LayoutControl):
     """
     The gap between the active indicator and the background track.
 
-    If [`year_2023`][flet.ProgressRing.year_2023] is `True` or `Theme.use_material3` is
+    If [`year_2023`][(c).] is `True` or `Theme.use_material3` is
     `False`, then no track gap will be drawn.
 
     Set `track_gap` to `0` to hide this track gap.
 
     If `None`,
-    [`ProgressIndicatorTheme.track_gap`][flet.ProgressIndicatorTheme.track_gap] is used.
+    [`ProgressIndicatorTheme.track_gap`][flet.] is used.
 
     If that's is also `None`, defaults to `4.0`.
     """
@@ -93,7 +93,7 @@ class ProgressRing(LayoutControl):
     Defines the minimum and maximum size of the progress indicator.
 
     If `None`,
-    [`ProgressIndicatorTheme.size_constraints`][flet.ProgressIndicatorTheme.size_constraints]
+    [`ProgressIndicatorTheme.size_constraints`][flet.]
     is used.
 
     If that's is also `None`, defaults to a minimum width and height of `36`.
@@ -104,10 +104,10 @@ class ProgressRing(LayoutControl):
     The padding around the indicator track.
 
     If `None`,
-    [`ProgressIndicatorTheme.circular_track_padding`][flet.ProgressIndicatorTheme.circular_track_padding]
+    [`ProgressIndicatorTheme.circular_track_padding`][flet.]
     is used.
 
-    If that's is also `None` and [`year_2023`][flet.ProgressRing.year_2023] is `False`,
+    If that's is also `None` and [`year_2023`][(c).] is `False`,
     defaults to `Padding.all(4.0)`.
 
     Otherwise, defaults to `Padding.all(0.0)`.
@@ -121,9 +121,9 @@ class ProgressRing(LayoutControl):
     When `True`, the `ProgressRing` will use the 2023 Material Design 3 appearance.
 
     If not set, then the
-    [`ProgressIndicatorTheme.year_2023`][flet.ProgressIndicatorTheme.year_2023] will be
+    [`ProgressIndicatorTheme.year_2023`][flet.] will be
     used, which is `False` by default.
 
-    If [`Theme.use_material3`][flet.Theme.use_material3] is `False`, then this property
+    If [`Theme.use_material3`][flet.] is `False`, then this property
     is ignored.
     """

flet/controls/material/radio.py

@@ -53,22 +53,17 @@ class Radio(LayoutControl, AdaptiveControl):
 
     fill_color: Optional[ControlStateValue[ColorValue]] = None
     """
-    The color that fills the radio, in all or
-    specific [`ControlState`][flet.ControlState]
-    states.
+    The color that fills the radio, in all or specific [`ControlState`][flet.] states.
     """
 
     active_color: Optional[ColorValue] = None
     """
-    The color used to fill this radio when it
-    is selected.
+    The color used to fill this radio when it is selected.
     """
 
     overlay_color: Optional[ControlStateValue[ColorValue]] = None
     """
-    The overlay color of this radio in all or
-    specific [`ControlState`][flet.ControlState]
-    states.
+    The overlay color of this radio in all or specific [`ControlState`][flet.] states.
     """
 
     hover_color: Optional[ColorValue] = None

flet/controls/material/range_slider.py

@@ -100,7 +100,7 @@ class RangeSlider(LayoutControl):
     """
     The highlight color that's typically
     used to indicate that the range slider thumb is in `HOVERED` or `DRAGGED`
-    [`ControlState`][flet.ControlState] .
+    [`ControlState`][flet.] .
     """
 
     mouse_cursor: Optional[ControlStateValue[MouseCursor]] = None

flet/controls/material/search_bar.py

@@ -30,8 +30,8 @@ class SearchBar(LayoutControl):
     controls: list[Control] = field(default_factory=list)
     """
     The list of controls to be displayed below the search bar when in search view.
-    These controls are usually [`ListTile`][flet.ListTile]s and will be displayed
-    in a [`ListView`][flet.ListView].
+    These controls are usually [`ListTile`][flet.]s and will be displayed
+    in a [`ListView`][flet.].
     """
 
     value: str = ""
@@ -57,23 +57,22 @@ class SearchBar(LayoutControl):
     bar_hint_text: Optional[str] = None
     """
     Defines the text to be shown in the search bar when it is empty and the search
-    view is close. Usually some text that suggests what sort of input the field
-    accepts.
+    view is close.
+
+    Usually some text that suggests what sort of input the field accepts.
     """
 
     bar_bgcolor: Optional[ControlStateValue[ColorValue]] = None
     """
-    Defines the background color of the
-    search bar in all or specific
-    [`ControlState`][flet.ControlState] states.
+    Defines the background color of the search bar in all or specific
+    [`ControlState`][flet.] states.
     """
 
     bar_overlay_color: Optional[ControlStateValue[ColorValue]] = None
     """
-    Defines the highlight color that's
-    typically used to indicate that the search bar is in `FOCUSED`, `HOVERED`, or
-    `PRESSED` [`ControlState`][flet.ControlState]
-    states.
+    Defines the highlight color that's typically used to indicate that the
+    search bar is in [`FOCUSED`][flet.ControlState.], [`HOVERED`][flet.ControlState.],
+    or [`PRESSED`][flet.ControlState.] states.
     """
 
     bar_shadow_color: Optional[ControlStateValue[ColorValue]] = None
@@ -90,7 +89,7 @@ class SearchBar(LayoutControl):
     """
     The color and weight of the search bar's outline.
 
-    This value is combined with [`SearchBar.bar_shape`][flet.SearchBar.bar_shape] to
+    This value is combined with [`SearchBar.bar_shape`][flet.] to
     create a shape decorated with an outline.
     """
 
@@ -99,7 +98,7 @@ class SearchBar(LayoutControl):
     The shape of the search bar.
 
     This shape is combined with
-    [`SearchBar.bar_border_side`][flet.SearchBar.bar_border_side] to create a shape
+    [`SearchBar.bar_border_side`][flet.] to create a shape
     decorated with an outline.
     """
 
@@ -110,7 +109,7 @@ class SearchBar(LayoutControl):
 
     bar_hint_text_style: Optional[ControlStateValue[TextStyle]] = None
     """
-    The style to use for the [`SearchBar.bar_hint_text`][flet.SearchBar.bar_hint_text].
+    The style to use for the [`SearchBar.bar_hint_text`][flet.].
     """
 
     bar_padding: Optional[ControlStateValue[PaddingValue]] = None
@@ -176,13 +175,13 @@ class SearchBar(LayoutControl):
 
     view_header_text_style: Optional[TextStyle] = None
     """
-    Defines the [`TextStyle`][flet.TextStyle] of the
+    Defines the [`TextStyle`][flet.] of the
     text being edited on the search view.
     """
 
     view_hint_text_style: Optional[TextStyle] = None
     """
-    Defines the [`TextStyle`][flet.TextStyle] of
+    Defines the [`TextStyle`][flet.] of
     `view_hint_text`.
     """
 

flet/controls/material/segmented_button.py

@@ -20,7 +20,7 @@ __all__ = ["Segment", "SegmentedButton"]
 @control("Segment")
 class Segment(Control):
     """
-    A segment for a [`SegmentedButton`][flet.SegmentedButton].
+    A segment for a [`SegmentedButton`][flet.].
 
     Raises:
         AssertionError: If neither [`icon`][(c).] nor [`label`][(c).] is set.
@@ -33,13 +33,13 @@ class Segment(Control):
 
     icon: Optional[IconDataOrControl] = None
     """
-    The icon (typically an [`Icon`][flet.Icon]) to be
+    The icon (typically an [`Icon`][flet.]) to be
     displayed in the segment.
     """
 
     label: Optional[StrOrControl] = None
     """
-    The label (usually a [`Text`][flet.Text]) to be
+    The label (usually a [`Text`][flet.]) to be
     displayed in the segment.
     """
 
@@ -147,7 +147,7 @@ class SegmentedButton(LayoutControl):
     """
     Called when the selection changes.
 
-    The [`data`][flet.Event.data] property of the event handler argument
+    The [`data`][flet.Event.] property of the event handler argument
     contains a list of strings identifying the selected segments.
     """
 

flet/controls/material/selection_area.py

@@ -20,9 +20,10 @@ class SelectionArea(Control):
     content: Control
     """
     The child control this selection area applies to.
-    
-    If you need to have multiple selectable controls, use container-like controls 
-    like [`Row`][flet.Row] or [`Column`][flet.Column], which have a `controls` property for this purpose.
+
+    If you need to have multiple selectable controls, use container-like controls
+    like [`Row`][flet.] or [`Column`][flet.], which have a `controls` property
+    for this purpose.
     """
 
     on_change: Optional[ControlEventHandler["SelectionArea"]] = None

flet/controls/material/slider.py

@@ -36,7 +36,7 @@ class Slider(LayoutControl, AdaptiveControl):
     Raises:
         AssertionError: If [`min`][(c).] is greater than or equal to [`max`][(c).].
         AssertionError: If [`min`][(c).] is greater than or equal to [`value`][(c).].
-        AssertionError: If [`max`][(c).] is less than or equal to [`value`][(c)].
+        AssertionError: If [`max`][(c).] is less than or equal to [`value`][(c).].
     """
 
     value: Optional[Number] = None
@@ -45,7 +45,7 @@ class Slider(LayoutControl, AdaptiveControl):
 
     The slider's thumb is drawn at a position that corresponds to this value.
 
-    Defaults to value of [`min`][flet.Slider.min].
+    Defaults to value of [`min`][(c).].
     """
 
     label: Optional[str] = None
@@ -65,8 +65,8 @@ class Slider(LayoutControl, AdaptiveControl):
     The minimum value the user can select.
 
     Note:
-        - Must be less than or equal to [`max`][flet.Slider.max].
-        - If the [`max`][flet.Slider.max] is equal to the `min`, then this slider
+        - Must be less than or equal to [`max`][(c).].
+        - If the [`max`][(c).] is equal to the `min`, then this slider
             is disabled.
     """
 
@@ -75,8 +75,8 @@ class Slider(LayoutControl, AdaptiveControl):
     The maximum value the user can select.
 
     Note:
-        - Must be greater than or equal to [`min`][flet.Slider.min].
-        - If the [`min`][flet.Slider.min] is equal to the `max`, then this slider
+        - Must be greater than or equal to [`min`][(c).].
+        - If the [`min`][(c).] is equal to the `max`, then this slider
             is disabled.
     """
 
@@ -84,15 +84,15 @@ class Slider(LayoutControl, AdaptiveControl):
     """
     The number of discrete divisions.
 
-    Typically used with [`label`][flet.Slider.label] to show the current discrete value.
+    Typically used with [`label`][(c).] to show the current discrete value.
 
     If `None`, this slider is continuous.
     """
 
     round: int = 0
     """
-    The number of decimals displayed on the [`label`][flet.Slider.label]
-    containing [`value`][flet.Slider.value].
+    The number of decimals displayed on the [`label`][(c).]
+    containing [`value`][(c).].
 
     Defaults to `0`, which displays value rounded to the nearest integer.
     """
@@ -131,24 +131,24 @@ class Slider(LayoutControl, AdaptiveControl):
     """
     The allowed way for the user to interact with this slider.
 
-    If `None`, [`SliderTheme.interaction`][flet.SliderTheme.interaction] is used.
+    If `None`, [`SliderTheme.interaction`][flet.] is used.
     If that's is also `None`, defaults to
-    [`SliderInteraction.TAP_AND_SLIDE`][flet.SliderInteraction.TAP_AND_SLIDE].
+    [`SliderInteraction.TAP_AND_SLIDE`][flet.].
     """
 
     secondary_active_color: Optional[ColorValue] = None
     """
     The color to use for the portion of
     the slider track between the thumb and
-    the [`secondary_track_value`][flet.Slider.secondary_track_value].
+    the [`secondary_track_value`][(c).].
     """
 
     overlay_color: Optional[ControlStateValue[ColorValue]] = None
     """
     The highlight color that's typically
     used to indicate that the range slider thumb is in
-    [`ControlState.HOVERED`][flet.ControlState.HOVERED] or
-    [`ControlState.DRAGGED`][flet.ControlState.DRAGGED] states.
+    [`ControlState.HOVERED`][flet.] or
+    [`ControlState.DRAGGED`][flet.] states.
     """
 
     secondary_track_value: Optional[Number] = None
@@ -182,10 +182,10 @@ class Slider(LayoutControl, AdaptiveControl):
     When `True`, the Slider will use the 2023 Material Design 3 appearance.
 
     If not set, then the
-    [`SliderTheme.year_2023`][flet.SliderTheme.year_2023] will be
+    [`SliderTheme.year_2023`][flet.] will be
     used, which is `False` by default.
 
-    If [`Theme.use_material3`][flet.Theme.use_material3] is `False`,
+    If [`Theme.use_material3`][flet.] is `False`,
     then this property is ignored.
     """
 

flet/controls/material/snack_bar.py

@@ -17,7 +17,7 @@ from flet.controls.types import (
     StrOrControl,
 )
 
-__all__ = ["SnackBar", "SnackBarBehavior", "DismissDirection", "SnackBarAction"]
+__all__ = ["DismissDirection", "SnackBar", "SnackBarAction", "SnackBarBehavior"]
 
 
 class SnackBarBehavior(Enum):
@@ -38,14 +38,15 @@ class DismissDirection(Enum):
 @control("SnackBar")
 class SnackBarAction(Control):
     """
-    A button that can be used as an action in a [`SnackBar`][flet.SnackBar].
+    A button that can be used as an action in a [`SnackBar`][flet.].
 
-    An action button for a [`SnackBar`][flet.SnackBar].
+    An action button for a [`SnackBar`][flet.].
 
     Note:
         - Snack bar actions are always enabled. Instead of disabling a snack bar
             action, avoid including it in the snack bar in the first place.
-        -  Snack bar actions can will only respond to first click. Subsequent clicks/presses are ignored.
+        -  Snack bar actions can will only respond to first click.
+            Subsequent clicks/presses are ignored.
     """
 
     label: str
@@ -56,8 +57,8 @@ class SnackBarAction(Control):
     text_color: Optional[ColorValue] = None
     """
     The button label color.
-    
-    If `None`, [`SnackBarTheme.action_text_color`][flet.SnackBarTheme.action_text_color] is used.
+
+    If `None`, [`SnackBarTheme.action_text_color`][flet.] is used.
     """
 
     disabled_text_color: Optional[ColorValue] = None
@@ -69,8 +70,8 @@ class SnackBarAction(Control):
     bgcolor: Optional[ColorValue] = None
     """
     The button background fill color.
-    
-    If `None`, [`SnackBarTheme.action_bgcolor`][flet.SnackBarTheme.action_bgcolor] is used.
+
+    If `None`, [`SnackBarTheme.action_bgcolor`][flet.] is used.
     """
 
     disabled_bgcolor: Optional[ColorValue] = None
@@ -78,7 +79,7 @@ class SnackBarAction(Control):
     The button disabled background color.
     This color is shown after the action is dismissed.
 
-    If `None`, [`SnackBarTheme.disabled_action_bgcolor`][flet.SnackBarTheme.disabled_action_bgcolor] is used.
+    If `None`, [`SnackBarTheme.disabled_action_bgcolor`][flet.] is used.
     """
 
     on_click: Optional[ControlEventHandler["SnackBarAction"]] = None
@@ -98,7 +99,7 @@ class SnackBar(DialogControl):
     """
     The primary content of the snack bar.
 
-    Typically a [`Text`][flet.Text] control.
+    Typically a [`Text`][flet.] control.
     """
 
     behavior: Optional[SnackBarBehavior] = None
@@ -106,26 +107,26 @@ class SnackBar(DialogControl):
     This defines the behavior and location of the snack bar.
 
     Defines where a SnackBar should appear within a page and how its location
-    should be adjusted when the page also includes a [`FloatingActionButton`][flet.FloatingActionButton] or a
-    [`NavigationBar`][flet.NavigationBar].
+    should be adjusted when the page also includes a [`FloatingActionButton`][flet.]
+    or a [`NavigationBar`][flet.].
 
-    If `None`, [`SnackBarTheme.behavior`][flet.SnackBarTheme.behavior] is used.
-    If that's is also `None`, defaults to [`SnackBarBehavior.FIXED`][flet.SnackBarBehavior.FIXED].
+    If `None`, [`SnackBarTheme.behavior`][flet.] is used.
+    If that's is also `None`, defaults to [`SnackBarBehavior.FIXED`][flet.].
 
     Note:
-        - If [`behavior`][flet.SnackBar.behavior] is [`SnackBarBehavior.FLOATING`][flet.SnackBarBehavior.FLOATING], 
-          the length of the bar is defined by either [`width`][flet.SnackBar.width] and 
-          [`margin`][flet.SnackBar.margin], and if both are specified, `width` takes precedence over `margin`.
-        - [`width`][flet.SnackBar.width] and [`margin`][flet.SnackBar.margin] 
-          are ignored if `behavior!=SnackBarBehavior.FLOATING`.
+        - If [`behavior`][(c).] is [`SnackBarBehavior.FLOATING`][flet.], the length of
+            the bar is defined by either [`width`][(c).] and [`margin`][(c).], and if
+            both are specified, `width` takes precedence over `margin`.
+        - [`width`][(c).] and [`margin`][(c).] are ignored if [`behavior`][(c).]
+            is not [`SnackBarBehavior.FLOATING`][flet.].
     """
 
     dismiss_direction: Optional[DismissDirection] = None
     """
     The direction in which the SnackBar can be dismissed.
 
-    If `None`, [`SnackBarTheme.dismiss_direction`][flet.SnackBarTheme.dismiss_direction] is used.
-    If that's is also `None`, defaults to [`DismissDirection.DOWN`][flet.DismissDirection.DOWN].
+    If `None`, [`SnackBarTheme.dismiss_direction`][flet.] is used.
+    If that's is also `None`, defaults to [`DismissDirection.DOWN`][flet.].
     """
 
     show_close_icon: bool = False
@@ -147,7 +148,7 @@ class SnackBar(DialogControl):
 
     close_icon_color: Optional[ColorValue] = None
     """
-    The color of the close icon, if [`show_close_icon`][flet.SnackBar.show_close_icon] is `True`.
+    The color of the close icon, if [`show_close_icon`][(c).] is `True`.
     """
 
     bgcolor: Optional[ColorValue] = None
@@ -181,7 +182,7 @@ class SnackBar(DialogControl):
     available space.
 
     Note:
-        Has effect only when [`behavior`][flet.SnackBar.behavior] is [`SnackBarBehavior.FLOATING`][flet.SnackBarBehavior.FLOATING]. 
+        Has effect only when [`behavior`][(c).] is [`SnackBarBehavior.FLOATING`][flet.].
         It can not be used if `margin` is specified.
     """
 
@@ -198,20 +199,20 @@ class SnackBar(DialogControl):
 
     clip_behavior: ClipBehavior = ClipBehavior.HARD_EDGE
     """
-    The [`content`][flet.SnackBar.content] will be clipped (or not) according to this option.
+    The [`content`][(c).] will be clipped (or not) according to this option.
     """
 
     action_overflow_threshold: Number = 0.25
     """
-    The percentage threshold for [`action`][flet.SnackBar.action]'s width before
+    The percentage threshold for [`action`][(c).]'s width before
     it overflows to a new line.
 
-    If the width of the snackbar's [`content`][flet.SnackBar.content] is greater than this percentage of the
-    width of the snackbar minus the width of its `action`, then the `action` will
-    appear below the `content`.
+    If the width of the snackbar's [`content`][(c).] is greater than this percentage
+    of the width of the snackbar minus the width of its `action`, then the `action`
+    will appear below the [`content`][(c).].
 
     At a value of `0.0`, the `action` will not overflow to a new line.
-    
+
     Note:
         Must be between `0.0` and `1.0` inclusive.
     """
@@ -235,6 +236,6 @@ class SnackBar(DialogControl):
             self.action_overflow_threshold is None
             or 0 <= self.action_overflow_threshold <= 1
         ), "action_overflow_threshold must be between 0 and 1 inclusive"
-        assert (
-            self.elevation is None or self.elevation >= 0
-        ), "elevation cannot be negative"
+        assert self.elevation is None or self.elevation >= 0, (
+            "elevation cannot be negative"
+        )