update(examples): Add validation and zoom pan helper example

examples/UpdateNodeInternals/UpdateNodeInternalsExample.vue

@@ -64,7 +64,10 @@ const toggleHandlePosition = () =>
     return { ...el, data: { ...el.data, handlePosition: el.data?.handlePosition === 0 ? 1 : 0 } }
   }))
 
-const onLoad = (instance: FlowInstance) => (flowInstance.value = instance)
+const onLoad = (instance: FlowInstance) => {
+  instance.fitView()
+  flowInstance.value = instance
+}
 </script>
 <template>
   <Flow :elements="elements" :node-types="nodeTypes" @connect="onConnect" @pane-click="onPaneClick" @load="onLoad">

examples/Validation/CustomInput.vue

@@ -0,0 +1,9 @@
+<script lang="ts" setup>
+import { Position, Handle, Connection } from '~/index'
+
+const isValidConnection = (connection: Connection) => connection.target === 'B'
+</script>
+<template>
+  <div>Only connectable with B</div>
+  <Handle type="source" :position="Position.Right" :is-valid-connection="isValidConnection" />
+</template>

examples/Validation/CustomNode.vue

@@ -0,0 +1,16 @@
+<script lang="ts" setup>
+import { Position, Handle, Connection, NodeProps } from '~/index'
+
+interface CustomNodeProps extends NodeProps {
+  id: string
+}
+
+const props = defineProps<CustomNodeProps>()
+
+const isValidConnection = (connection: Connection) => connection.target === 'B'
+</script>
+<template>
+  <Handle type="target" :position="Position.Left" :is-valid-connection="isValidConnection" />
+  <div>{{ props.id }}</div>
+  <Handle type="source" :position="Position.Right" :is-valid-connection="isValidConnection" />
+</template>

examples/Validation/ValidationExample.vue

@@ -0,0 +1,53 @@
+<script lang="ts" setup>
+import CustomInput from './CustomInput.vue'
+import CustomNode from './CustomNode.vue'
+import Flow, {
+  addEdge,
+  Handle,
+  Connection,
+  Position,
+  Elements,
+  Edge,
+  OnConnectStartParams,
+  NodeProps,
+  FlowInstance,
+  NodeType,
+} from '~/index'
+
+import './validation.css'
+
+const initialElements: Elements = [
+  { id: '0', type: 'custominput', position: { x: 0, y: 150 } },
+  { id: 'A', type: 'customnode', position: { x: 250, y: 0 } },
+  { id: 'B', type: 'customnode', position: { x: 250, y: 150 } },
+  { id: 'C', type: 'customnode', position: { x: 250, y: 300 } },
+] as Elements
+
+const onLoad = (reactFlowInstance: FlowInstance) => reactFlowInstance.fitView()
+const onConnectStart = ({ nodeId, handleType }: OnConnectStartParams) => console.log('on connect start', { nodeId, handleType })
+const onConnectStop = (event: MouseEvent) => console.log('on connect stop', event)
+const onConnectEnd = (event: MouseEvent) => console.log('on connect end', event)
+
+const elements = ref<Elements>(initialElements)
+const onConnect = (params: Connection | Edge) => {
+  console.log('on connect', params)
+  elements.value = addEdge(params, elements.value)
+}
+const nodeTypes: Record<string, NodeType> = {
+  custominput: CustomInput as NodeType,
+  customnode: CustomNode as NodeType,
+}
+</script>
+<template>
+  <Flow
+    :elements="elements"
+    :select-nodes-on-drag="false"
+    class="validationflow"
+    :node-types="nodeTypes"
+    @connect="onConnect"
+    @oad="onLoad"
+    @connect-start="onConnectStart"
+    @connect-stop="onConnectStop"
+    @connect-end="onConnectEnd"
+  />
+</template>

examples/Validation/validation.css

@@ -0,0 +1,31 @@
+.validationflow .vue-flow__node {
+  width: 150px;
+  border-radius: 5px;
+  padding: 10px;
+  color: #555;
+  border: 1px solid #ddd;
+  text-align: center;
+  font-size: 12px;
+}
+
+.validationflow .vue-flow__node-customnode {
+  background: #e6e6e9;
+  border: 1px solid #ddd;
+}
+
+.vue-flow__node-custominput .vue-flow__handle {
+  background: #e6e6e9;
+}
+
+.validationflow .vue-flow__node-custominput {
+  background: #fff;
+
+}
+
+.validationflow .vue-flow__handle-connecting {
+  background: #ff6060;
+}
+
+.validationflow .vue-flow__handle-valid {
+  background: #55dd99;
+}

examples/ZoomPanHelper/ZoomPanHelperExample.vue

@@ -0,0 +1,50 @@
+<script lang="ts" setup>
+import Flow, {
+  removeElements,
+  addEdge,
+  Background,
+  MiniMap,
+  useZoomPanHelper,
+  Elements,
+  ElementId,
+  Connection,
+  Edge,
+  Node,
+} from '~/index'
+
+const initialElements: Elements = [
+  { id: '1', type: 'input', data: { label: 'Node 1' }, position: { x: 250, y: 5 }, className: 'light' },
+  { id: '2', data: { label: 'Node 2' }, position: { x: 100, y: 100 }, className: 'light' },
+  { id: '3', data: { label: 'Node 3' }, position: { x: 400, y: 100 }, className: 'light' },
+  { id: '4', data: { label: 'Node 4' }, position: { x: 400, y: 200 }, className: 'light' },
+  { id: 'e1-2', source: '1', target: '2', animated: true },
+  { id: 'e1-3', source: '1', target: '3' },
+] as Elements
+
+let id = 5
+const getId = (): ElementId => `${id++}`
+
+const { project } = useZoomPanHelper()
+
+const elements = ref(initialElements)
+
+const onPaneClick = (evt: MouseEvent) => {
+  const projectedPosition = project({ x: evt.clientX, y: evt.clientY - 40 })
+
+  elements.value = elements.value.concat({
+    id: getId(),
+    position: projectedPosition,
+    data: {
+      label: `${projectedPosition.x}-${projectedPosition.y}`,
+    },
+  } as Node)
+}
+const onConnect = (params: Connection | Edge) => (elements.value = addEdge(params, elements.value))
+const onElementsRemove = (elementsToRemove: Elements) => (elements.value = removeElements(elementsToRemove, elements.value))
+</script>
+<template>
+  <Flow :elements="elements" @elements-remove="onElementsRemove" @connect="onConnect" @pane-click="onPaneClick">
+    <Background />
+    <MiniMap />
+  </Flow>
+</template>

examples/router.ts

@@ -97,6 +97,14 @@ export const routes: RouterOptions['routes'] = [
     path: '/update-node-internals',
     component: () => import('./UpdateNodeInternals/UpdateNodeInternalsExample.vue'),
   },
+  {
+    path: '/validation',
+    component: () => import('./Validation/ValidationExample.vue'),
+  },
+  {
+    path: '/zoom-pan-helper',
+    component: () => import('./ZoomPanHelper/ZoomPanHelperExample.vue'),
+  },
 ]
 
 export const router = createRouter({