chore(types): add tsdocs
This commit is contained in:
@@ -25,9 +25,9 @@ function getSelector<NodeType extends Node = Node, SelectorReturn = ConnectionSt
|
||||
}
|
||||
/**
|
||||
* The `useConnection` hook returns the current connection when there is an active
|
||||
*connection interaction. If no connection interaction is active, it returns null
|
||||
*for every property. A typical use case for this hook is to colorize handles
|
||||
*based on a certain condition (e.g. if the connection is valid or not).
|
||||
* connection interaction. If no connection interaction is active, it returns null
|
||||
* for every property. A typical use case for this hook is to colorize handles
|
||||
* based on a certain condition (e.g. if the connection is valid or not).
|
||||
*
|
||||
* @public
|
||||
* @example
|
||||
|
||||
@@ -7,7 +7,7 @@ const edgesSelector = (state: ReactFlowState) => state.edges;
|
||||
|
||||
/**
|
||||
* This hook returns an array of the current edges. Components that use this hook
|
||||
*will re-render **whenever any edge changes**.
|
||||
* will re-render **whenever any edge changes**.
|
||||
*
|
||||
* @public
|
||||
* @returns An array of edges
|
||||
|
||||
@@ -5,9 +5,9 @@ import { useStore } from './useStore';
|
||||
import type { InternalNode, Node } from '../types';
|
||||
|
||||
/**
|
||||
* This hook returns the internal representation of a specific node. Components that use this hook
|
||||
*will re-render **whenever the node changes**, including when a node is selected
|
||||
*or moved.
|
||||
* This hook returns the internal representation of a specific node.
|
||||
* Components that use this hook will re-render **whenever the node changes**,
|
||||
* including when a node is selected or moved.
|
||||
*
|
||||
* @public
|
||||
* @param id - id of the node
|
||||
|
||||
@@ -14,7 +14,7 @@ const defaultDoc = typeof document !== 'undefined' ? document : null;
|
||||
|
||||
/**
|
||||
* This hook lets you listen for specific key codes and tells you whether they are
|
||||
*currently pressed or not.
|
||||
* currently pressed or not.
|
||||
*
|
||||
* @public
|
||||
* @param param.keyCode - The key code (string or array of strings) to use
|
||||
|
||||
@@ -7,8 +7,8 @@ const nodesSelector = (state: ReactFlowState) => state.nodes;
|
||||
|
||||
/**
|
||||
* This hook returns an array of the current nodes. Components that use this hook
|
||||
*will re-render **whenever any node changes**, including when a node is selected
|
||||
*or moved.
|
||||
* will re-render **whenever any node changes**, including when a node is selected
|
||||
* or moved.
|
||||
*
|
||||
* @public
|
||||
* @returns An array of nodes
|
||||
|
||||
@@ -5,8 +5,8 @@ import type { Node, Edge, OnNodesChange, OnEdgesChange } from '../types';
|
||||
|
||||
/**
|
||||
* This hook makes it easy to prototype a controlled flow where you manage the
|
||||
*state of nodes and edges outside the `ReactFlowInstance`. You can think of it
|
||||
*like React's `useState` hook with an additional helper callback.
|
||||
* state of nodes and edges outside the `ReactFlowInstance`. You can think of it
|
||||
* like React's `useState` hook with an additional helper callback.
|
||||
*
|
||||
* @public
|
||||
* @param initialNodes
|
||||
@@ -34,10 +34,10 @@ import type { Node, Edge, OnNodesChange, OnEdgesChange } from '../types';
|
||||
*}
|
||||
*```
|
||||
*
|
||||
*@remarks This hook was created to make prototyping easier and our documentation
|
||||
*examples clearer. Although it is OK to use this hook in production, in
|
||||
*practice you may want to use a more sophisticated state management solution
|
||||
*like Zustand {@link https://reactflow.dev/docs/guides/state-management/} instead.
|
||||
* @remarks This hook was created to make prototyping easier and our documentation
|
||||
* examples clearer. Although it is OK to use this hook in production, in
|
||||
* practice you may want to use a more sophisticated state management solution
|
||||
* like Zustand {@link https://reactflow.dev/docs/guides/state-management/} instead.
|
||||
*
|
||||
*/
|
||||
export function useNodesState<NodeType extends Node>(
|
||||
@@ -54,8 +54,8 @@ export function useNodesState<NodeType extends Node>(
|
||||
|
||||
/**
|
||||
* This hook makes it easy to prototype a controlled flow where you manage the
|
||||
*state of nodes and edges outside the `ReactFlowInstance`. You can think of it
|
||||
*like React's `useState` hook with an additional helper callback.
|
||||
* state of nodes and edges outside the `ReactFlowInstance`. You can think of it
|
||||
* like React's `useState` hook with an additional helper callback.
|
||||
*
|
||||
* @public
|
||||
* @param initialEdges
|
||||
@@ -84,9 +84,9 @@ export function useNodesState<NodeType extends Node>(
|
||||
*```
|
||||
*
|
||||
* @remarks This hook was created to make prototyping easier and our documentation
|
||||
*examples clearer. Although it is OK to use this hook in production, in
|
||||
*practice you may want to use a more sophisticated state management solution
|
||||
*like Zustand {@link https://reactflow.dev/docs/guides/state-management/} instead.
|
||||
* examples clearer. Although it is OK to use this hook in production, in
|
||||
* practice you may want to use a more sophisticated state management solution
|
||||
* like Zustand {@link https://reactflow.dev/docs/guides/state-management/} instead.
|
||||
*
|
||||
*/
|
||||
export function useEdgesState<EdgeType extends Edge = Edge>(
|
||||
|
||||
@@ -10,8 +10,8 @@ const zustandErrorMessage = errorMessages['error001']();
|
||||
|
||||
/**
|
||||
* This hook can be used to subscribe to internal state changes of the React Flow
|
||||
*component. The `useStore` hook is re-exported from the [Zustand](https://github.com/pmndrs/zustand)
|
||||
*state management library, so you should check out their docs for more details.
|
||||
* component. The `useStore` hook is re-exported from the [Zustand](https://github.com/pmndrs/zustand)
|
||||
* state management library, so you should check out their docs for more details.
|
||||
*
|
||||
* @public
|
||||
* @param selector
|
||||
@@ -24,8 +24,8 @@ const zustandErrorMessage = errorMessages['error001']();
|
||||
* ```
|
||||
*
|
||||
* @remarks This hook should only be used if there is no other way to access the internal
|
||||
*state. For many of the common use cases, there are dedicated hooks available
|
||||
*such as {@link useReactFlow}, {@link useViewport}, etc.
|
||||
* state. For many of the common use cases, there are dedicated hooks available
|
||||
* such as {@link useReactFlow}, {@link useViewport}, etc.
|
||||
*/
|
||||
function useStore<StateSlice = unknown>(
|
||||
selector: (state: ReactFlowState) => StateSlice,
|
||||
@@ -51,8 +51,8 @@ function useStore<StateSlice = unknown>(
|
||||
* ```
|
||||
*
|
||||
* @remarks This hook should only be used if there is no other way to access the internal
|
||||
*state. For many of the common use cases, there are dedicated hooks available
|
||||
*such as {@link useReactFlow}, {@link useViewport}, etc.
|
||||
* state. For many of the common use cases, there are dedicated hooks available
|
||||
* such as {@link useReactFlow}, {@link useViewport}, etc.
|
||||
*/
|
||||
function useStoreApi<NodeType extends Node = Node, EdgeType extends Edge = Edge>() {
|
||||
const store = useContext(StoreContext) as UseBoundStoreWithEqualityFn<
|
||||
|
||||
Reference in New Issue
Block a user