Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/scripts/snippets/router-pricing-display.ts
Original file line number Diff line number Diff line change
Expand Up @@ -205,6 +205,8 @@ const phrases: Record<string, Translation> = {

const units: Record<string, Translation> = {
"1M tokens": ["1M tokens", "1M トークン", "1M 令牌", "1M 토큰", "1M de tokens"],
"1K characters": ["1K characters", "1K 文字", "1K 字符", "1K 문자", "1K caracteres"],
"Recraft credit": ["Recraft credit", "Recraft クレジット", "Recraft 积分", "Recraft 크레딧", "crédito de Recraft"],
"1K video tokens": ["1K video tokens", "1K 動画トークン", "1K 视频令牌", "1K 동영상 토큰", "1K de tokens de video"],
"second": ["second", "秒", "秒", "초", "segundo"], "minute": ["minute", "分", "分钟", "분", "minuto"],
"5 seconds": ["5 s", "5 秒", "5 秒", "5초", "5 s"],
Expand Down
217 changes: 179 additions & 38 deletions docs.json

Large diffs are not rendered by default.

77 changes: 77 additions & 0 deletions es/custom-nodes/js/canvas-pointer-api.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
---
title: "API de puntero del lienzo para widgets y cursores"
sidebarTitle: "API de puntero del lienzo"
description: "Gestiona clics, doble clics y arrastres en widgets de lienzo personalizados con onPointerDown y controla los cursores del lienzo desde una extensión del frontend de ComfyUI."
translationSourceHash: 16ea7f38
translationFrom: custom-nodes/js/canvas-pointer-api.mdx
translationBlockHashes:
"_intro": b1d4c464
"Default behavior": 27a8751b
"Handle pointer input on a widget": e4fc63fc
"Control the canvas cursor": 9bcc33c8
---
El lienzo canaliza la entrada del puntero a través de un `CanvasPointer`. Este decide si una pulsación se convierte en un clic, un doble clic o un arrastre, y ejecuta las funciones de devolución de llamada que asignas para esa pulsación. Los widgets dibujados en el lienzo lo usan mediante `onPointerDown`.

## Comportamiento predeterminado

- Arrastrar varios elementos seleccionados ya no requiere mantener presionada Shift. Hacer clic en un elemento mientras varios están seleccionados sigue deseleccionando los demás.
- Hacer clic en un enlace conectado de una entrada ya no lo desconecta y lo vuelve a conectar.
- Una pequeña cantidad de movimiento entre presionar y soltar el puntero sigue contando como un clic. Una vez que el puntero supera el límite de deriva del clic, la pulsación se convierte en un arrastre. El tiempo no afecta la decisión.
- Un doble clic requiere dos pulsaciones dentro del tiempo de doble clic, separadas como máximo por tres veces la deriva del clic. Solo una pulsación que asigne `onDoubleClick` puede completar un doble clic.

Los usuarios configuran la deriva del clic y el tiempo de doble clic en las configuraciones
(`Comfy.Pointer.ClickDrift` y `Comfy.Pointer.DoubleClickTime`).

### Seleccionar varios elementos

- `Ctrl` + arrastrar: inicia una selección múltiple
- `Ctrl` + `Shift` + arrastrar: agrega a la selección
- `Ctrl` + arrastrar, luego `Shift`: agrega a la selección
- `Ctrl` + arrastrar, luego `Alt`: elimina de la selección

## Manejar la entrada de puntero en un widget

Asigna `onPointerDown` en un widget. Se ejecuta al presionar con el puntero y recibe el puntero, el nodo y el lienzo. Asigna en el puntero las devoluciones de llamada que necesites; el lienzo ejecuta las adecuadas cuando se resuelve la pulsación:

```js
widget.onPointerDown = function (pointer, node, canvas) {
const e = pointer.eDown
const offsetFromNode = [e.canvasX - node.pos[0], e.canvasY - node.pos[1]]

pointer.onClick = (upEvent) => {
console.log(pointer.eDown, pointer.eMove, pointer.eUp)
}
pointer.onDoubleClick = (upEvent) => this.customFunction(upEvent)

pointer.onDragStart = () => {}
pointer.onDrag = (moveEvent) => {}
pointer.onDragEnd = (upEvent) => {}
pointer.onDragCancel = () => {}

pointer.finally = () => {}

return true
}
```

- `onClick` y `onDoubleClick` nunca se ejecutan en la misma pulsación que `onDragStart`, `onDragEnd` u `onDragCancel`. `onDrag` sí puede ejecutarse en una pulsación que termina como clic, porque también recibe el movimiento dentro del límite de deriva del clic.
- `onDragStart` se ejecuta una vez por arrastre, cuando el puntero supera por primera vez el límite de deriva del clic. Si el puntero se suelta más allá del límite antes de que se informe de algún evento de movimiento, `onDragStart` se ejecuta al soltar, `onDragEnd` se ejecuta justo después y `onDrag` no se ejecuta.
- Cuando una pulsación asigna `onClick` y `onDoubleClick`, al soltar la primera pulsación de un doble clic se ejecuta `onClick`. La segunda pulsación ejecuta `onDoubleClick` en lugar de `onClick`, así que haz que `onClick` sea seguro si se ejecuta primero. Además, el primer clic puede caer en un elemento cercano en lugar de tu widget, por lo que `onDoubleClick` puede ejecutarse sin que se haya ejecutado tu `onClick`.
- `onDragEnd` recibe el evento de subida del puntero de un arrastre. `onDragCancel` se ejecuta en su lugar cuando el arrastre se interrumpe, por ejemplo cuando se pierde la captura del puntero.
- `finally` se ejecuta una vez al terminar la pulsación. Asignar `pointer.finally` ejecuta de inmediato la devolución de llamada a la que reemplaza. Si `onPointerDown` no devuelve `true`, el lienzo asigna su propio `finally`, así que el tuyo se ejecuta durante la pulsación. Devuelve `true` cuando dependas de `finally` para limpiar.
- `pointer.eDown`, `pointer.eMove` y `pointer.eUp` dan a cada devolución de llamada acceso a toda la secuencia de eventos.
- Devuelve `true` para impedir que el lienzo maneje la pulsación por su cuenta.
- Elimina cualquier manejador `widget.mouse` heredado cuando añadas `onPointerDown`. Si `onPointerDown` devuelve `true`, el lienzo sigue rastreando el widget después de soltar y sigue llamando a `widget.mouse` en cada movimiento del puntero.

El lienzo resuelve por ti los dobles clics y los arrastres, así que un widget ya no necesita medir ni cronometrar eventos de puntero por separado. También respeta la deriva de clic y la configuración de doble clic del usuario.

## Controlar el cursor del lienzo

`canvas.state.hoveringOver` contiene indicadores de bits para los tipos de elemento que están bajo el puntero, como un nodo, un grupo, un Reroute o una conexión. Establece `canvas.state.shouldSetCursor` en `false` para evitar que el lienzo establezca el estilo del cursor y luego establécelo tú mismo:

```js
canvas.state.shouldSetCursor = false
canvas.canvas.style.cursor = 'pointer'
```

Iniciar el redimensionamiento de un nodo sigue estableciendo un cursor de redimensionamiento mientras `shouldSetCursor` es `false`. Vuelve a establecer el cursor después de que finalice el redimensionamiento.
116 changes: 116 additions & 0 deletions es/custom-nodes/js/connection-callbacks-migration.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
---
title: "Migración de callbacks de conexión para extensiones del frontend"
sidebarTitle: "Migración de callbacks de conexión"
description: "Orden de los callbacks onConnectionsChange y de eliminación de nodos, SubgraphIO en los límites de subgrafos y graph.events en extensiones de ComfyUI."
translationSourceHash: 06a9ae24
translationFrom: custom-nodes/js/connection-callbacks-migration.mdx
translationBlockHashes:
"_intro": cd84d91b
"Check for SubgraphIO at subgraph boundaries": c049a9fe
"Subscribe to node lifecycle events with graph.events": 1100692e
"Node removal fires callbacks in this order (partially tested)": 720324f8
"Workflow load resolves peer nodes before onConnectionsChange runs": 2b775215
"API prompt import does not reconnect resolved inputs": 619d6b69
"Reject connections before they are made": b9b94a8e
"Removing a link inside the output callback skips the input callback": 3317def4
"Replace removed slot events": 5c3ec663
"Read connection state from callback arguments or node methods": 9da17ab0
---
Las firmas de los callbacks no cambiaron. `onConnectionsChange`, `onConnectInput`, `onConnectOutput` y `onBeforeConnectInput` conservan sus argumentos y su comportamiento de ejecución actuales. Para los cambios en el registro de enlaces y en la API de `LinkNetwork`, consulta [Migración del registro de enlaces](/es/custom-nodes/js/link-registration-migration).

## Comprobar SubgraphIO en los límites de subgrafo

En un límite de subgrafo (un `SubgraphInput` o un `SubgraphOutput`), `onConnectionsChange` sigue disparándose, pero su quinto argumento es un `SubgraphIO`, no el `INodeInputSlot`/`INodeOutputSlot` habitual. Compruébalo antes de tratar el argumento como un slot normal. Los guardianes `isSubgraphInput` e `isSubgraphOutput` del propio frontend no se exponen a las extensiones, así que comprueba el arreglo `linkIds` y el nodo `parent` que tiene todo `SubgraphIO` y que los slots de nodo no tienen:

```js
function isSubgraphIO(slot) {
return slot != null && Array.isArray(slot.linkIds) && 'parent' in slot
}

nodeType.prototype.onConnectionsChange = function (
type,
index,
isConnected,
link,
slotOrIO
) {
if (isSubgraphIO(slotOrIO)) return
// slotOrIO is INodeInputSlot | INodeOutputSlot
}
```

## Suscribirse a eventos del ciclo de vida de los nodos con graph.events

`graph.events` emite `node:added`, `node:before-removed` y `node:removed`. Úsalos cuando más de una parte de tu extensión necesite observar cuándo se agrega o se elimina un nodo:

```ts
graph.events.addEventListener('node:added', (e) => {
console.log('added', e.detail.node.id)
})
```

`node.onAdded`, `node.onRemoved` y las versiones de un solo slot `graph.onNodeAdded`/`graph.onNodeRemoved` siguen funcionando, pero asignar `graph.onNodeAdded` reemplaza cualquier manejador existente: un segundo suscriptor descarta el primero sin aviso. Prefiere `graph.events` a menos que necesites vetar o modificar algo durante la adición o eliminación. No hay un equivalente con varios suscriptores para conectar y desconectar; `onConnectionsChange` sigue siendo el único hook por conexión.

## Al eliminar un nodo, las devoluciones de llamada se disparan en este orden (probado parcialmente)

Al eliminar un nodo, se disparan, en orden:

1. `node:before-removed`: el nodo sigue completamente vinculado al gráfico.
2. `onConnectionsChange(..., false, ...)` en el nodo eliminado y en cada nodo conectado a él, mientras el nodo eliminado todavía está en el gráfico.
3. `node.onRemoved()`: `node.graph` todavía está asignado.
4. El nodo se desvincula de los índices y almacenes del gráfico; `node.graph` pasa a ser `null`.
5. `onNodeRemoved(node)` y después `node:removed`, ambas ven un nodo ya desvinculado.

Las pruebas cubren `node:before-removed → node.onRemoved() → onNodeRemoved(node)` y verifican por separado que `node:removed` ve un nodo desvinculado. La secuencia completa, incluido el paso 2, se observa en el código fuente en lugar de estar garantizada por una prueba de extremo a extremo.

Para obtener el nodo eliminado desde el controlador `onConnectionsChange` de un nodo conectado, hazlo en el paso 2 mediante `graph.getNodeById()`. En el momento de `node:removed`, el nodo ya no existe.

## La carga del flujo de trabajo resuelve los nodos pares antes de que se ejecute onConnectionsChange

`graph.configure()` crea todos los nodos del flujo de trabajo antes de que se ejecute el `configure()` propio de cualquier nodo y de que se dispare `onConnectionsChange` para sus enlaces restaurados. Por eso, cuando tu callback `onConnectionsChange` se dispara durante la carga, todos los nodos pares ya existen y su enlace ya está registrado, así que `graph.getNodeById()` y las búsquedas de enlaces desde dentro de ese callback se resuelven correctamente.

## La importación de prompts de API no reconecta las entradas resueltas

`app.loadApiJson()` conecta cada entrada que se puede resolver sin ejecutar una segunda pasada de desconexión y reconexión. Las extensiones no deben depender de notificaciones duplicadas de `onConnectionsChange` durante la importación de prompts de API. Haz que cada controlador de conexión realice su trabajo en la primera notificación; mueve el trabajo que requiere el gráfico importado completo a `afterConfigureGraph` o `afterLoadGraph`.

Las entradas cuya salida de origen o slot de destino todavía no existe se reintentan mientras una pasada avanza. Esto conserva el comportamiento de las entradas dinámicas: una conexión exitosa puede crear el slot que necesita una conexión pendiente posterior. Las conexiones ya resueltas no se repiten, y una conexión rechazada por una extensión no se reintenta una vez que sus extremos están disponibles.

Esto solo cambia la importación de prompts de API. La carga normal de flujos de trabajo sigue usando `graph.configure()` como se describe arriba, y las firmas de los callbacks de conexión no cambian.

## Rechazar conexiones antes de que se creen

Para rechazar una conexión, devuelve `false` desde `onConnectOutput` en el nodo fuente o `onConnectInput` en el nodo objetivo. Ambos se ejecutan antes de que el gráfico cambie algo, así que un enlace existente en la entrada objetivo se mantiene en su lugar:

```js
nodeType.prototype.onConnectOutput = function (
slot,
type,
input,
targetNode,
targetSlot
) {
return !shouldReject(type, targetNode)
}
```

No rechaces desde `onConnectionsChange`. Cuando se ejecuta, el nuevo enlace ya ha reemplazado cualquier enlace que tuviera la entrada objetivo, así que eliminar el nuevo enlace deja la entrada desconectada.

## Quitar un enlace dentro del callback de salida omite el callback de entrada

Conectar un enlace llama primero al `onConnectionsChange` del lado de salida y después al del lado de entrada. Si el controlador del lado de salida elimina ese mismo enlace antes de retornar, el lado de entrada recibe un callback `isConnected === false` por la eliminación, y su callback `isConnected === true` para el nuevo enlace se omite. No asumas que ambos lados siempre ven la conexión; si tu controlador vuelve a entrar en el gráfico, verifica que el enlace que recibiste siga conectado. Este es un comportamiento observado, no un contrato probado: actualmente ninguna prueba ejercita la ruta de omisión.

## Reemplazar los eventos de slot eliminados

`node:slot-links:changed` y `node:slot-errors:changed` se eliminaron, sin
un evento de reemplazo con el mismo nombre. Migra a:

- `node.isInputConnected()`, `node.isOutputConnected()` o
`node.getOutputNodes()` para una lectura reactiva del estado de conectividad, o
- `onConnectionsChange` cuando necesites ejecutar código en el momento exacto en que un slot
se conecta o se desconecta.

## Leer el estado de las conexiones desde los argumentos del callback o los métodos del nodo

`input.link` y `output.links` están obsoletos, y las lecturas pueden desviarse del gráfico actual. Las escrituras solo eliminan enlaces: asignar `null` a `input.link` desconecta la entrada, y asignar o modificar `output.links` desconecta todos los enlaces que no estén en el nuevo arreglo. Las escrituras nunca crean enlaces; usa `node.connect()`, `node.disconnectInput()` o `node.disconnectOutput()`. Usa el argumento `link_info` que tu callback ya recibe, o los métodos de instancia de `LGraphNode` que leen directamente el almacén de enlaces: `node.isInputConnected()`, `node.getInputLink()`, `node.isOutputConnected()` y `node.getOutputNodes()`. No leas `input.link` ni `output.links`.

Las funciones del almacén detrás de estos métodos son internas y no forman parte de la API de extensión. Usa los métodos del nodo.
2 changes: 1 addition & 1 deletion es/custom-nodes/js/javascript_about_panel_badges.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Los iconos de las insignias usan clases de iconos de [Lucide](https://lucide.dev

El frontend genera estas clases al compilarse, así que solo están disponibles los iconos de Lucide que usa el propio frontend. Si un icono no se muestra, elige otro o define tu propia clase de icono en una hoja de estilos que cargue tu extensión.

Las clases de PrimeIcons como `pi pi-file` todavía se muestran por ahora, pero se están retirando gradualmente. No las uses en código nuevo. Consulta la [migración por la eliminación de PrimeVue](/custom-nodes/js/primevue-removal-migration).
Las clases de PrimeIcons como `pi pi-file` todavía se muestran por ahora, pero se están retirando gradualmente. No las uses en código nuevo. Consulta la [migración por la eliminación de PrimeVue](/es/custom-nodes/js/primevue-removal-migration).

## Ejemplo

Expand Down
4 changes: 2 additions & 2 deletions es/custom-nodes/js/javascript_selection_toolbox.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Selection Toolbox"
title: "Cuadro de herramientas de selección"
description: "Añade comandos de acción personalizados a Selection Toolbox de ComfyUI para nodos, grupos y elementos del lienzo seleccionados con getSelectionToolboxCommands."
translationSourceHash: 333b273c
translationFrom: custom-nodes/js/javascript_selection_toolbox.mdx
Expand Down Expand Up @@ -65,7 +65,7 @@ Los botones del cuadro de herramientas de selección usan clases de iconos de [L

El frontend genera estas clases al compilarse, así que solo están disponibles los iconos de Lucide que usa el propio frontend. Si un icono no se muestra, elige otro o define tu propia clase de icono en una hoja de estilos que cargue tu extensión.

Las clases de PrimeIcons (`pi pi-*`) y de Material Design Icons (`mdi mdi-*`) todavía se muestran por ahora, pero se están retirando gradualmente. No las uses en código nuevo. Consulta la [migración por la eliminación de PrimeVue](/custom-nodes/js/primevue-removal-migration).
Las clases de PrimeIcons (`pi pi-*`) y de Material Design Icons (`mdi mdi-*`) todavía se muestran por ahora, pero se están retirando gradualmente. No las uses en código nuevo. Consulta la [migración por la eliminación de PrimeVue](/es/custom-nodes/js/primevue-removal-migration).

## Visibilidad dinámica de comandos

Expand Down
4 changes: 2 additions & 2 deletions es/custom-nodes/js/javascript_settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ try {

### Configuración adicional

Cada tipo de configuración muestra un componente de formulario del frontend de ComfyUI. Puedes pasar props adicionales a ese componente en un campo `attrs`. Las props que admite cada tipo se indican en su sección más abajo.
Cada tipo de configuración muestra un componente de formulario del frontend de ComfyUI. Puedes pasar props adicionales a ese componente en un campo `attrs`. Las props que admite cada tipo se indican en [Tipos](#tipos).

Por ejemplo, esto limita una entrada de número a un rango y un paso:

Expand All @@ -109,7 +109,7 @@ Por ejemplo, esto limita una entrada de número a un rango y un paso:
},
}
```
Si tu extensión pasaba props de PrimeVue como `showButtons`, `maxFractionDigits`, `editable` o `filter`, consulta la [migración por la eliminación de PrimeVue](/custom-nodes/js/primevue-removal-migration). El panel de configuración ya no usa componentes de PrimeVue, así que esas props no tienen efecto.
Si tu extensión pasaba props de PrimeVue como `showButtons`, `maxFractionDigits`, `editable` o `filter`, consulta la [migración por la eliminación de PrimeVue](/es/custom-nodes/js/primevue-removal-migration). El panel de configuración ya no usa componentes de PrimeVue, así que esas props no tienen efecto.

## Tipos

Expand Down
2 changes: 1 addition & 1 deletion es/custom-nodes/js/javascript_sidebar_tabs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Los iconos de las pestañas de la barra lateral usan clases de iconos de [Lucide

El frontend genera estas clases al compilarse, así que solo están disponibles los iconos de Lucide que usa el propio frontend. Si un icono no se muestra, elige otro o define tu propia clase de icono en una hoja de estilos que cargue tu extensión.

Las clases de PrimeIcons (`pi pi-*`) y de Material Design Icons (`mdi mdi-*`) todavía se muestran por ahora, pero se están retirando gradualmente. No las uses en código nuevo. Consulta la [migración por la eliminación de PrimeVue](/custom-nodes/js/primevue-removal-migration).
Las clases de PrimeIcons (`pi pi-*`) y de Material Design Icons (`mdi mdi-*`) todavía se muestran por ahora, pero se están retirando gradualmente. No las uses en código nuevo. Consulta la [migración por la eliminación de PrimeVue](/es/custom-nodes/js/primevue-removal-migration).

## Ejemplo de pestaña con estado

Expand Down
Loading
Loading