Skip to main content
Puedes proporcionar a ComfyUI un objeto de configuraciones que aparecerá cuando el usuario abra el panel de configuraciones de ComfyUI.

Funcionamiento básico

Añadir una configuración

El id debe ser único en todas las extensiones y se usará para obtener los valores. Si no proporcionas una categoría, el id se dividirá por . para determinar dónde aparece en el panel de configuraciones.
  • Si tu id no contiene ningún ., aparecerá en la categoría “Other” y tu id se usará como encabezado de sección.
  • Si tu id contiene al menos un ., la parte más a la izquierda se usará como categoría de la configuración y la segunda parte se usará como encabezado de sección. Las demás partes se ignoran.

Leer una configuración

Reaccionar a los cambios

El controlador de eventos onChange() se llamará en cuanto el usuario cambie la configuración en el panel de configuraciones. También se llamará cuando se registre la extensión, en cada carga de página.

Escribir una configuración

Configuración adicional

Los tipos de configuración se basan en componentes de PrimeVue. Las props descritas en la documentación de PrimeVue se pueden definir para las configuraciones de ComfyUI añadiéndolas en un campo attrs. Por ejemplo, esto añade botones de incremento y decremento a una entrada numérica:

Tipos

Booleano (Boolean)

Muestra un interruptor de activado y desactivado. Basado en el componente ToggleSwitch de PrimeVue.

Texto (Text)

Es texto libre. Basado en el componente InputText de PrimeVue.

Número (Number)

Sirve para introducir números. Para permitir decimales, establece el atributo maxFractionDigits en un número mayor que cero. Basado en el componente InputNumber de PrimeVue.

Slider

Permite al usuario introducir un número directamente o mediante un slider. Basado en el componente Slider de PrimeVue. No se admiten rangos.

Combo

Permite al usuario elegir de una lista desplegable de valores. Puedes proporcionar las opciones como una cadena simple o como un objeto con los campos text y value. Si solo proporcionas una cadena simple, se usará para ambos. Puedes permitir que el usuario introduzca texto libre con el atributo editable: true, o que busque con el atributo filter: true. Basado en el componente Select de PrimeVue. No se admiten grupos.

Color

Permite al usuario seleccionar un color en un selector de color o escribir una referencia hexadecimal. Ten en cuenta que el formato requiere seis dígitos hexadecimales completos; la forma abreviada de tres dígitos no funciona. Basado en el componente ColorPicker de PrimeVue.

Imagen (Image)

Permite al usuario subir una imagen. La configuración se guardará como una URL de datos. Basado en el componente FileUpload de PrimeVue.

Oculto (Hidden)

Las configuraciones ocultas no se muestran en el panel de configuraciones, pero puedes leerlas y escribirlas desde tu código.

Otros

Categorías

Puedes especificar la categorización de tu configuración de forma independiente del id. Esto significa que puedes cambiar la categorización y los nombres sin cambiar el id y sin perder los valores que los usuarios ya hayan establecido.

Tooltips

Puedes añadir ayuda contextual adicional con el campo tooltip. Esto añade un pequeño icono ℹ︎ después del nombre del campo que mostrará el texto de ayuda cuando el usuario pase el cursor por encima.