d3.js - Förstå Typescript-definition

Från @types/d3-definitionen har vi raderna:

export type ValueFn<T extends BaseType, Datum, Result> = (this: T, datum: Datum, index: number, groups: T[] | ArrayLike<T>) => Result;

attrTween(name: string): ValueFn<GElement, Datum, (t: number) => string> | undefined;

När jag använder funktionen attrTween använder jag den så här :

caller.attrTween("points", (d, index, groups) => { return (t) => {return "";};  }

I vilken anropare är Transition<BaseType, PieArcDatum<number>

Dessa parametrar härleds av VSCode som:

(parameter) d: d3.PieArcDatum<number>
(parameter) index: number
(parameter) groups: d3.BaseType[] | d3.ArrayLike<d3.BaseType>

Hur säkerställer typdefinition detta beteende? Kan det förklaras ord-för-ord, särskilt användningen av Generisk?

Svar #1

attrTween har tre separata överlagringar, där den tredje posten (och den enda överlagringen med två argument med ett icke-null andra argument) är:

/**
 * Assign the attribute tween for the attribute with the specified name to the specified interpolator factory.
 * An interpolator factory is a function that returns an interpolator; when the transition starts, the factory is evaluated for each selected element.
 * The returned interpolator will then be invoked for each frame of the transition, in order,
 * being passed the eased time t, typically in the range [0, 1]. Lastly, the return value of the interpolator will be used to set the attribute value.
 * The interpolator must return a string.
 *
 * @param name Name of attribute.
 * @param factory An interpolator factory which is evaluated for each selected element, in order, being passed the current datum (d),
 * the current index (i), and the current group (nodes), with this as the current DOM element (nodes[i]). The interpolator factory returns a string interpolator,
 * which takes as its argument eased time t, typically in the range [0, 1] and returns the interpolated string.
 */
attrTween(name: string, factory: ValueFn<GElement, Datum, (t: number) => string>): this;

Detta matchar ditt anrop mycket bättre än den överlagring du listade. Denna definition finns i Transition, som definieras som följande:

export interface Transition<GElement extends BaseType, Datum, PElement extends BaseType, PDatum>

Med detta kan vi se den direkta kartläggningen:

  • d är Datum, vilket från caller är d3.PieArcDatum<number>
  • index är nummer

  • groups är T[] | ArrayLike<T> där T sträcker sig över BaseType.

    • Enligt attrTweens definition är T i ValueFn samma som GElement i Transition.
    • GElement är BaseType enligt din callee.
    • Därför är T BaseType, så groups är d3.BaseType[] | d3.ArrayLike<d3.BaseType> som du ser det.