Class DirectiveBinder

packages/compiler/src/render3/view/t2_binder.ts:562–995

* Processes a template and matches directives on nodes (elements and templates). * * Usually used via the static `apply()` method.

 * Usually used via the static `apply()` method.
 */
class DirectiveBinder<DirectiveT extends DirectiveMeta> implements Visitor {
  // Indicates whether we are visiting elements within a `defer` block
  private isInDeferBlock = false;

  private constructor(
    private directiveMatcher: DirectiveMatcher<DirectiveT> | null,
    private foreignMatcher: SelectorlessMatcher<ForeignComponentMeta> | null,
    private directives: MatchedDirectives<DirectiveT>,
    private foreignComponents: Map<Element, ForeignComponentMeta>,
    private eagerDirectives: DirectiveT[],
    private missingDirectives: Set<string>,
    private bindings: BindingsMap<DirectiveT>,
    private references: ReferenceMap<DirectiveT>,
    private conflictingHostDirectiveBindings: Map<
      DirectiveOwner,
      ConflictingHostDirectiveBinding<DirectiveT>[]
    >,
  ) {}

  /**
   * Process a template (list of `Node`s) and perform directive matching against each node.
   *
   * @param template the list of template `Node`s to match (recursively).
   * @param selectorMatcher a `SelectorMatcher` containing the directives that are in scope for
   * this template.
   * @returns three maps which contain information about directives in the template: the
   * `directives` map which lists directives matched on each node, the `bindings` map which
   * indicates which directives claimed which bindings (inputs, outputs, etc), and the `references`
   * map which resolves #references (`Reference`s) within the template to the named directive or
   * template node.
   */
  static apply<DirectiveT extends DirectiveMeta>(
    template: Node[],
    directiveMatcher: DirectiveMatcher<DirectiveT> | null,
    foreignMatcher: SelectorlessMatcher<ForeignComponentMeta> | null,
    directives: MatchedDirectives<DirectiveT>,
    foreignComponents: Map<Element, ForeignComponentMeta>,
    eagerDirectives: DirectiveT[],
    missingDirectives: Set<string>,
    bindings: BindingsMap<DirectiveT>,
    references: ReferenceMap<DirectiveT>,
    conflictingHostDirectiveBindings: Map<
      DirectiveOwner,
      ConflictingHostDirectiveBinding<DirectiveT>[]
    >,
  ): void {
    const matcher = new DirectiveBinder(
      directiveMatcher,
      foreignMatcher,
      directives,
      foreignComponents,
      eagerDirectives,
      missingDirectives,
      bindings,
      references,
      conflictingHostDirectiveBindings,
    );
    matcher.ingest(template);