bootstack 0.1.0a1__py3-none-any.whl

bootstack/style/builders/scrollbar.py

@@ -0,0 +1,360 @@
+"""Scrollbar style builders.
+
+This module contains style builders for ttk.Scrollbar widget variants.
+"""
+from ttkbootstrap_icons_bs import BootstrapIcon
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import recolor_element_image
+
+
+@BootstyleBuilderTTk.register_builder('square', 'TScrollbar')
+def build_scrollbar_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    if options.get('orient', 'vertical') == 'vertical':
+        build_vertical_scrollbar(b, ttk_style, accent, **options)
+    else:
+        build_horizontal_scrollbar(b, ttk_style, accent, **options)
+
+
+def build_horizontal_scrollbar(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    if accent is not None:
+        thumb_normal = b.color(accent)
+    else:
+        thumb_normal = border_color
+
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    show_arrows = options.get('show_arrows', True)
+    if show_arrows:
+        arrow_size = b.scale(18)
+
+        # arrow [left]
+        arrow_left_normal = BootstrapIcon('caret-left-fill', arrow_size, thumb_normal).image
+        arrow_left_active = BootstrapIcon('caret-left-fill', arrow_size, thumb_active).image
+        arrow_left_pressed = BootstrapIcon('caret-left-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.leftarrow', arrow_left_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_left_pressed),
+                    ('active', arrow_left_active),
+                    ('', arrow_left_normal),
+                ])
+        )
+
+        # arrow [right]
+        arrow_right_normal = BootstrapIcon('caret-right-fill', arrow_size, thumb_normal).image
+        arrow_right_active = BootstrapIcon('caret-right-fill', arrow_size, thumb_active).image
+        arrow_right_pressed = BootstrapIcon('caret-right-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.rightarrow', arrow_right_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_right_pressed),
+                    ('active', arrow_right_active),
+                    ('', arrow_right_normal),
+                ])
+        )
+
+    scrollbar_elements = [
+        Element(f'{ttk_style}.leftarrow', side="left", sticky=""),
+        Element(f'{ttk_style}.rightarrow', side="right", sticky=""),
+        Element(f'{ttk_style}.thumb', sticky="ew"),
+    ]
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Horizontal.Scrollbar.trough', sticky="we").children(
+            scrollbar_elements if show_arrows else [scrollbar_elements[-1]])
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=thumb_normal,
+        troughcolor=surface,
+        padding=0,
+        bordercolor=surface,
+        darkcolor=thumb_normal,
+        lightcolor=thumb_normal,
+        gripcount=0,
+        relief='flat',
+        arrowsize=12,
+    )
+    b.map_style(
+        ttk_style,
+        background=[('pressed', thumb_pressed), ('active', thumb_active)],
+        darkcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+        lightcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+    )
+
+
+def build_vertical_scrollbar(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    if accent is not None:
+        thumb_normal = b.color(accent)
+    else:
+        thumb_normal = border_color
+
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    show_arrows = options.get('show_arrows', True)
+    if show_arrows:
+        arrow_size = b.scale(18)
+
+        # arrow [up]
+        arrow_up_normal = BootstrapIcon('caret-up-fill', arrow_size, thumb_normal).image
+        arrow_up_active = BootstrapIcon('caret-up-fill', arrow_size, thumb_active).image
+        arrow_up_pressed = BootstrapIcon('caret-up-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.uparrow', arrow_up_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_up_pressed),
+                    ('active', arrow_up_active),
+                    ('', arrow_up_normal),
+                ])
+        )
+
+        # arrow [down]
+        arrow_down_normal = BootstrapIcon('caret-down-fill', arrow_size, thumb_normal).image
+        arrow_down_active = BootstrapIcon('caret-down-fill', arrow_size, thumb_active).image
+        arrow_down_pressed = BootstrapIcon('caret-down-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.downarrow', arrow_down_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_down_pressed),
+                    ('active', arrow_down_active),
+                    ('', arrow_down_normal),
+                ])
+        )
+
+    scrollbar_elements = [
+        Element(f'{ttk_style}.uparrow', side="top", sticky=""),
+        Element(f'{ttk_style}.downarrow', side="bottom", sticky=""),
+        Element(f'{ttk_style}.thumb', sticky="ns"),
+    ]
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Vertical.Scrollbar.trough', sticky="ns").children(
+            scrollbar_elements if show_arrows else [scrollbar_elements[-1]]),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=thumb_normal,
+        troughcolor=surface,
+        padding=0,
+        bordercolor=surface,
+        darkcolor=thumb_normal,
+        lightcolor=thumb_normal,
+        gripcount=0,
+        relief='flat',
+        arrowsize=12,
+    )
+    b.map_style(
+        ttk_style,
+        background=[('pressed', thumb_pressed), ('active', thumb_active)],
+        darkcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+        lightcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+    )
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TScrollbar')
+@BootstyleBuilderTTk.register_builder('round', 'TScrollbar')
+@BootstyleBuilderTTk.register_builder('rounded', 'TScrollbar')
+def build_rounded_scrollbar_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """
+    Builds the 'rounded' scrollbar style
+
+    Style options:
+        * show_arrows
+
+    """
+    if options.get('orient', 'vertical') == 'vertical':
+        _build_rounded_vertical_scrollbar(b, ttk_style, accent, **options)
+    else:
+        _build_rounded_horizontal_scrollbar(b, ttk_style, accent, **options)
+
+
+def _build_rounded_vertical_scrollbar(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    if accent is not None:
+        thumb_normal = b.color(accent)
+    else:
+        thumb_normal = border_color
+
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    # thumb element
+    thumb_normal_img = recolor_element_image('scrollbar_vertical', thumb_normal, thumb_active, surface, surface)
+    thumb_active_img = recolor_element_image('scrollbar_vertical', thumb_active, thumb_active, surface, surface)
+    thumb_pressed_img = recolor_element_image('scrollbar_vertical', thumb_pressed, thumb_pressed, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.thumb', thumb_normal_img.image,
+            padding=thumb_normal_img.meta.border, border=thumb_normal_img.meta.border,
+            width=thumb_normal_img.meta.width, height=thumb_normal_img.meta.height).state_specs(
+            [
+                ('pressed', thumb_pressed_img.image),
+                ('active', thumb_active_img.image),
+                ('', thumb_normal_img.image),
+            ]),
+    )
+
+    show_arrows = options.get('show_arrows', True)
+    if show_arrows:
+        arrow_size = b.scale(18)
+
+        # arrow [up]
+        arrow_up_normal = BootstrapIcon('caret-up-fill', arrow_size, thumb_normal).image
+        arrow_up_active = BootstrapIcon('caret-up-fill', arrow_size, thumb_active).image
+        arrow_up_pressed = BootstrapIcon('caret-up-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.uparrow', arrow_up_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_up_pressed),
+                    ('active', arrow_up_active),
+                    ('', arrow_up_normal),
+                ])
+        )
+
+        # arrow [down]
+        arrow_down_normal = BootstrapIcon('caret-down-fill', arrow_size, thumb_normal).image
+        arrow_down_active = BootstrapIcon('caret-down-fill', arrow_size, thumb_active).image
+        arrow_down_pressed = BootstrapIcon('caret-down-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.downarrow', arrow_down_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_down_pressed),
+                    ('active', arrow_down_active),
+                    ('', arrow_down_normal),
+                ])
+        )
+
+    scrollbar_elements = [
+        Element(f'{ttk_style}.uparrow', side="top", sticky=""),
+        Element(f'{ttk_style}.downarrow', side="bottom", sticky=""),
+        Element(f'{ttk_style}.thumb', sticky="ns"),
+    ]
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Vertical.Scrollbar.trough', sticky="ns").children(
+            scrollbar_elements if show_arrows else [scrollbar_elements[-1]]),
+    )
+
+    b.configure_style(
+        ttk_style,
+        troughcolor=surface,
+        bordercolor=surface,
+        relief='flat'
+    )
+
+
+def _build_rounded_horizontal_scrollbar(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    if accent is not None:
+        thumb_normal = b.color(accent)
+    else:
+        thumb_normal = border_color
+
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    # thumb element
+    thumb_normal_img = recolor_element_image('scrollbar_horizontal', thumb_normal, thumb_active, surface, surface)
+    thumb_active_img = recolor_element_image('scrollbar_horizontal', thumb_active, thumb_active, surface, surface)
+    thumb_pressed_img = recolor_element_image('scrollbar_horizontal', thumb_pressed, thumb_pressed, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.thumb', thumb_normal_img.image,
+            padding=thumb_normal_img.meta.border, border=thumb_normal_img.meta.border,
+            width=thumb_normal_img.meta.width, height=thumb_normal_img.meta.height).state_specs(
+            [
+                ('pressed', thumb_pressed_img.image),
+                ('active', thumb_active_img.image),
+                ('', thumb_normal_img.image),
+            ]),
+    )
+
+    show_arrows = options.get('show_arrows', True)
+    if show_arrows:
+        # arrow elements
+        arrow_size = b.scale(18)
+
+        # arrow [left]
+        arrow_left_normal = BootstrapIcon('caret-left-fill', arrow_size, thumb_normal).image
+        arrow_left_active = BootstrapIcon('caret-left-fill', arrow_size, thumb_active).image
+        arrow_left_pressed = BootstrapIcon('caret-left-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.leftarrow', arrow_left_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_left_pressed),
+                    ('active', arrow_left_active),
+                    ('', arrow_left_normal),
+                ])
+        )
+
+        # arrow [right]
+        arrow_right_normal = BootstrapIcon('caret-right-fill', arrow_size, thumb_normal).image
+        arrow_right_active = BootstrapIcon('caret-right-fill', arrow_size, thumb_active).image
+        arrow_right_pressed = BootstrapIcon('caret-right-fill', arrow_size, thumb_pressed).image
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.rightarrow', arrow_right_normal,
+                padding=2, border=2, width=arrow_size, height=arrow_size).state_specs(
+                [
+                    ('pressed', arrow_right_pressed),
+                    ('active', arrow_right_active),
+                    ('', arrow_right_normal),
+                ])
+        )
+
+    scrollbar_elements = [
+        Element(f'{ttk_style}.leftarrow', side="left", sticky=""),
+        Element(f'{ttk_style}.rightarrow', side="right", sticky=""),
+        Element(f'{ttk_style}.thumb', sticky="ew"),
+    ]
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Horizontal.Scrollbar.trough', sticky="we").children(
+            scrollbar_elements if show_arrows else [scrollbar_elements[-1]])
+    )
+
+    b.configure_style(
+        ttk_style,
+        troughcolor=surface,
+        bordercolor=surface,
+        relief='flat'
+    )

