GET STARTED

Import

Import only the standalone declarations used by the composition.

import {
  NeuralField,
  NeuralFieldControl,
  NeuralFieldError,
  NeuralFieldHint,
  NeuralFieldLabel,
} from '@neural-ng/core/field';

Basic composition

One stable controlId connects the label, native control and every description without handwritten IDs.

Angular Forms

Field owns accessible presentation only. Signal Forms, Reactive Forms and template-driven forms continue to own the actual value and validation lifecycle.

Inherited states

State is synchronized to visual hooks, data attributes, ARIA and compatible native attributes from one source.

Native control bridge

Use neuralFieldControl when a projected native or compatible custom control does not consume Field context directly.

Multiple descriptions

Multiple hints, errors and application-owned IDs are deduplicated into one reactive aria-describedby relationship.

Unstyled ownership

Visual classes disappear while structural hooks, generated IDs, ARIA relationships and native state propagation remain.

Relationships

neuralFieldLabel receives the control's for; hints and errors contribute IDs to aria-describedby. Conditional slots update the relationship reactively.

Deterministic IDs

Required controlId produces stable SSR and hydration-safe IDs: -hint, -error, then numbered suffixes for additional slots.

Error announcements

neuralFieldError defaults to polite announcements. Use assertive only for genuinely urgent feedback, or off when an application-level summary announces the same error.

Responsibility boundary

Field never owns values, executes validation, translates messages or decides when feedback becomes visible. Keep those decisions in the form schema and application policy.

Declarations

Field inputs

Directive inputs

Only NeuralFieldError adds an input: live: 'off' | 'polite' | 'assertive', defaulting to polite. Other directives derive their complete contract from Field context.

State and structural hooks

neural-field-root, neural-field--invalid, --required, --disabled, --readonly, --pending and the neural-field__* slot hooks remain available in styled and unstyled modes.

Design tokens