Control<T> class

Defines a part of a form that cannot be divided into other controls. Controls have values and validation state, which is determined by an optional validation function.

Control is one of the three fundamental building blocks used to define forms in Angular, along with ControlGroup and ControlArray.

Usage

By default, a Control is created for every <input> or other form component. With NgFormControl or NgFormModel an existing Control can be bound to a DOM element instead. This Control can be configured with a custom validation function.

Inheritance

Constructors

Control([dynamic value, ValidatorFn validator ])

Properties

rawValue → String
If value was coerced from a HTML element this is the original value from that element. [...]
read-only
dirty → bool
read-only, inherited
disabled → bool
read-only, inherited
disabledChanges → Stream<bool>
read-only, inherited
enabled → bool
read-only, inherited
errors → Map<String, dynamic>
Returns the errors of this control.
read-only, inherited
hashCode → int
The hash code for this object. [...]
read-only, inherited
invalid → bool
read-only, inherited
pending → bool
read-only, inherited
pristine → bool
read-only, inherited
root AbstractControl
read-only, inherited
runtimeType → Type
A representation of the runtime type of the object.
read-only, inherited
status → String
The validation status of the control.
read-only, inherited
statusChanges → Stream<String>
read-only, inherited
touched → bool
read-only, inherited
untouched → bool
read-only, inherited
valid → bool
read-only, inherited
validator ValidatorFn
read / write, inherited
value → T
read-only, inherited
valueChanges → Stream<T>
read-only, inherited

Methods

onUpdate() → void
Callback when control is asked to update it's value. [...]
override
registerOnChange(Function fn) → void
Register a listener for change events. [...]
updateValue(T value, { bool onlySelf, bool emitEvent, bool emitModelToViewChange, String rawValue }) → void
Set the value of the control to value. [...]
override
find(String path) AbstractControl
Walks the path supplied to find matching control. [...]
inherited
findPath(List<String> path) AbstractControl
Walks the path to find the matching control. [...]
inherited
getError(String errorCode, [ List<String> path ]) → dynamic
inherited
hasError(String errorCode, [ List<String> path ]) → bool
inherited
markAsDirty({bool onlySelf, bool emitEvent }) → void
Mark the control as dirty. [...]
inherited
markAsDisabled({bool updateParent, bool emitEvent }) → void
Disables the control. This means the control will be exempt from validation checks and excluded from the aggregate value of any parent. Its status is DISABLED. [...]
inherited
markAsEnabled({bool updateParent, bool emitEvent }) → void
Enables the control. This means the control will be included in validation checks and the aggregate value of its parent. Its status is re-calculated based on its value and its validators. [...]
inherited
markAsPending({bool onlySelf }) → void
inherited
markAsPristine({bool updateParent }) → void
Marks the control as pristine. [...]
inherited
markAsTouched({bool updateParent }) → void
Marks the control as touched. [...]
inherited
markAsUntouched({bool updateParent }) → void
Marks the control as untouched. [...]
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
reset({T value, bool isDisabled, bool updateParent, bool emitEvent }) → void
Resets the form control. [...]
inherited
setErrors(Map<String, dynamic> errors, { bool emitEvent }) → void
Sets errors on a control. [...]
inherited
setParent(AbstractControl parent) → void
inherited
toString() → String
Returns a string representation of this object.
inherited
updateValueAndValidity({bool onlySelf, bool emitEvent }) → void
inherited

Operators

operator ==(dynamic other) → bool
The equality operator. [...]
inherited