bootstack/style/builders/separator.py

@@ -0,0 +1,45 @@
+"""Separator widget style builders.
+
+This module contains style builders for ttk.Separator widgets and variants.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import ElementImage, Element
+from bootstack.style.utility import create_box_image
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TSeparator')
+def build_separator_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    accent_token = accent or 'border'
+    surface_token = options.get('surface', 'content')
+    orient = options.get('orient', 'horizontal')
+    thickness = options.get('thickness', 1)
+    length = options.get('length')  # None means stretch to fill
+
+    # Default length for the image (will stretch if packed with fill)
+    default_length = length or 40
+    width, height = (default_length, thickness)
+    if orient == 'vertical':
+        width, height = (thickness, default_length)
+
+    surface = b.color(surface_token)
+    if accent_token == 'border':
+        accent_color = b.border(surface)
+    else:
+        accent_color = b.color(accent_token)
+
+    img = create_box_image(width, height, accent_color)
+    sticky = "ew" if orient == "horizontal" else "ns"
+
+    # When length is specified, set explicit dimensions to prevent stretching
+    if length and orient == 'vertical':
+        b.create_style_element_image(ElementImage(f"{ttk_style}.Separator", img, border=0, sticky=sticky, height=length))
+    elif length and orient == 'horizontal':
+        b.create_style_element_image(ElementImage(f"{ttk_style}.Separator", img, border=0, sticky=sticky, width=length))
+    else:
+        b.create_style_element_image(ElementImage(f"{ttk_style}.Separator", img, border=0, sticky=sticky))
+
+    b.create_style_layout(ttk_style, Element(f"{ttk_style}.Separator", sticky=sticky))
+    b.configure_style(ttk_style, background=surface)