Method renderTo

src/components/component.ts:362–389

* Renders the Component to a given HTML Element. * * @param {String|d3.Selection} element The element, a selector string for the element, or a d3.Selection for the element. * @returns {Component} The calling Component.

(element: string | HTMLElement | d3.Selection<HTMLElement, any, any, any>)

   * @returns {Component} The calling Component.
   */
  public renderTo(element: string | HTMLElement | d3.Selection<HTMLElement, any, any, any>): this {
    this.detach();
    if (element != null) {
      let selection: d3.Selection<HTMLElement, any, any, any>;
      if (typeof(element) === "string") {
        selection = d3.select<HTMLElement, any>(element);
      } else if (isElement(element)) {
        selection = d3.select<HTMLElement, any>(element as HTMLElement);
      } else {
        selection = coerceExternalD3(element as d3.Selection<HTMLElement, any, any, any>);
      }
      if (!selection.node() || selection.node().nodeName == null) {
        throw new Error("Plottable requires a valid Element to renderTo");
      }
      if (selection.node().nodeName === "svg") {
        throw new Error("Plottable 3.x and later can only renderTo an HTML component; pass a div instead!");
      }
      this.anchor(selection);
    }
    if (this._element == null) {
      throw new Error("If a Component has never been rendered before, then renderTo must be given a node to render to, " +
        "or a d3.Selection, or a selector string");
    }
    RenderController.registerToComputeLayoutAndRender(this);
    // flush so that consumers can immediately attach to stuff we create in the DOM
    RenderController.flush();
    return this;
  }

  /**
   * Gets the x alignment of the Component.