Struct RowScope 

pub struct RowScope<'a> { /* private fields */ }

A single row’s rendering scope inside inputs_for.

Each scope binds the child collection name, the row’s 0-based index, and (for existing/submitted rows) the underlying NestedRow so its raw values pre-fill inputs and its per-subfield errors render inline on re-render after a failed submission. A blank template row carries row: None — its inputs render empty with no error blocks.

The row-scoped input builders mirror the standalone field helpers in crate::form (text_input, number_input, …) but emit nested input names (items[{index}][{sub}]) and per-row-unique element ids (items-{index}-{sub}) so ids and aria-describedby links stay unique across repeated rows.

Implementations

impl RowScope<'_>

pub const fn index(&self) -> usize

This row’s 0-based position in the collection.

pub fn field_name(&self, sub: &str) -> String

The nested input name for subfield sub, i.e. "{collection}[{index}][{sub}]".

pub fn value(&self, sub: &str) -> Option<&str>

The raw submitted value for subfield sub, or None for a blank row.

pub fn errors_for(&self, sub: &str) -> &[String]

Validation messages for subfield sub, or an empty slice (always empty for a blank row).

pub fn is_destroyed(&self) -> bool

true when this (existing) row carried a truthy _destroy marker.

pub fn text_input(&self, sub: &str, label: &str) -> Markup

Render a labeled row-scoped <input type="text"> for subfield sub.

Mirrors crate::form::text_input: autumn-field wrapper, per-row pre-fill, aria-invalid / aria-describedby, and a role="alert" error block — but with the nested name and a per-row-unique id.

pub fn required_text_input(&self, sub: &str, label: &str) -> Markup

Like RowScope::text_input but adds required + aria-required="true" — only for real/submitted rows that are not marked for destruction (self.row.is_some() && !self.is_destroyed()).

A blank template row (row: None, the one inputs_for auto-appends for the no-JS “add a child” path) deliberately renders the same input without the client-side required/aria-required attributes so it stays leaveable-empty. Otherwise the browser’s native constraint validation would block form submit on the empty trailing template row before the server’s all-blank rejection can run — a user who filled one child row could not submit while a blank row sat beneath it. A submitted row the user ticked _destroy on is skipped for the same reason: the decoder drops destroyed rows before validation (and from into_valid()), so re-emitting client-side required on an empty destroyed field would let the browser block the next submit before the server can honor the removal. Required-ness is still enforced server-side for any row the user actually engages: a partially-filled, non-destroyed row is retained as a Some row on re-render and re-acquires required, and the decoder’s all-blank rejection drops the untouched template row. This composes with that all-blank rejection so neither the client nor the server treats the template row as a real child.

pub fn number_input(&self, sub: &str, label: &str) -> Markup

Render a labeled row-scoped <input type="number"> for subfield sub.

Mirrors crate::form::number_input (leaving the browser-default step), with the nested name and a per-row-unique id.

pub fn textarea_input(&self, sub: &str, label: &str) -> Markup

Render a labeled row-scoped <textarea> for subfield sub.

Mirrors crate::form::textarea_input: the value is emitted as the element body, with the nested name and a per-row-unique id.

pub fn hidden_input(&self, sub: &str, value: &str) -> Markup

Render a row-scoped <input type="hidden"> for subfield sub.

Use this to carry an existing child’s primary key (e.g. id) on an edit form so the decoder can match the submitted row back to a persisted record.

pub fn destroy_checkbox(&self, label: &str) -> Markup

Render the durable no-JS removal control: a _destroy checkbox whose checked state is preserved on re-render (checked iff RowScope::is_destroyed).

The decoder honours a truthy _destroy marker (decode_nested_urlencoded), so ticking this box and submitting the surrounding form removes the row with no JavaScript. htmx/JS row removal (swapping the .nested-fields__row node’s outerHTML) is an optional progressive enhancement layered on top; this checkbox is the required mechanism.