Class InElement<TValue, TElt>`Abstract`

HTML input element control.

It is also available as aspect of itself and converted controls with the same value.

Type Parameters

TValue

Input value type.
TElt = HTMLElement

A type of input HTML element.

Hierarchy

InControl<TValue>
- InElement
  - AbstractInElement

Index

Constructors

constructor

new InElement<TValue, TElt>(aspects?): InElement<TValue, TElt>
Constructs user input control.
Type Parameters
- TValue
- TElt = HTMLElement
Parameters
- aspects: {
  aspects?: Aspect<TValue, TValue> | readonly Aspect<TValue, TValue>[];
  } = {}
  
  Input aspects applied by default. These are aspect converters to constructed control from the same-valued one.
  - Optional Readonly aspects?: Aspect<TValue, TValue> | readonly Aspect<TValue, TValue>[]
Returns InElement<TValue, TElt>
Inherited from InControl.constructor
- Defined in frontmeans/input-aspects/src/control.ts:36

Properties

`Readonly` `Abstract` element

element: TElt

HTML input element this control is based on.

`Readonly` `Abstract` events

events: DomEventDispatcher

DOM event dispatcher of this element.

`Readonly` `Abstract` input

input: AfterEvent<[Input<TValue>]>

An AfterEvent keeper of user input.

`Abstract` it

it: TValue

Input value.

`Readonly` `Abstract` on

on: OnEvent<[TValue, TValue]>

OnEvent sender of value changes.

The [OnEvent__symbol] property is an alias of this one.

Returns

Value changes sender.

`Readonly` read

read: AfterEvent<[TValue]>

AfterEvent keeper of current value.

The [AfterEvent__symbol] property is an alias of this one.

Returns

Current value keeper.

Accessors

`Abstract` supply

get supply(): Supply
This control's input supply.

Releases all control resources when cut off.

Each control has its own supply. An input supply of converted control depends on the input supply of control it is converted from.

After this supply cut off the control should no longer be used.

Returns Supply
Inherited from InControl.supply
- Defined in frontmeans/input-aspects/src/control.ts:71

`Static` [InAspect__symbol]

get [InAspect__symbol](): InAspect<null | InElement<any, HTMLElement>, "element">
Returns InAspect<null | InElement<any, HTMLElement>, "element">
- Defined in frontmeans/input-aspects/src/element.control.ts:27

Methods

[AfterEvent__symbol]

[AfterEvent__symbol](): AfterEvent<[TValue]>
Returns AfterEvent<[TValue]>
Inherited from InControl.[AfterEvent__symbol]
- Defined in proc7ts/fun-events/dist/fun-events.d.ts:1609

[OnEvent__symbol]

[OnEvent__symbol](): OnEvent<[TValue, TValue]>
Returns OnEvent<[TValue, TValue]>
Inherited from InControl.[OnEvent__symbol]
- Defined in proc7ts/fun-events/dist/fun-events.d.ts:1605

`Protected` _applyAspect

_applyAspect<TInstance, TKind>(aspect): undefined | InAspect.Application.Result<TInstance, TValue, TKind>
Applies the given aspect to this control in a custom way.
Type Parameters
- TInstance
  
  Aspect instance type.
- TKind extends keyof InAspect.Application.Map<unknown, unknown>
  
  Aspect application kind.
Parameters
- aspect: InAspect<TInstance, TKind>
  
  An aspect to apply.
Returns undefined | InAspect.Application.Result<TInstance, TValue, TKind>
Either applied aspect instance or undefined to apply the aspect in standard way (i.e. using InAspect.applyTo() method).
Overrides InControl._applyAspect
- Defined in frontmeans/input-aspects/src/element.control.ts:46

aspect

aspect<TInstance, TKind>(aspectKey): ReturnType<InAspect.Application.Map<TInstance, TValue>[TKind]>
Retrieves an aspect instance applied to this control.

