RazorWire JavaScript API

Enables RazorWire form failure handling on a form.

data-rw-form

• Target: form
• Type: {"true"}

Enables RazorWire loading feedback and loading-layer duplicate prevention for an `rw-active` form.

Enables RazorWire loading feedback and loading-layer duplicate prevention for an `rw-active` form. The form Tag Helper emits `data-rw-loading="true"` when global loading is enabled. Set it to `off` to opt out of the whole loading layer for that form; failure handling is independent.

data-rw-loading

• Target: form[rw-active]
• Type: {"true"|"off"}
• Default: true

Overrides the global duplicate-submission setting for one enabled loading form.

Overrides the global duplicate-submission setting for one enabled loading form. `false` permits overlapping submissions; `true` keeps the same-form guard active. Other values use the global setting. This browser guard does not provide server-side idempotency, and direct `form.submit()` bypasses it.

data-rw-loading-lock

• Target: form[rw-active]
• Type: {"true"|"false"}
• Default: true

Declares a loading-indicator ownership boundary. The marker is presence-only; any value declares a boundary. An indicator belongs to its nearest boundary, and enabled forms search their ancestor boundaries from nearest outward.

data-rw-loading-boundary

• Target: ancestor element containing an enabled form and its indicators
• Type: {presence-only}

Marks app-authored status content that RazorWire may reveal for a pending form.

Marks app-authored status content that RazorWire may reveal for a pending form. Start it hidden and provide visible action text plus status semantics such as `role="status"` and `aria-live="polite"`. RazorWire toggles only the `hidden` state; the app owns the message and presentation.

data-rw-loading-indicator

• Target: app-authored element owned by an applicable loading boundary
• Type: {presence-only}

Runtime state hook set to `pending` on an active form and its selected boundary.

Runtime state hook set to `pending` on an active form and its selected boundary. RazorWire snapshots and restores the previous value. Do not author this state as a control input.

data-rw-loading-state

• Target: enabled form or selected loading boundary
• Type: {"pending"}

Marks a same-page navigation root that RazorWire should enhance.

data-rw-page-nav

• Target: nav, aside, div
• Type: {"true"}

Marks an optional root that scopes section-copy status, generated buttons, feedback timers, and cleanup.

data-rw-section-copy-root

• Target: section, article, main, div
• Type: {"true"}

Marks a button that copies a section permalink for the referenced target id.

data-rw-section-copy

• Target: button
• Type: {string}

Provides reader-facing section title copy for `aria-label`, live status, and fallback dialog labels.

data-rw-section-copy-title

• Target: button[data-rw-section-copy], [data-rw-section-copy-target]
• Type: {string}

Marks an optional live status region for section-copy feedback.

data-rw-section-copy-status

• Target: span, div
• Type: {"true"}

Marks a heading or section container that should receive a generated plain-text copy button.

data-rw-section-copy-target

• Target: h1, h2, h3, h4, h5, h6, header, section, div
• Type: {"true"}

Marks an anchor as a RazorWire same-page navigation link.

data-rw-page-nav-link

• Target: a
• Type: {"true"}

Marks a button that toggles the optional page navigation panel.

data-rw-page-nav-toggle

• Target: button
• Type: {"true"}

Marks the optional panel that should close after successful same-page navigation.

data-rw-page-nav-panel

• Target: div, nav, ul
• Type: {"true"}

Selects how RazorWire renders unhandled form failures.

data-rw-form-failure

• Target: form[data-rw-form="true"]
• Type: {"auto"|"manual"|"off"}
• Default: auto

Names the browser module that should hydrate an island root.

data-rw-module

• Target: [data-rw-module]
• Type: {string}

Local unresolved row token for a model-bound collection template.

data-rw-form-collection-index-token

• Target: [data-rw-form-collection]
• Type: {string}
• Default: __index__

Marks a control that reveals or hides conditional form targets inside the same form.

data-rw-form-toggle

• Target: input, select, textarea, button
• Type: {string}

Marks an app-authored target revealed or hidden by a matching form toggle.

data-rw-form-toggle-target

• Target: fieldset, section, div
• Type: {string}

Marks an ASP.NET Core model-bound collection root, scoped to its owning row when nested.

data-rw-form-collection

• Target: div, section, fieldset
• Type: {string}

Marks an app-authored collection row.

data-rw-form-collection-row

• Target: fieldset, div, tr
• Type: {"true"}

Marks the app-authored row template with owned binding names using its collection's local index token, default `__index__`. Nested templates require an enabled hidden `.index` marker with that token; legacy top-level templates may omit it when a correctly prefixed owned field exists. Display text or unrelated attributes do not satisfy template validation.

data-rw-form-collection-template

• Target: template
• Type: {"true"}

Marks a button that adds a row from the collection template.

data-rw-form-collection-add

• Target: button
• Type: {"true"}

Marks a button that duplicates the nearest collection row.

data-rw-form-collection-duplicate

• Target: button
• Type: {"true"}

Marks a button that physically removes or marks the nearest collection row.

data-rw-form-collection-remove

• Target: button
• Type: {"physical"|"mark"|"true"}

Selects when an island module hydrates.

data-rw-strategy

• Target: [data-rw-module]
• Type: {"load"|"idle"|"visible"|"only"}
• Default: load

JSON props passed to an island module's mount function.

data-rw-props

• Target: [data-rw-module]
• Type: {string}