配置

点选/框选，默认禁用。创建画布时，通过以下配置开启选择交互，开启后可以通过点击或者套索框选节点。

const graph = new Graph({
  selecting: true,
})

// 等同于
const graph = new Graph({
  selecting: {
    enabled: true,
  },
})

创建画布后，可以调用 graph.enableSelection() 和 graph.disableSelection() 来启用和禁用选择交互。

if (graph.isSelectionEnabled()) {
  graph.disableSelection()
} else {
  graph.enableSelection()
}

支持的选项如下：

interface SelectionOptions {
  className?: string
  multiple?: boolean
  rubberband?: boolean
  strict?: boolean
  modifiers?: string | ('alt' | 'ctrl' | 'meta' | 'shift')[] | null
  movable?: boolean
  content?:
    | null
    | false
    | string
    | ((
        this: Graph,
        selection: Selection,
        contentElement: HTMLElement,
      ) => string)
  filter?: 
    | null 
    | (string 
    | { id: string })[] 
    | ((this: Graph, cell: Cell) => boolean)
}

className

附加样式名，用于定制样式，默认为 undefined。

const graph = new Graph({
  selecting: {
    enabled: true,
    className: 'my-selecting',
  },
})

multiple

是否启用点击多选，默认为 true。启用多选后按住 ctrl 或 command 键点击节点实现多选。

rubberband

是否启用框选，默认为 false。

const graph = new Graph({
  selecting: {
    enabled: true,
    rubberband: true, // 启用框选
  },
})

创建画布后，可以调用 graph.enableRubberband() 和 graph.disableRubberband() 来启用和禁用框选。

if (graph.isRubberbandEnabled()) {
  graph.disableRubberband()
} else {
  graph.enableRubberband()
}

strict

启用框选时，选框完全包围节点时才选中节点，否则只需要选框与节点的包围盒(BBox)相交即可选中节点，默认为 false。

modifiers

修饰键('alt'、'ctrl'、'meta'、'shift')，设置修饰键后需要点击鼠标并按下修饰键才能触发框选。修饰键在某些场景下非常有用，比如同时开始框选和拖拽画布时，而框选和拖拽画布的触发时机都是鼠标左键在画布空白位置按下，这时可以为框选和拖拽画布设置不一样的修饰键，达到同时开启又不冲突的效果。

支持配置单个（如 'alt'）或多个（如 ['alt', 'ctrl']）修饰键，通过数组形式配置的多个修饰键是或关系，比如刚刚配置的修饰键表示按下 'alt' 或 'ctrl'，如果需要更加灵活的配置，可以使用如下这些形式：

• 'alt|ctrl' 表示按下 'alt' 或 'ctrl'。
• 'alt&ctrl' 表示同时按下 'alt' 和 'ctrl'。
• 'alt|ctrl&shift' 表示同时按下 'alt' 和 'shift' 或者同时按下 'ctrl' 和 'shift'。

movable

选中的节点是否可以被移动，设置为 true 时，拖动选框触发节点移动，默认为 true。

content

设置附加显示的内容。

filter

节点过滤器，被过滤的节点将不能被选中。支持以下三种类型：

• string[] 节点类型数组，指定的节点类型不参与对齐计算
• ({ id: string })[] 节点（类节点）数组，指定的节点不参与对齐计算
• (this: Graph, node: Node) => boolean 返回 true 的节点不参与对齐计算

const graph = new Graph({
  selecting: {
    enabled: true,
    filter: ['rect'], // 'rect' 类型节点不能被选中
  },
})

// 等同于
const graph = new Graph({
  selecting: {
    enabled: true,
    filter(node) {
      return node.shape === 'rect'
    },
  },
})

showNodeSelectionBox

是否显示节点的选择框，默认为 false。

showEdgeSelectionBox

是否显示边的选择框，默认为 false。

方法

select(...)

select(cells: Cell | string | (Cell | string)[]): this 

选中指定的节点/边。需要注意的是，该方法不会取消选中当前选中的节点/边，而是将指定的节点/边追加到选区中。如果同时需要取消选中当前选中的节点/边，请使用 resetSelection(...) 方法。

unselect(...)

unselect(cells: Cell | string | (Cell | string)[]): this 

取消选中指定的节点/边。

isSelected(...)

isSelected(cell: Cell | string): boolean

返回指定的节点/边是否被选中。

resetSelection(...)

resetSelection(cells?: Cell | string | (Cell | string)[]): this

先清空选区，然后选中提供的节点/边。

