Persistir elimina, edita y crea
Cuando el gráfico es una vista de registros persistentes, ninguna escritura puede ser optimista. tres Los ganchos anteriores hacen que cada usuario iniciado escriba una propuesta que el consumidor decida, por lo que el lienzo y la base de datos nunca pueden estar en desacuerdo:
onBeforeDelete: se activa por cada posibilidad de eliminación (la fila masiva de la barra lateral, la entradas del menú contextual de nodo/borde/nota) una vez que se haya resuelto todo el conjunto de objetivos, incluyendocascadingEdges: las relaciones que destruiría la eliminación de un nodo. Regresefalsepara vetar, o{ accept: true, nodes, edges }para conservar solo lo que el servidor realmente eliminado.ctx.confirm()es el modal de confirmación incorporado.onBeforeNodeCreate: se activa para Crear ▸ Agregar nodo y el menú del lienzo Agregar nodo aquí, con el espacio gráficopositiony una formapromptData(). que lo que devuelves es lo que entra en la gráfica.onBeforeEdgeEditCommit: se activa cuando se confirma una edición de borde (haga clic con el botón derecho en un borde ▸ Editar borde). Si lo rechazas, el borde conservará sus datos.
Los tres pueden ser asíncronos y un segundo gesto se ignora mientras uno está pendiente. Las programáticas graph.removeNode() / addNode() nunca están cerradas, por lo que su propio código no está bloqueado por tu propio gancho.
Pruébelo: seleccione nodos y presione Eliminar en la barra lateral (el registro publicado aparece atrás rechazado), haga clic derecho en un borde para cambiar su relación, o use Crear ▸ Agregar nodo. Configure editors.deletion.enabled: false para eliminar las posibilidades de eliminación por completo en lugar de vetar cada clic.
const options = {
// Label each attribute with its value, so an edit's effect is visible.
render: {
defaultNodeStyle: {
size: 16,
textColor: '#334155',
text: (node) => node.getData()?.label,
textVerticalShift: -1.6
}
},
UI: {
mode: 'full',
// Off: `full` mode brings a minimap and the data dock, and this card is about
// neither (see the Minimap and Data table cards for those).
minimap: false,
table: false,
// Give the edge editor a relationship dropdown instead of a free-text field.
editors: {
edgeEditor: {
fields: [{
key: 'label',
label: 'Relationship',
type: 'select',
options: RELATIONSHIPS.map((value) => ({ value, label: value }))
}]
}
}
},
callbacks: {
// Nothing leaves the model until the server agrees. The library resolves the
// whole target set first — including `cascadingEdges`, the relationships that
// removing a node would take with it — so you can persist the real consequence.
onBeforeDelete: async ({ nodes, edges, cascadingEdges, origin, confirm }) => {
const links = edges.length + cascadingEdges.length
const ok = await confirm({
title: 'Delete from event?',
body: `${nodes.length} attribute(s) and ${links} relationship(s) will be `
+ `deleted server-side. (asked from the ${origin})`,
confirmLabel: 'Delete'
})
if (!ok) return false
graph.notifier.info('Saving…', 'POST /events/delete')
await wait(700) // a backend call that could fail
// The server refused the published record: keep exactly what it deleted.
const refused = nodes.filter((node) => node.getData().published)
if (refused.length) {
graph.notifier.warning('Kept', `${refused[0].getData().label} is published — not deleted.`)
}
return { accept: true, nodes: nodes.filter((node) => !node.getData().published) }
},
// Create ▸ Add node, or the canvas menu's "Add Node Here". `promptData` opens a
// form; the id/data you return is what enters the graph.
onBeforeNodeCreate: async ({ position, promptData }) => {
const values = await promptData({
title: 'New attribute',
fields: [
{ key: 'label', label: 'Value', type: 'text' },
{
key: 'type', label: 'Type', type: 'select', defaultValue: 'ip-src',
options: ['ip-src', 'domain', 'md5', 'url'].map((v) => ({ value: v, label: v }))
}
]
})
if (!values) return false // cancelled
graph.notifier.info('Saving…', 'POST /attributes/add')
await wait(500)
graph.notifier.success('Created', `${values.label} at ${Math.round(position.x)},${Math.round(position.y)}`)
return { accept: true, id: `attr-${values.label}`, data: values }
},
// Right-click an edge ▸ Edit Edge. The commit is a proposal too: refuse it and
// the edge keeps its data, with the modal still open to correct.
onBeforeEdgeEditCommit: async ({ previousData, nextData }) => {
if (!RELATIONSHIPS.includes(nextData.label)) {
graph.notifier.warning('Rejected', `"${nextData.label}" is not a known relationship.`)
return false
}
graph.notifier.info('Saving…', 'PUT /object_references')
await wait(500)
graph.notifier.success('Updated', `${previousData.label} → ${nextData.label}`)
return true
}
}
}const data = {
nodes: [
{ id: 'ip-8888', data: { label: '8.8.8.8', type: 'ip-src' } },
{ id: 'dom-evil', data: { label: 'evil.example.com', type: 'domain' } },
{ id: 'md5', data: { label: 'd41d8cd9…f8427e', type: 'md5' } },
// The server refuses to delete this one — a published record.
{ id: 'file-obj', data: { label: 'invoice.doc', type: 'file', published: true } }
],
edges: [
{ id: 'r1', from: 'file-obj', to: 'md5', data: { label: 'contains' } },
{ id: 'r2', from: 'dom-evil', to: 'ip-8888', data: { label: 'resolves-to' } }
]
}