Angular Sankey - Hover

User Interaction

When a sankey node or link is hovered over or pressed, it applies the appearance specified in the node.hoverStyle or link.hoverStyle object. In the following code, these objects are used to make nodes half-opaque and make the links' border visible:

HTML
TypeScript
  • <dx-sankey ... >
  • <dxo-node>
  • <dxo-hover-style
  • [opacity]="0.5">
  • </dxo-hover-style>
  • </dxo-node>
  • <dxo-link>
  • <dxo-hover-style>
  • <dxo-border [visible]="true"></dxo-border>
  • </dxo-hover-style>
  • </dxo-link>
  • </dx-sankey>
  • import { DxSankeyModule } from "devextreme-angular";
  • // ...
  • export class AppComponent {
  • // ...
  • }
  • @NgModule({
  • imports: [
  • // ...
  • DxSankeyModule
  • ],
  • // ...
  • })

Set hoverEnabled to false if nodes and links should not react when they are hovered over or pressed:

HTML
TypeScript
  • <dx-sankey ...
  • [hoverEnabled]="false">
  • </dx-sankey>
  • import { DxSankeyModule } from "devextreme-angular";
  • // ...
  • export class AppComponent {
  • // ...
  • }
  • @NgModule({
  • imports: [
  • // ...
  • DxSankeyModule
  • ],
  • // ...
  • })

API

To change a node or link's hover state, pass true or false to their hover(state) method. You can call the isHovered() method to check the current state.

TypeScript
  • import { DxSankeyModule } from "devextreme-angular";
  • // ...
  • export class AppComponent {
  • toggleItemHoverState(item) {
  • item.hover(!item.isHovered());
  • }
  • }
  • @NgModule({
  • imports: [
  • // ...
  • DxSankeyModule
  • ],
  • // ...
  • })
See Also

Events

The Sankey UI component raises individual events for nodes and links when their hover state changes. You can handle them with functions. If the handling functions are not going to be changed at runtime, assign them to the onNodeHoverChanged and onLinkHoverChanged properties when you configure the UI component. To check whether the sankey element is being hovered over, call its isHovered() method.

HTML
TypeScript
  • <dx-sankey ...
  • (onNodeHoverChanged)="sankey_onNodeHoverChanged($event)"
  • (onLinkHoverChanged)="sankey_onLinkHoverChanged($event)">
  • </dx-sankey>
  • import { DxSankeyModule } from "devextreme-angular";
  • // ...
  • export class AppComponent {
  • sankey_onNodeHoverChanged(e) {
  • if(e.target.isHovered()) {
  • // Commands to execute when the pointer enters a node
  • } else {
  • // Commands to execute when the pointer leaves a node
  • }
  • }
  • sankey_onLinkHoverChanged(e) {
  • if(e.target.isHovered()) {
  • // Commands to execute when the pointer enters a link
  • } else {
  • // Commands to execute when the pointer leaves a link
  • }
  • }
  • }
  • @NgModule({
  • imports: [
  • // ...
  • DxSankeyModule
  • ],
  • // ...
  • })
See Also