标签自适应显示是一种动态标签管理策略，旨在根据当前可视范围的空间分配、节点重要性等因素，智能调整哪些标签应显示或隐藏。通过对可视区域的实时分析，确保用户在不同的交互场景下获得最相关最清晰的信息展示，同时避免视觉过载和信息冗余。

配置项

Required type

auto-adapt-label | string

此插件已内置，你可以通过 type: 'auto-adapt-label' 来使用它。

enable

boolean | ((event: IGraphLifeCycleEvent | IAnimateEvent | IElementLifeCycleEvent | IViewportEvent | IPointerEvent | IWheelEvent | IKeyboardEvent | IDragEvent) => boolean) Default: ``

是否启用

padding

number | number[] Default: 0

设置标签的内边距，用于判断标签是否重叠，以避免标签显示过于密集

sort

(elementA: NodeData | EdgeData | ComboData, elementB: NodeData | EdgeData | ComboData) => -1 | 0 | 1

根据元素的重要性从高到低排序，重要性越高的元素其标签显示优先级越高。一般情况下 combo > node > edge

sortCombo

(comboA: ComboData, comboB: ComboData) => -1 | 0 | 1

根据群组的重要性从高到低排序，重要性越高的群组其标签显示优先级越高。默认按照数据先后进行排序。需要注意，如果设置了 sort，则 sortCombo 不会生效

sortEdge

(edgeA: EdgeData, edgeB: EdgeData) => -1 | 0 | 1

根据边的重要性从高到低排序，重要性越高的边其标签显示优先级越高。默认按照数据先后进行排序。需要注意，如果设置了 sort，则 sortEdge 不会生效

sortNode

NodeCentralityOptions | ((nodeA: NodeData, nodeB: NodeData) => -1 | 0 | 1) Default: type: 'degree'

根据节点的重要性从高到低排序，重要性越高的节点其标签显示优先级越高。内置几种中心性算法，也可以自定义排序函数。需要注意，如果设置了 sort，则 sortNode 不会生效

NodeCentralityOptions

type NodeCentralityOptions =
  | { type: 'degree'; direction?: 'in' | 'out' | 'both' }
  | { type: 'betweenness'; directed?: boolean; weightPropertyName?: string }
  | { type: 'closeness'; directed?: boolean; weightPropertyName?: string }
  | { type: 'eigenvector'; directed?: boolean }
  | { type: 'pagerank'; epsilon?: number; linkProb?: number };

throttle

number Default: 32

节流时间

API

AutoAdaptLabel.destroy()

destroy(): void;

AutoAdaptLabel.update(options)

update(options: Partial<AutoAdaptLabelOptions>): void;