Funcionamiento básico
Añadir una configuración
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
idno contiene ningún., aparecerá en la categoría “Other” y tuidse usará como encabezado de sección. - Si tu
idcontiene 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 eventosonChange() 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 campoattrs.
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 atributomaxFractionDigits 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 campostext 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 delid. 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 campotooltip. 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.