@lichong/phylotree/src/render/events.js

A JavaScript library for developing applications and interactive visualizations involving [phylogenetic trees](https://en.wikipedia.org/wiki/Phylogenetic_tree), written as an extension of the [D3](http://d3js.org) [hierarchy layout](https://github.com/d3/

import { isLeafNode } from "../nodes";
import { css_classes } from "./options";

// 为每个进化树实例生成唯一的事件ID
let phylotree_instance_counter = 0;

/**
 * 生成唯一的进化树实例ID
 * @returns {string} 唯一的实例ID
 */
export function generatePhylotreeInstanceId() {
  return "phylotree.event." + (++phylotree_instance_counter);
}

/**
 * Toggle collapsed view of a given node. Either collapses a clade into
 * a smaller blob for viewing large trees, or expands a node that was
 * previously collapsed.
 *
 * @param {Node} node The node to toggle.
 * @returns {Phylotree} The current ``phylotree``.
 */
export function toggleCollapse(node) {
  if (node.collapsed) {
    node.collapsed = false;

    let unhide = function(n) {
      if (!isLeafNode(n)) {
        if (!n.collapsed) {
          n.children.forEach(unhide);
        }
      }
      n.hidden = false;
    };

    unhide(node);
  } else {
    node.collapsed = true;
  }

  this.placenodes();
  return this;
}

export function resizeSvg(tree, svg, tr) {

  let sizes = this.size;

  if (this.radial()) {
    let pad_radius = this.pad_width(),
      vertical_offset =
        this.options["top-bottom-spacing"] != "fit-to-size"
          ? this.pad_height()
          : 0;

    sizes = [
      sizes[1] + 2 * pad_radius,
      sizes[0] + 2 * pad_radius + vertical_offset
    ];

    if (svg) {
      svg
        .selectAll("." + css_classes["tree-container"])
        .attr(
          "transform",
          "translate (" +
            pad_radius +
            "," +
            (pad_radius + vertical_offset) +
            ")"
        );
    }
  } else {

    sizes = [
      sizes[0] +
        (this.options["top-bottom-spacing"] != "fit-to-size"
          ? this.pad_height()
          : 0),
      sizes[1] +
        (this.options["left-right-spacing"] != "fit-to-size"
          ? this.pad_width()
          : 0)
    ];

  }

  if (svg) {

    if (tr) {
      svg = svg.transition(100);
    }

    svg.attr("height", sizes[0]).attr("width", sizes[1]);

  }

  this.size = sizes;

  return sizes;

}

export function rescale(scale, attr_name) {
  attr_name = attr_name || "y_scaled";
  if (attr_name in this) {
    this[attr_name] *= scale;
  }
}

/**
 * 触发刷新事件
 * @param {Object} tree - 进化树实例
 * @param {string} instanceId - 进化树实例的唯一ID
 */
export function triggerRefresh(tree, instanceId) {
  let eventId = instanceId || "phylotree.event";
  let event = new CustomEvent(eventId, {
    detail: ["refresh", tree]
  });

  document.dispatchEvent(event);
}

/**
 * 触发计数更新事件
 * @param {Object} tree - 进化树实例
 * @param {Object} counts - 计数数据
 * @param {string} instanceId - 进化树实例的唯一ID
 */
export function countUpdate(tree, counts, instanceId) {
  let eventId = instanceId || "phylotree.event";
  let event = new CustomEvent(eventId, {
    detail: ["countUpdate", counts, tree.countHandler()]
  });
  document.dispatchEvent(event);
}

/**
 * 触发布局事件
 * @param {Object} tree - 进化树实例
 * @param {string} instanceId - 进化树实例的唯一ID
 */
export function d3PhylotreeTriggerLayout(tree, instanceId) {
  let eventId = instanceId || "phylotree.event";
  let event = new CustomEvent(eventId, {
    detail: ["layout", tree, tree.layoutHandler()]
  });
  document.dispatchEvent(event);
}

export function d3PhylotreeEventListener(event) {
  switch (event.detail[0]) {
    case "refresh":
      event.detail[1].refresh();
      break;
    case "countUpdate":
      event.detail[2](event.detail[1]);
      break;
    case "layout":
      event.detail[2](event.detail[1]);
  }
  return true;
}

/**
 * 为特定进化树实例添加事件监听器
 * @param {string} instanceId - 进化树实例的唯一ID
 * @param {Function} customListener - 自定义事件监听器函数（可选）
 */
export function d3PhylotreeAddEventListener(instanceId, customListener) {
  let eventId = instanceId || "phylotree.event";
  let listener = customListener || d3PhylotreeEventListener;
  
  document.addEventListener(
    eventId,
    listener,
    false
  );
}

/**
 * 移除特定进化树实例的事件监听器
 * @param {string} instanceId - 进化树实例的唯一ID
 * @param {Function} customListener - 自定义事件监听器函数（可选）
 */
export function d3PhylotreeRemoveEventListener(instanceId, customListener) {
  let eventId = instanceId || "phylotree.event";
  let listener = customListener || d3PhylotreeEventListener;
  
  document.removeEventListener(
    eventId,
    listener,
    false
  );
}

export function d3PhylotreeSvgTranslate(x) {
  if (x && (x[0] !== null || x[1] !== null))
    return (
      "translate (" +
      (x[0] !== null ? x[0] : 0) +
      "," +
      (x[1] !== null ? x[1] : 0) +
      ") "
    );

  return "";
}

export function d3PhylotreeSvgRotate(a) {
  if (a !== null) {
    return "rotate (" + a + ") ";
  }
  return "";
}