MapInput<K, V, E> class abstract

Inheritance

• Object
• FormInput<Map<K, V>, E>
• MapInput

Implementers

• SimpleMapInput

Constructors

MapInput.fromData(InputData<Map<K, V>, E> data)

MapInput.touched({Map<K, V> value = const {}, Map<K, V>? initialValue, ValidationMode mode = ValidationMode.live, E? errorCache, E? remoteError})

const

MapInput.untouched({Map<K, V> value = const {}, ValidationMode mode = ValidationMode.live, E? errorCache})

const

Properties

asyncValidators → List<AsyncValidator<Map<K, V>, E>>

Asynchronous validators run via InputMixin.runBuiltInAsyncValidation.

no setter, inherited

currentRemoteError → E?

no setter, inherited

detailedErrors → List<E>

ALL validation errors for the current value — bypasses the cache. Use for password-strength meters or multi-requirement checklists.

no setter, inherited

error → E?

Remote errors take precedence over local ones.

no setter, inherited

hashCode → int

The hash code for this object.

no setter, inherited

initialValue → Map<K, V>

final, inherited

isDirty → bool

True when the current value differs from initialValue.

no setter, inherited

isNotValid → bool

no setter, inherited

isPristine → bool

True when the current value equals the initialValue (user has not changed the field from its starting state).

no setter, inherited

isTouched → bool

no setter, inherited

isUntouched → bool

no setter, inherited

isValid → bool

no setter, inherited

isValidating → bool

no setter, inherited

localError → E?

no setter, inherited

mode → ValidationMode

final, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

sanitizers → List<Sanitizer<Map<K, V>>>

no setter, inherited

status → InputStatus

final, inherited

validators → List<Validator<Map<K, V>, E>>

Synchronous validators run against value.

no setter, inherited

value → Map<K, V>

final, inherited

valueSanitizers → List<Sanitizer<V>>

Sanitizers applied to every individual value in the map.

no setter

valueValidators → List<Validator<V, E>>

Validators applied to every individual value in the map.

no setter

Methods

displayError(SubmissionStatus status) → E?

Resolves the error to show in the UI based on SubmissionStatus and ValidationMode.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

prepareUpdate({Map<K, V>? value, InputStatus? status, ValidationMode? mode, E? remoteError}) → InputData<Map<K, V>, E>

⚠️ Known limitation: when T is nullable (e.g., DateTime?), passing value: null is indistinguishable from omitting value. Use InputMixin.reset to revert a nullable field to its initial value.

inherited

putItem(K key, V item) → MapInput<K, V, E>

Inserts or replaces the entry at key with item, runs valueSanitizers on the item, and marks the input as touched.

removeItem(K key) → MapInput<K, V, E>

Removes the entry at key and marks the input as touched. Returns this unchanged if key is not present.

sanitize(Map<K, V> value) → Map<K, V>

Sanitizes each value through valueSanitizers after running map-level sanitizers from sanitizers.

override

toString() → String

A string representation of this object.

inherited

update({Map<K, V>? value, InputStatus? status, ValidationMode? mode, E? remoteError}) → MapInput<K, V, E>

override

validate(Map<K, V> value) → E?

Validates the map structure first, then each value individually.

override

validateAsync(Map<K, V> value) → Future<E?>

inherited

valueErrorAt(K key) → E?

Returns the validation error for the value at key, or null if the key does not exist or the value is valid.

Operators

operator ==(Object other) → bool

The equality operator.

inherited