If the given aspect is not applied yet, then applies it first.
Type Parameters
- TInstance
  
  Aspect instance type.
- TKind extends keyof InAspect.Application.Map<unknown, unknown>
  
  Aspect application kind.
Parameters
- aspectKey: Key<TInstance, TKind>
  
  A key of aspect to apply to this control.
Returns ReturnType<InAspect.Application.Map<TInstance, TValue>[TKind]>
An applied aspect instance.
Inherited from InControl.aspect
- Defined in frontmeans/input-aspects/src/control.ts:84

by

by(supplier): InElement<TValue, TElt>
Updates the tracked value by the given value supplier.

If the value is already updated by another supplier, then unbinds from the old one first.

Call the byNone method to unbind the tracked value from the source.

Note that explicitly updating the value would override the value received from the source.
Parameters
- supplier: EventSupplier<[TValue]>
  
  The source value sender or keeper.
Returns InElement<TValue, TElt>
this instance.
Inherited from InControl.by
- Defined in proc7ts/fun-events/dist/fun-events.d.ts:1633
by<TSrcEvent>(supplier, extract): InElement<TValue, TElt>
Updates the tracked value by value suppliers extracted from events sent by the given supplier.

If the value is already updated by another value supplier, then unbinds from the old one first.

Call the byNone method to unbind the tracked value from the source.

Note that explicitly updating the value would override the value received from the source.
Type Parameters
- TSrcEvent extends any[]
  
  Source event type.
Parameters
- supplier: EventSupplier<TSrcEvent>
  
  The event supplier to extract value suppliers from.
- extract: ((this, ...event) => undefined | EventSupplier<[TValue]>)
  
  A function extracting value supplier from event received from supplier. May return undefined to suspend receiving values.
  - - (this, ...event): undefined | EventSupplier<[TValue]>
    - Parameters
      
      this: void
      
      Rest ...event: TSrcEvent
      
      Returns undefined | EventSupplier<[TValue]>
Returns InElement<TValue, TElt>
this instance.
Inherited from InControl.by
- Defined in proc7ts/fun-events/dist/fun-events.d.ts:1652

byNone

byNone(reason?): InElement<TValue, TElt>
Unbinds the tracked value from any value supplier this tracker is updated by.

If the tracker is not bound then does nothing.
Parameters
- Optional reason: unknown
  
  Arbitrary reason of unbinding the value.
Returns InElement<TValue, TElt>
this instance.
Inherited from InControl.byNone
- Defined in proc7ts/fun-events/dist/fun-events.d.ts:1664

convert

convert(...by): InControl<TValue>
Converts this control to another one without changing its value type.

The converted aspect may have another value and input aspects.
Parameters
- Rest ...by: Aspect<TValue, TValue>[]
  
  Input control aspect converters.
Returns InControl<TValue>
Converted control.
Inherited from InControl.convert
- Defined in frontmeans/input-aspects/src/control.ts:145
convert<TTo>(by, ...and): InControl<TTo>
Converts this control to another one.

The converted aspect may have another value and input aspects.
Type Parameters
- TTo
  
  Converted input value type.
Parameters
- by: InConverter<TValue, TTo>
  
  Input control converter.
- Rest ...and: Aspect<TValue, TTo>[]
  
  Additional input control aspect converters.
Returns InControl<TTo>
Converted control.
Inherited from InControl.convert
- Defined in frontmeans/input-aspects/src/control.ts:158

setup

setup(setup): InElement<TValue, TElt>
Performs additional setup of this control.
Parameters
- setup: ((this, control) => void)
  
  A function that accepts this control as its only parameter.
  - - (this, control): void
    - Parameters
      
      this: void
      
      control: InElement<TValue, TElt>
      
      Returns void
Returns InElement<TValue, TElt>
this control instance.
Inherited from InControl.setup
- Defined in frontmeans/input-aspects/src/control.ts:97
setup<TInstance, TKind>(aspectKey, setup): InElement<TValue, TElt>
Performs additional setup of this control's aspect.
Type Parameters
- TInstance
  
  Aspect instance type.
