Interface InteractionCmdBinder<C, I, A, D>

The binder API that already knows the type of UI command and the user interaction to use.

interface InteractionCmdBinder {
    bind(): Binding<C, I, A, D>;
    catch(fn): InteractionCmdBinder<C, I, A, D>;
    configureRules(ruleName, severity): InteractionCmdBinder<C, I, A, D>;
    end(fn): InteractionCmdBinder<C, I, A, D>;
    first(fn): InteractionCmdBinder<C, I, A, D>;
    ifCannotExecute(fn): InteractionCmdBinder<C, I, A, D>;
    ifHadEffects(fn): InteractionCmdBinder<C, I, A, D>;
    ifHadNoEffect(fn): InteractionCmdBinder<C, I, A, D>;
    log(...level): InteractionCmdBinder<C, I, A, D>;
    name(name): InteractionCmdBinder<C, I, A, D>;
    on<W>(widget, ...widgets): InteractionCmdBinder<C, I, A, D>;
    onDynamic(node): InteractionCmdBinder<C, I, A, D>;
    preventDefault(): InteractionCmdBinder<C, I, A, D>;
    stopImmediatePropagation(): InteractionCmdBinder<C, I, A, D>;
    when(fn, mode?): InteractionCmdBinder<C, I, A, D>;
}

Type Parameters

C extends Command
The type of the produced UI commands
I extends Interaction<D>
The type of the user interaction
A
D extends InteractionData = InteractionDataType<I>
The type of the interaction data of the user interaction

Hierarchy

CmdBinderBuilder<C>
InteractionBinderBuilder<I, A, D>
- InteractionCmdBinder
  - InteractionCmdUpdateBinder
  - KeyInteractionCmdBinder

Implemented by

Binder

Index

Methods

bind catch configureRules end first ifCannotExecute ifHadEffects ifHadNoEffect log name on onDynamic preventDefault stopImmediatePropagation when

Methods

bind

bind(): Binding<C, I, A, D>
Executes the binder to create and install an Interacto binding.

Returns Binding<C, I, A, D>
- Defined in api/binder/InteractionCmdBinder.ts:98

catch

catch(fn): InteractionCmdBinder<C, I, A, D>
Allows the processing of errors during the execution of the binding. Errors reported here are errors thrown in arrow functions provided to the the different routines of the binder and errors triggered by the command. A binder can have several cummulative 'catch' routines.
Parameters
- fn: ((ex) => void)
  The function to process the error caught by the binding during its execution
  - - (ex): void
    - Parameters
      ex: unknown
      Returns void
Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.catch
- Defined in api/binder/InteractionCmdBinder.ts:89

configureRules

configureRules(ruleName, severity): InteractionCmdBinder<C, I, A, D>
Configures a linter rule specifically for the binding.
Parameters
- ruleName: RuleName
  The name of the rule.
- severity: Severity
  The severity level of the rule.
Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.configureRules
- Defined in api/binder/InteractionCmdBinder.ts:93

end

end(fn): InteractionCmdBinder<C, I, A, D>
Specifies what to do end when an interaction ends (when the last event of the interaction has occurred, but just after the interaction is reinitialised and the command finally executed and discarded / saved). A binder can have several cummulative 'end' routines.
Parameters
- fn: ((c, i, acc) => void)
  The callback method to specify what to do when an interaction ends.
  - - (c, i, acc): void
    - Parameters
      c: C
      i: D
      acc: A
      Returns void
Returns InteractionCmdBinder<C, I, A, D>
The binder to chain the building configuration.
Overrides InteractionBinderBuilder.end
- Defined in api/binder/InteractionCmdBinder.ts:75

first

first(fn): InteractionCmdBinder<C, I, A, D>
Specifies the initialisation of the command when the interaction starts. Each time the interaction starts, an instance of the command is created and configured by the given callback. A binder can have several cummulative 'first' routines.
Parameters
- fn: ((c, i, acc) => void)
  The callback method that initialises the command. This callback takes as arguments both the command and interaction data involved in the binding.
  - - (c, i, acc): void
    - Parameters
      c: C
      i: D
      acc: A
      Returns void
Returns InteractionCmdBinder<C, I, A, D>
The binder to chain the building configuration.
Overrides CmdBinderBuilder.first
- Defined in api/binder/InteractionCmdBinder.ts:42

ifCannotExecute

ifCannotExecute(fn): InteractionCmdBinder<C, I, A, D>
Specifies what to do end when an interaction ends and the command could not be executed. A binder can have several cummulative 'ifCannotExecute' routines.
Parameters
- fn: ((c, i, acc) => void)
  The callback method to specify what to do when an interaction ends and the command could not be executed.
  - - (c, i, acc): void
    - Parameters
      c: C
      i: D
      acc: A
      Returns void
Returns InteractionCmdBinder<C, I, A, D>
The binder to chain the building configuration.
- Defined in api/binder/InteractionCmdBinder.ts:66

ifHadEffects

ifHadEffects(fn): InteractionCmdBinder<C, I, A, D>
Specifies what to do end when an interaction ends (after the end/endOrCancel routines) and the command has produced an effect. A binder can have several cummulative 'ifHadEffects' routines.
Parameters
- fn: ((c, i, acc) => void)
  The callback method to specify what to do when an interaction ends and the command produced an effect.
  - - (c, i, acc): void
    - Parameters
      c: C
      i: D
      acc: A
      Returns void
