audio_controls

Audio playback controls: speed selector and auto-navigate toggle

HTML IDs

HTML ID constants for audio control elements.

AudioControlIds


def AudioControlIds(
    args:VAR_POSITIONAL, kwargs:VAR_KEYWORD
):

HTML ID constants for audio control elements.

Speed Selector Config

The speed selector itself is provided by cjm_fasthtml_web_audio.components.render_speed_selector. We only need a minimal WebAudioConfig here (namespace + enable_speed=True) to drive its namespace-derived IDs and window.setReviewSpeed / window.cycleReviewSpeed* wiring.

Defined locally (rather than reusing REVIEW_AUDIO_CONFIG from components.callbacks) to avoid a circular import — callbacks imports symbols from this module.

Auto-Navigate Toggle

Toggle switch to enable automatic navigation to next segment when audio playback completes.

render_auto_navigate_toggle


def render_auto_navigate_toggle(
    enabled:bool=False, # Whether auto-navigate is enabled
)->Any: # Auto-navigate toggle component

Render auto-navigate toggle switch (client-side only, no server persistence).

Combined Audio Controls

Renders both speed selector and auto-navigate toggle in a single component.

render_audio_controls


def render_audio_controls(
    current_speed:float=1.0, # Current playback speed
    auto_navigate:bool=False, # Whether auto-navigate is enabled
    speed_url:str='', # URL for speed changes
    oob:bool=False, # Whether to render as OOB swap
)->Any: # Combined audio controls component

Render combined audio controls (speed selector + auto-navigate toggle).

from fasthtml.common import to_xml
import re

# Container delegates speed selector to cjm-fasthtml-web-audio's render_speed_selector.
# Verify the container wires the library correctly at the integration boundary:
# namespace-derived IDs/functions present, persisted speed flows through, OOB attr applied.

html_default = to_xml(render_audio_controls(current_speed=1.0, auto_navigate=False))
assert 'sd-review-speed-select' in html_default   # Library-derived ID
assert 'setReviewSpeed' in html_default            # Library-derived onchange JS
assert 'sd-review-auto-nav-toggle' in html_default
assert 'sd-review-audio-controls' in html_default
assert 'hx-post' not in html_default               # speed_url empty → no HTMX
assert 'setReviewSpeed(1.0)' not in html_default   # speed==1.0 → sync script is no-op

html_wired = to_xml(render_audio_controls(current_speed=2.0, auto_navigate=True, speed_url="/x/speed"))
assert 'hx-post="/x/speed"' in html_wired
assert 'hx-trigger="change"' in html_wired
assert 'setReviewSpeed(2.0)' in html_wired  # Initial sync script
assert re.search(r'<option[^>]*value="2.0"[^>]*selected', html_wired)

html_oob = to_xml(render_audio_controls(auto_navigate=True, oob=True))
assert 'hx-swap-oob' in html_oob
assert 'sd-review-audio-controls' in html_oob

print('Review audio controls tests passed')

Review audio controls tests passed