- TKind extends keyof InAspect.Application.Map<unknown, unknown>
  
  Aspect application kind.
Parameters
- aspectKey: Key<TInstance, TKind>
  
  A key of aspect to set up.
- setup: ((this, aspect, control) => void)
  
  A function that accepts an applied aspect instance and this control as parameters.
  - - (this, aspect, control): void
    - Parameters
      
      this: void
      
      aspect: ReturnType<InAspect.Application.Map<TInstance, TValue>[TKind]>
      
      control: InElement<TValue, TElt>
      
      Returns void
Returns InElement<TValue, TElt>
this control instance.
Inherited from InControl.setup
- Defined in frontmeans/input-aspects/src/control.ts:109

Class InElement<TValue, TElt>Abstract

Type Parameters

TValue

TElt = HTMLElement

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

TValue

TElt = HTMLElement

Parameters

aspects: { aspects?: Aspect<TValue, TValue> | readonly Aspect<TValue, TValue>[]; } = {}

Optional Readonly aspects?: Aspect<TValue, TValue> | readonly Aspect<TValue, TValue>[]

Returns InElement<TValue, TElt>

Properties

Readonly Abstract element

Readonly Abstract events

Readonly Abstract input

Abstract it

Readonly Abstract on

Returns

Readonly read

Returns

Accessors

Abstract supply

Returns Supply

Static [InAspect__symbol]

Returns InAspect<null | InElement<any, HTMLElement>, "element">

Methods

[AfterEvent__symbol]

Returns AfterEvent<[TValue]>

[OnEvent__symbol]

Returns OnEvent<[TValue, TValue]>

Protected _applyAspect

Type Parameters

TInstance

TKind extends keyof InAspect.Application.Map<unknown, unknown>

Parameters

aspect: InAspect<TInstance, TKind>

Returns undefined | InAspect.Application.Result<TInstance, TValue, TKind>

aspect

Type Parameters

TInstance

TKind extends keyof InAspect.Application.Map<unknown, unknown>

Parameters

aspectKey: Key<TInstance, TKind>

Returns ReturnType<InAspect.Application.Map<TInstance, TValue>[TKind]>

by

Parameters

supplier: EventSupplier<[TValue]>

Returns InElement<TValue, TElt>

Type Parameters

TSrcEvent extends any[]

Parameters

supplier: EventSupplier<TSrcEvent>

extract: ((this, ...event) => undefined | EventSupplier<[TValue]>)

Parameters

this: void

Rest ...event: TSrcEvent

Returns undefined | EventSupplier<[TValue]>

Returns InElement<TValue, TElt>

byNone

Parameters

Optional reason: unknown

Returns InElement<TValue, TElt>

convert

Parameters

Rest ...by: Aspect<TValue, TValue>[]

Returns InControl<TValue>

Type Parameters

TTo

Parameters

by: InConverter<TValue, TTo>

Rest ...and: Aspect<TValue, TTo>[]

Returns InControl<TTo>

Class InElement<TValue, TElt>`Abstract`

aspects: {
aspects?: Aspect<TValue, TValue> | readonly Aspect<TValue, TValue>[];
} = {}

`Optional` `Readonly` aspects?: Aspect<TValue, TValue> | readonly Aspect<TValue, TValue>[]

`Readonly` `Abstract` element

`Readonly` `Abstract` events

`Readonly` `Abstract` input

`Abstract` it

`Readonly` `Abstract` on

`Readonly` read

`Abstract` supply

`Static` [InAspect__symbol]

`Protected` _applyAspect

`Rest` ...event: TSrcEvent

`Optional` reason: unknown

`Rest` ...by: Aspect<TValue, TValue>[]

`Rest` ...and: Aspect<TValue, TTo>[]