getSelectedCells()

getSelectedCells(): Cell[]

获取选中的节点/边。

cleanSelection()

cleanSelection(): this

清空选区。

isSelectionEmpty()

cleanSelection(): boolean

返回选区是否为空。

isSelectionEnabled()

isSelectionEnabled(): boolean

是否启用选择能力。

enableSelection()

enableSelection(): this

启用选择能力。

disableSelection()

disableSelection(): this

禁用选择能力。

toggleSelection(...)

toggleSelection(enabled?: boolean): this

切换选择的启用状态。

参数

名称	类型	必选	默认值	描述
enabled	boolean		-	是否启用选择能力，缺省时切换选择的启用状态。

isMultipleSelection()

isMultipleSelection(): boolean

是否启用了多选。

enableMultipleSelection()

enableMultipleSelection(): this

启用多选。

disableMultipleSelection()

disableMultipleSelection(): this

禁用多选。

toggleMultipleSelection(...)

toggleMultipleSelection(multiple?: boolean): this

切换多选的启用状态。

参数

名称	类型	必选	默认值	描述
multiple	boolean		-	是否启用多选，缺省时切换多选的启用状态。

isSelectionMovable()

isSelectionMovable(): boolean

返回选中的节点/边是否可以被移动。

enableSelectionMovable()

enableSelectionMovable(): this

启用选中的节点/边的移动。

disableSelectionMovable()

disableSelectionMovable(): this

禁用选中节点/边的移动。

toggleSelectionMovable(...)

toggleSelectionMovable(enabled?: boolean): this

切换选中节点/边是否可以被移动。

参数

名称	类型	必选	默认值	描述
enabled	boolean		-	是否启用选中的节点/边的移动，缺省时切换启用状态。

isRubberbandEnabled()

isRubberbandEnabled(): boolean

返回是否启用了框选。

enableRubberband()

enableRubberband(): this

启用框选。

disableRubberband()

disableRubberband(): this

禁用框选。

toggleRubberband(...)

toggleRubberband(enabled?: boolean): this

切换框选的启用状态。

参数

名称	类型	必选	默认值	描述
enabled	boolean		-	是否启用框选，缺省时切换启用状态。

isStrictRubberband()

isStrictRubberband(): boolean

返回是否启用了严格框选。启用严格框选后，只有节点/边被选框完全包围时才会选中节点/边。

enableStrictRubberband()

enableStrictRubberband(): this

启用严格框选。启用严格框选后，只有节点/边被选框完全包围时才会选中节点/边。

disableStrictRubberband()

disableStrictRubberband(): this

禁用严格框选。禁用严格框选后，只需要选框与节点/边的包围盒相交即可选中节点/边。

toggleStrictRubberband(...)

toggleStrictRubberband(enabled?: boolean): this

切换严格框选的启用状态。

参数

名称	类型	必选	默认值	描述
enabled	boolean		-	是否启用严格框选，缺省时切换启用状态。

setSelectionFilter(...)

setSelectionFilter(
  filter?: 
   | null
   | (string | { id: string })[]
   | ((this: Graph, cell: Cell) => boolean)
): this

设置选择的过滤条件，满足过滤条件的节点/边将不能被选中。

• 当 filter 为 null、undefined 时，不过滤节点/边。
• 当 filter 为 (string | { id: string })[] 时，表示具有这些 ID 的节点/边不能被选中
• 当 filter 为 (this: Graph, cell: Cell) => boolean 时，返回 true 时节点/边不能被选中。

setRubberbandModifiers(...)

setRubberbandModifiers(modifiers?: string | ModifierKey[] | null): this

设置框选的修饰键，只有同时按下修饰键时才能触发框选。

setSelectionDisplayContent(...)

setSelectionDisplayContent(
  content?: 
   | null
   | false
   | string
   | ((this: Graph, selection: Selection, contentElement: HTMLElement) => string)
): this

设置选中节点/边的附加显示内容。

• 当 content 为 null、undefined、false 时，不显示附加内容
• 当 content 为 string 时，显示一段文本。
• 当 content 为 (this: Graph, selection: Selection, contentElement: HTMLElement) => string 时，动态返回显示的内容。

事件

cell:selected

节点/边被选中时触发。

node:selected

节点被选中时触发。

edge:selected

边被选中时触发。

cell:unselected

节点/边被取消选中时触发。

node:unselected

节点被取消选中时触发。

edge:unselected

边被取消选中时触发。

selection:changed

选中的节点/边发生改变(增删)时触发。