Foblex Flow
Connection Rules
Description
This example demonstrates how to control which input connectors can be connected to a given output connector. The rules work in two ways:
- By input ID (
fInputId) - By input category (
fInputCategory)
On the output side you define fCanBeConnectedInputs, which may include specific input IDs and/or categories. During a drag operation, the system checks whether the target input ID or category is present in that array and only then allows the connection.
Example
[example.html] <<< https://raw.githubusercontent.com/Foblex/f-flow/main/libs/f-examples/connectors/connection-rules/example.html [example.ts] <<< https://raw.githubusercontent.com/Foblex/f-flow/main/libs/f-examples/connectors/connection-rules/example.ts [example.scss] <<< https://raw.githubusercontent.com/Foblex/f-flow/main/libs/f-examples/connectors/connection-rules/example.scss
Visual feedback
When a connection starts being dragged:
- The container receives the CSS class
.f-connections-dragging. - Every input connector that can accept the connection gets the class
.f-connector-connectable. - Inputs without this class are treated as invalid targets and can be dimmed or styled differently.
This gives the user immediate feedback about which targets are valid before they complete the drag.
When to use it
Use connection rules when your editor has domain constraints such as:
- one node type can connect only to a specific target,
- only certain categories of inputs are valid,
- the UI should show allowed targets before the user commits the connection,
- your application needs both better UX and cleaner graph data.