# Hidden Inputs


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

## Zone Data Inputs

Generate hidden inputs for tracking focused item data attributes.

The `name` attribute converts hyphens to underscores for Python/FastHTML
compatibility: - HTML data attribute: `data-item-id` - Hidden input
name: `item_id` - FastHTML route parameter: `item_id`

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

<a
href="https://github.com/cj-mills/cjm-fasthtml-keyboard-navigation/blob/main/cjm_fasthtml_keyboard_navigation/htmx/inputs.py#L18"
target="_blank" style="float:right; font-size:smaller">source</a>

### render_zone_hidden_inputs

``` python

def render_zone_hidden_inputs(
    zone:FocusZone, # the focus zone configuration
)->list: # list of Hidden input components

```

*Render hidden inputs for a single zone’s data attributes.*

``` python
# Test zone inputs
from fasthtml.common import to_xml

zone = FocusZone(
    id="browser",
    item_selector="tr",
    data_attributes=("job-id", "plugin-name")
)

inputs = render_zone_hidden_inputs(zone)
assert len(inputs) == 2

html = to_xml(inputs[0])
assert 'id="browser-job-id"' in html
# Name converts hyphens to underscores for Python compatibility
assert 'name="job_id"' in html
```

## Manager Hidden Inputs

Generate all hidden inputs for a ZoneManager.

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

<a
href="https://github.com/cj-mills/cjm-fasthtml-keyboard-navigation/blob/main/cjm_fasthtml_keyboard_navigation/htmx/inputs.py#L31"
target="_blank" style="float:right; font-size:smaller">source</a>

### render_hidden_inputs

``` python

def render_hidden_inputs(
    manager:ZoneManager, # the zone manager configuration
    include_state:bool=False, # include state tracking inputs
    container_id:str='kb-hidden-inputs', # container element ID
)->Div: # container with all hidden inputs

```

*Render all hidden inputs for keyboard navigation.*

Deduplicates inputs by ID - zones with the same hidden_input_prefix will
share inputs rather than creating duplicates.

``` python
# Test manager inputs
from cjm_fasthtml_keyboard_navigation.core.manager import ZoneManager

zone1 = FocusZone(id="z1", data_attributes=("a",))
zone2 = FocusZone(id="z2", data_attributes=("b", "c"))

manager = ZoneManager(zones=(zone1, zone2))
container = render_hidden_inputs(manager)

html = to_xml(container)
assert 'id="kb-hidden-inputs"' in html
assert 'id="z1-a"' in html
assert 'id="z2-b"' in html
assert 'id="z2-c"' in html
```

``` python
# Test deduplication - zones with same prefix share inputs
zone_browser = FocusZone(
    id="browser",
    item_selector="tr",
    data_attributes=("job-id", "plugin-name"),
    hidden_input_prefix="sd-focused"
)
zone_queue = FocusZone(
    id="queue",
    item_selector="li",
    data_attributes=("job-id", "plugin-name"),
    hidden_input_prefix="sd-focused"  # Same prefix as browser
)

manager_shared = ZoneManager(zones=(zone_browser, zone_queue))
container = render_hidden_inputs(manager_shared)

html = to_xml(container)
# Should only have 2 inputs (deduplicated), not 4
assert html.count('id="sd-focused-job-id"') == 1
assert html.count('id="sd-focused-plugin-name"') == 1
assert html.count('<input') == 2
```

``` python
# Test with state inputs
container = render_hidden_inputs(manager, include_state=True)
html = to_xml(container)
assert 'id="kb-active-zone"' in html
assert 'id="kb-current-mode"' in html
```

## Include Selector Builder

Build `hx-include` selector for HTMX requests.

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

<a
href="https://github.com/cj-mills/cjm-fasthtml-keyboard-navigation/blob/main/cjm_fasthtml_keyboard_navigation/htmx/inputs.py#L68"
target="_blank" style="float:right; font-size:smaller">source</a>

### build_include_selector

``` python

def build_include_selector(
    zone:FocusZone, # the zone to include inputs from
    include_state:bool=False, # include state inputs
)->str: # CSS selector for hx-include

```

*Build hx-include selector for zone’s hidden inputs.*

``` python
# Test include selector
zone = FocusZone(
    id="browser",
    data_attributes=("job-id", "plugin-name")
)

selector = build_include_selector(zone)
assert selector == "#browser-job-id, #browser-plugin-name"

selector_with_state = build_include_selector(zone, include_state=True)
assert "#kb-active-zone" in selector_with_state
```

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

<a
href="https://github.com/cj-mills/cjm-fasthtml-keyboard-navigation/blob/main/cjm_fasthtml_keyboard_navigation/htmx/inputs.py#L88"
target="_blank" style="float:right; font-size:smaller">source</a>

### build_all_zones_include_selector

``` python

def build_all_zones_include_selector(
    manager:ZoneManager, # the zone manager
    include_state:bool=False, # include state inputs
)->str: # CSS selector for all zones

```

*Build hx-include selector for all zones’ hidden inputs.*

Deduplicates selectors - zones with the same hidden_input_prefix will
only include each input once.

``` python
# Test all zones selector
selector = build_all_zones_include_selector(manager)
assert "#z1-a" in selector
assert "#z2-b" in selector
assert "#z2-c" in selector
```

``` python
# Test deduplication in selector - zones with same prefix
selector = build_all_zones_include_selector(manager_shared)
# Should only have 2 selectors (deduplicated), not 4
assert selector.count("#sd-focused-job-id") == 1
assert selector.count("#sd-focused-plugin-name") == 1
assert selector == "#sd-focused-job-id, #sd-focused-plugin-name"
```