Returns InteractionCmdBinder<C, I, A, D>
The binder to chain the building configuration.
- Defined in api/binder/InteractionCmdBinder.ts:50

ifHadNoEffect

ifHadNoEffect(fn): InteractionCmdBinder<C, I, A, D>
Specifies what to do end when an interaction ends (after the end/endOrCancel routines) and the command did not produce an effect. A binder can have several cummulative 'ifHadNoEffect' routines.
Parameters
- fn: ((c, i, acc) => void)
  The callback method to specify what to do when an interaction ends and the command did not produce an effect.
  - - (c, i, acc): void
    - Parameters
      c: C
      i: D
      acc: A
      Returns void
Returns InteractionCmdBinder<C, I, A, D>
The binder to chain the building configuration.
- Defined in api/binder/InteractionCmdBinder.ts:58

log

log(...level): InteractionCmdBinder<C, I, A, D>
Specifies the logging level to use. A binder can have several cummulative 'log' routines, eg: log(LogLevel.INTERACTION).log(LogLevel.COMMAND)
Parameters
- Rest ...level: readonly LogLevel[]
  The logging level to use.
Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.log
- Defined in api/binder/InteractionCmdBinder.ts:81

name

name(name): InteractionCmdBinder<C, I, A, D>
Specifies the name of the Interacto binding. This name will be used in the logging system. It should be unique, but no mechanism will check that.
Parameters
- name: string
  The name of the binding
Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.name
- Defined in api/binder/InteractionCmdBinder.ts:91

on

on<W>(widget, ...widgets): InteractionCmdBinder<C, I, A, D>
Specifies the widgets on which the binding will operate. When a widget is added to this list, this widget is binded to this binding. When widget is removed from this list, this widget is unbinded from this binding.
Type Parameters
- W
Parameters
- widget: Widget<W> | readonly Widget<W>[]
  The mandatory first widget
- Rest ...widgets: readonly Widget<W>[]
  The list of the widgets involved in the bindings.
Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.on
- Defined in api/binder/InteractionCmdBinder.ts:77

onDynamic

onDynamic(node): InteractionCmdBinder<C, I, A, D>
Specifies the node the binding will observe its children. The binding observes its children list, so that additions and removals from it are managed by the binding.
Parameters
- node: Widget<Node>
  The binding will observe the children of this node.
Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.onDynamic
- Defined in api/binder/InteractionCmdBinder.ts:79

preventDefault

preventDefault(): InteractionCmdBinder<C, I, A, D>
The default behavior associated to the event will be ignored.

Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.preventDefault
- Defined in api/binder/InteractionCmdBinder.ts:87

stopImmediatePropagation

stopImmediatePropagation(): InteractionCmdBinder<C, I, A, D>
If called, all the events the interaction will process will be consumed and not propagated to next listeners.

Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.stopImmediatePropagation
- Defined in api/binder/InteractionCmdBinder.ts:85

when

when(fn, mode?): InteractionCmdBinder<C, I, A, D>
Specifies the conditions to fulfill to initialise, update, or execute the command while the interaction is running. A binder can have several cummulative 'when' routines.
Parameters
- fn: ((i, acc) => boolean)
  The predicate that checks whether the command can be initialised, updated, or executed.
  - - (i, acc): boolean
    - Parameters
      i: D
      acc: Readonly<A>
      Returns boolean
- Optional mode: WhenType
  The execution mode of the 'when' predicate. If not defined, the non-strict mode will be used.
Returns InteractionCmdBinder<C, I, A, D>
A clone of the current binder to chain the building configuration.
Overrides InteractionBinderBuilder.when
- Defined in api/binder/InteractionCmdBinder.ts:83

Interface InteractionCmdBinder<C, I, A, D>

Type Parameters

C extends Command

I extends Interaction<D>

A

D extends InteractionData = InteractionDataType<I>

Hierarchy

Implemented by

Index

Methods

Methods

bind

Returns Binding<C, I, A, D>

catch

Parameters

fn: ((ex) => void)

Parameters

ex: unknown

Returns void

Returns InteractionCmdBinder<C, I, A, D>

configureRules

Parameters

ruleName: RuleName

severity: Severity

Returns InteractionCmdBinder<C, I, A, D>

end

Parameters

fn: ((c, i, acc) => void)

Parameters

c: C

i: D

acc: A

Returns void

Returns InteractionCmdBinder<C, I, A, D>

first

Parameters

fn: ((c, i, acc) => void)

Parameters

c: C

i: D

acc: A

Returns void

Returns InteractionCmdBinder<C, I, A, D>

ifCannotExecute

Parameters

fn: ((c, i, acc) => void)

Parameters

c: C

i: D

acc: A

Returns void

Returns InteractionCmdBinder<C, I, A, D>

ifHadEffects

Parameters

fn: ((c, i, acc) => void)

Parameters

c: C

i: D

acc: A

Returns void

Returns InteractionCmdBinder<C, I, A, D>

ifHadNoEffect

Parameters

fn: ((c, i, acc) => void)

Parameters

c: C

i: D

acc: A

Returns void

Returns InteractionCmdBinder<C, I, A, D>

log

Parameters

Rest ...level: readonly LogLevel[]

Returns InteractionCmdBinder<C, I, A, D>

name

Parameters

name: string

Returns InteractionCmdBinder<C, I, A, D>

on

Type Parameters

`Rest` ...level: readonly LogLevel[]

`Rest` ...widgets: readonly Widget<W>[]

`Optional` mode: WhenType