# Controls


<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

## View Mode Toggle

Buttons to switch between grid and list view.

------------------------------------------------------------------------

### render_view_toggle

``` python

def render_view_toggle(
    current_mode:ViewMode, # Current view mode
    toggle_url:str, # URL for toggle handler
    hx_target:Optional=None, # HTMX target for swap
)->Any: # View toggle button group

```

*Render view mode toggle buttons.*

``` python
from fasthtml.common import to_xml

# Test view toggle - grid mode active
toggle = render_view_toggle(ViewMode.GRID, "/toggle-view", "#gallery")
html = to_xml(toggle)
assert "join" in html
assert "btn-primary" in html  # Active button
assert "btn-ghost" in html    # Inactive button
assert "hx-post" in html      # HTMX on inactive

# Test view toggle - list mode active
toggle = render_view_toggle(ViewMode.LIST, "/toggle-view", "#gallery")
html = to_xml(toggle)
# Both buttons should be present
assert "Grid view" in html or "grid_view" in html.lower() or "<svg" in html

print("render_view_toggle tests passed!")
```

    render_view_toggle tests passed!

## Type Filter Buttons

Filter buttons to show/hide specific file types.

------------------------------------------------------------------------

### render_type_filter_button

``` python

def render_type_filter_button(
    file_type:FileType, # File type for this button
    is_active:bool, # Whether this type is currently shown
    filter_url:str, # URL for filter handler
    hx_target:Optional=None, # HTMX target for swap
    count:Optional=None, # Number of files of this type
)->functools.partial(<function ft_hx at 0x7f5282f831a0>, 'button'): # Filter button

```

*Render a single type filter button.*

``` python
# Test type filter button
btn_elem = render_type_filter_button(
    FileType.AUDIO, True, "/filter", "#gallery"
)
html = to_xml(btn_elem)
assert "<button" in html
assert "btn-primary" in html  # Active
assert "Audio" in html
assert "hx-post" in html

# Test inactive button
btn_elem = render_type_filter_button(
    FileType.VIDEO, False, "/filter", "#gallery"
)
html = to_xml(btn_elem)
assert "btn-ghost" in html  # Inactive
assert "Video" in html

# Test with count
btn_elem = render_type_filter_button(
    FileType.IMAGE, True, "/filter", "#gallery", count=42
)
html = to_xml(btn_elem)
assert "42" in html
assert "badge" in html

print("render_type_filter_button tests passed!")
```

    render_type_filter_button tests passed!

------------------------------------------------------------------------

### render_type_filters

``` python

def render_type_filters(
    available_types:List, # File types to show buttons for
    active_types:List, # Currently active (shown) types
    filter_url:str, # URL for filter handler
    hx_target:Optional=None, # HTMX target for swap
    type_counts:Optional=None, # File counts per type
)->Any: # Type filter button group

```

*Render type filter buttons.*

``` python
# Test type filters
filters = render_type_filters(
    available_types=[FileType.AUDIO, FileType.VIDEO, FileType.IMAGE],
    active_types=[FileType.AUDIO, FileType.IMAGE],
    filter_url="/filter",
    hx_target="#gallery"
)
html = to_xml(filters)
assert "Audio" in html
assert "Video" in html
assert "Images" in html
# Should have 2 active and 1 inactive
assert html.count("btn-primary") == 2
assert html.count("btn-ghost") == 1

# Test with counts
filters = render_type_filters(
    available_types=[FileType.AUDIO, FileType.VIDEO],
    active_types=[FileType.AUDIO],
    filter_url="/filter",
    type_counts={FileType.AUDIO: 10, FileType.VIDEO: 5}
)
html = to_xml(filters)
assert "10" in html
assert "5" in html

print("render_type_filters tests passed!")
```

    render_type_filters tests passed!

## Gallery Controls Bar

Combined controls bar with view toggle and type filters.

------------------------------------------------------------------------

### render_gallery_controls

``` python

def render_gallery_controls(
    config:GalleryConfig, # Gallery configuration
    current_view:ViewMode, # Current view mode
    active_types:List, # Currently active type filters
    toggle_view_url:str, # URL for view toggle
    filter_url:str, # URL for type filter
    hx_target:Optional=None, # HTMX target
    type_counts:Optional=None, # File counts per type
    controls_id:Optional=None, # HTML ID for controls container
)->Any: # Controls bar component

```

*Render the gallery controls bar.*

``` python
# Test gallery controls
config = GalleryConfig()
controls = render_gallery_controls(
    config=config,
    current_view=ViewMode.GRID,
    active_types=[FileType.AUDIO, FileType.VIDEO, FileType.IMAGE, FileType.DOCUMENT],
    toggle_view_url="/toggle-view",
    filter_url="/filter",
    hx_target="#gallery",
    controls_id="gallery-controls"
)
html = to_xml(controls)
assert 'id="gallery-controls"' in html
assert 'class="join"' in html  # View toggle button group
assert "Audio" in html  # Type filters
assert "Video" in html

# Test with view toggle disabled
config_no_toggle = GalleryConfig(allow_view_toggle=False)
controls = render_gallery_controls(
    config=config_no_toggle,
    current_view=ViewMode.GRID,
    active_types=[FileType.AUDIO],
    toggle_view_url="/toggle-view",
    filter_url="/filter"
)
html = to_xml(controls)
assert 'class="join"' not in html  # No view toggle button group
assert "Audio" in html  # Type filters still present

print("render_gallery_controls tests passed!")
```

    render_gallery_controls tests passed!