From a33d940d6e2ff77d96d15e714b48bd73ac4a44f5 Mon Sep 17 00:00:00 2001 From: Alexander Brown Date: Wed, 4 Nov 2026 00:17:53 +0000 Subject: [PATCH] docs(custom-nodes): replace PrimeVue and PrimeIcons guidance in extension pages Icon examples now use Lucide icon classes (icon-[lucide--]), and the settings page documents the attrs the current form components accept. Remaining PrimeVue mentions point to the PrimeVue removal migration note. Translated copies (es, ja, ko, zh) are updated by hand and their source hashes synced. Amp-Thread-ID: https://ampcode.com/threads/T-01a1a3e4-7b41-7016-9bc0-ee2b78a40e24 --- .../js/javascript_about_panel_badges.mdx | 36 +++++++----- .../js/javascript_selection_toolbox.mdx | 26 +++++---- custom-nodes/js/javascript_settings.mdx | 57 ++++++++----------- custom-nodes/js/javascript_sidebar_tabs.mdx | 21 ++++--- .../js/javascript_about_panel_badges.mdx | 33 +++++------ .../js/javascript_selection_toolbox.mdx | 33 +++++------ es/custom-nodes/js/javascript_settings.mdx | 45 ++++++--------- .../js/javascript_sidebar_tabs.mdx | 28 +++++---- .../js/javascript_about_panel_badges.mdx | 33 +++++------ .../js/javascript_selection_toolbox.mdx | 33 +++++------ ja/custom-nodes/js/javascript_settings.mdx | 44 ++++++-------- .../js/javascript_sidebar_tabs.mdx | 28 +++++---- .../js/javascript_about_panel_badges.mdx | 33 +++++------ .../js/javascript_selection_toolbox.mdx | 33 +++++------ ko/custom-nodes/js/javascript_settings.mdx | 44 ++++++-------- .../js/javascript_sidebar_tabs.mdx | 28 +++++---- .../js/javascript_about_panel_badges.mdx | 33 +++++------ .../js/javascript_selection_toolbox.mdx | 33 +++++------ zh/custom-nodes/js/javascript_settings.mdx | 44 ++++++-------- .../js/javascript_sidebar_tabs.mdx | 28 +++++---- 20 files changed, 329 insertions(+), 364 deletions(-) diff --git a/custom-nodes/js/javascript_about_panel_badges.mdx b/custom-nodes/js/javascript_about_panel_badges.mdx index fb76be5491..905e925ecf 100644 --- a/custom-nodes/js/javascript_about_panel_badges.mdx +++ b/custom-nodes/js/javascript_about_panel_badges.mdx @@ -14,12 +14,12 @@ app.registerExtension({ { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-file" + icon: "icon-[lucide--file]" }, { label: "GitHub", url: "https://github.com/username/repo", - icon: "pi pi-github" + icon: "icon-[lucide--github]" } ] }); @@ -33,23 +33,29 @@ Each badge requires all of these properties: { label: string, // Text to display on the badge url: string, // URL to open when badge is clicked - icon: string // Icon class (e.g., PrimeVue icon) + icon: string // Icon class (e.g., "icon-[lucide--github]") } ``` ## Icon Options -Badge icons use PrimeVue's icon set. Here are some commonly used icons: +Badge icons use [Lucide](https://lucide.dev/icons/) icon classes in the form +`icon-[lucide--]`. Here are some commonly used icons: -- Documentation: `pi pi-file` or `pi pi-book` -- GitHub: `pi pi-github` -- External link: `pi pi-external-link` -- Information: `pi pi-info-circle` -- Download: `pi pi-download` -- Website: `pi pi-globe` -- Discord: `pi pi-discord` +- Documentation: `icon-[lucide--file]` or `icon-[lucide--book-open]` +- GitHub: `icon-[lucide--github]` +- External link: `icon-[lucide--external-link]` +- Information: `icon-[lucide--info]` +- Download: `icon-[lucide--download]` +- Website: `icon-[lucide--globe]` -For a complete list of available icons, refer to the [PrimeVue Icons documentation](https://primevue.org/icons/). +The frontend generates these classes when it is built, so only the Lucide icons that +the frontend itself uses are available. If an icon does not render, pick another +icon, or define your own icon class in a stylesheet that your extension loads. + +PrimeIcons classes such as `pi pi-file` still render for now, but they are being +phased out. Don't use them in new code. See [PrimeVue removal +migration](/custom-nodes/js/primevue-removal-migration). ## Example @@ -60,17 +66,17 @@ app.registerExtension({ { label: "Website", url: "https://example.com", - icon: "pi pi-home" + icon: "icon-[lucide--globe]" }, { label: "Donate", url: "https://example.com/donate", - icon: "pi pi-heart" + icon: "icon-[lucide--heart]" }, { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-book" + icon: "icon-[lucide--book-open]" } ] }); diff --git a/custom-nodes/js/javascript_selection_toolbox.mdx b/custom-nodes/js/javascript_selection_toolbox.mdx index 4b3ead8ede..6dc3aa1013 100644 --- a/custom-nodes/js/javascript_selection_toolbox.mdx +++ b/custom-nodes/js/javascript_selection_toolbox.mdx @@ -20,7 +20,7 @@ app.registerExtension({ { id: "my-extension.duplicate-special", label: "Duplicate Special", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: (selectedItem) => { // Your command logic here console.log("Duplicating selected nodes with special behavior"); @@ -51,10 +51,16 @@ The `function` receives the selected item(s) as a parameter, allowing you to per ## Icon Options -Selection toolbox buttons support the same icon libraries as other UI elements: +Selection toolbox buttons use [Lucide](https://lucide.dev/icons/) icon classes in +the form `icon-[lucide--]` (e.g., `icon-[lucide--star]`). -- PrimeVue icons: `pi pi-[icon-name]` (e.g., `pi pi-star`) -- Material Design icons: `mdi mdi-[icon-name]` (e.g., `mdi mdi-content-copy`) +The frontend generates these classes when it is built, so only the Lucide icons that +the frontend itself uses are available. If an icon does not render, pick another +icon, or define your own icon class in a stylesheet that your extension loads. + +PrimeIcons (`pi pi-*`) and Material Design Icons (`mdi mdi-*`) classes still +render for now, but they are being phased out. Don't use them in new code. See +[PrimeVue removal migration](/custom-nodes/js/primevue-removal-migration). ## Dynamic Command Visibility @@ -67,7 +73,7 @@ app.registerExtension({ { id: "my-ext.align-nodes", label: "Align Nodes", - icon: "pi pi-align-left", + icon: "icon-[lucide--align-start-vertical]", function: () => { // Align multiple nodes } @@ -75,7 +81,7 @@ app.registerExtension({ { id: "my-ext.configure-single", label: "Configure", - icon: "pi pi-cog", + icon: "icon-[lucide--settings]", function: () => { // Configure single node } @@ -109,7 +115,7 @@ app.registerExtension({ { id: "my-ext.show-info", label: "Show Selection Info", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const selectedItems = app.canvas.selectedItems; @@ -141,7 +147,7 @@ app.registerExtension({ { id: "selection-tools.count", label: "Count Selection", - icon: "pi pi-hashtag", + icon: "icon-[lucide--tag]", function: () => { const count = app.canvas.selectedItems?.size || 0; app.extensionManager.toast.add({ @@ -155,7 +161,7 @@ app.registerExtension({ { id: "selection-tools.copy-ids", label: "Copy IDs", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const ids = items.map(item => item.id).filter(id => id !== undefined); @@ -174,7 +180,7 @@ app.registerExtension({ { id: "selection-tools.log-types", label: "Log Types", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const typeCount = {}; diff --git a/custom-nodes/js/javascript_settings.mdx b/custom-nodes/js/javascript_settings.mdx index 2647600041..2cd7702c09 100644 --- a/custom-nodes/js/javascript_settings.mdx +++ b/custom-nodes/js/javascript_settings.mdx @@ -83,11 +83,11 @@ try { ### Extra configuration -The setting types are based on [PrimeVue](https://primevue.org/) components. -Props described in the PrimeVue documentation can be defined for ComfyUI -settings by adding them in an `attrs` field. +Each setting type renders a ComfyUI frontend form component. You can pass +extra props to that component in an `attrs` field. The props each type +supports are listed under [Types](#types). -For instance, this adds increment/decrement buttons to a number input: +For instance, this limits a number input to a range and step: ```javascript { @@ -96,7 +96,9 @@ For instance, this adds increment/decrement buttons to a number input: type: "number", defaultValue: 0, attrs: { - showButtons: true, + min: 0, + max: 100, + step: 5, }, onChange: (newVal, oldVal) => { console.log(`Setting was changed from ${oldVal} to ${newVal}`); @@ -105,15 +107,17 @@ For instance, this adds increment/decrement buttons to a number input: ``` +If your extension passed PrimeVue props such as `showButtons`, +`maxFractionDigits`, `editable` or `filter`, see [PrimeVue removal +migration](/custom-nodes/js/primevue-removal-migration). The settings panel no +longer uses PrimeVue components, so those props have no effect. + ## Types ### Boolean This shows an on/off toggle. -Based on the [ToggleSwitch PrimeVue -component](https://primevue.org/toggleswitch/). - ```javascript { id: "example.boolean", @@ -130,8 +134,6 @@ component](https://primevue.org/toggleswitch/). This is freeform text. -Based on the [InputText PrimeVue component](https://primevue.org/inputtext/). - ```javascript { id: "example.text", @@ -148,10 +150,10 @@ Based on the [InputText PrimeVue component](https://primevue.org/inputtext/). This for entering numbers. -To allow decimal places, set the `maxFractionDigits` attribute to a number greater than zero. - -Based on the [InputNumber PrimeVue -component](https://primevue.org/inputnumber/). +The input always shows increment and decrement buttons. Supported `attrs` are +`min`, `max`, `step` and `formatOptions`. `formatOptions` takes +[`Intl.NumberFormatOptions`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options), +so `maximumFractionDigits` controls how many decimal places are shown. ```javascript { @@ -160,8 +162,8 @@ component](https://primevue.org/inputnumber/). type: "number", defaultValue: 42, attrs: { - showButtons: true, - maxFractionDigits: 1, + step: 0.1, + formatOptions: { maximumFractionDigits: 1 }, }, onChange: (newVal, oldVal) => { console.log(`Setting was changed from ${oldVal} to ${newVal}`); @@ -173,8 +175,7 @@ component](https://primevue.org/inputnumber/). This lets the user enter a number directly or via a slider. -Based on the [Slider PrimeVue component](https://primevue.org/slider/). Ranges -are not supported. +Supported `attrs` are `min`, `max` and `step`. Ranges are not supported. ```javascript { @@ -201,11 +202,8 @@ You can provide options either as a plain string or as an object with `text` and `value` fields. If you only provide a plain string, then it will be used for both. -You can let the user enter freeform text by supplying the `editable: true` -attribute, or search by supplying the `filter: true` attribute. - -Based on the [Select PrimeVue component](https://primevue.org/select/). Groups -are not supported. +You can let the user search the list by supplying the `searchable: true` +attribute. Groups and freeform text entry are not supported. ```javascript { @@ -218,8 +216,7 @@ are not supported. "My second option", ], attrs: { - editable: true, - filter: true, + searchable: true, }, onChange: (newVal, oldVal) => { console.log(`Setting was changed from ${oldVal} to ${newVal}`); @@ -232,11 +229,8 @@ are not supported. This lets the user select a color from a color picker or type in a hex reference. -Note that the format requires six full hex digits - three digit shorthand does -not work. - -Based on the [ColorPicker PrimeVue -component](https://primevue.org/colorpicker/). +Note that the format requires six full hex digits (or eight, with alpha). Three +digit shorthand does not work. ```javascript { @@ -257,9 +251,6 @@ This lets the user upload an image. The setting will be saved as a [data URL](https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data). -Based on the [FileUpload PrimeVue -component](https://primevue.org/fileupload/). - ```javascript { id: "example.image", diff --git a/custom-nodes/js/javascript_sidebar_tabs.mdx b/custom-nodes/js/javascript_sidebar_tabs.mdx index 1189489e2e..9f165799cd 100644 --- a/custom-nodes/js/javascript_sidebar_tabs.mdx +++ b/custom-nodes/js/javascript_sidebar_tabs.mdx @@ -10,7 +10,7 @@ The Sidebar Tabs API allows extensions to add custom tabs to the sidebar of the ```javascript app.extensionManager.registerSidebarTab({ id: "customSidebar", - icon: "pi pi-compass", + icon: "icon-[lucide--compass]", title: "Custom Tab", tooltip: "My Custom Sidebar Tab", type: "custom", @@ -39,13 +39,16 @@ The `render` function receives a DOM element where you should insert your tab's ## Icon Options -Sidebar tab icons can use various icon sets: +Sidebar tab icons use [Lucide](https://lucide.dev/icons/) icon classes in the form +`icon-[lucide--]` (e.g., `icon-[lucide--compass]`). -- PrimeVue icons: `pi pi-[icon-name]` (e.g., `pi pi-home`) -- Material Design icons: `mdi mdi-[icon-name]` (e.g., `mdi mdi-robot`) -- Font Awesome icons: `fa-[style] fa-[icon-name]` (e.g., `fa-solid fa-star`) +The frontend generates these classes when it is built, so only the Lucide icons that +the frontend itself uses are available. If an icon does not render, pick another +icon, or define your own icon class in a stylesheet that your extension loads. -Ensure the corresponding icon library is loaded before using these icons. +PrimeIcons (`pi pi-*`) and Material Design Icons (`mdi mdi-*`) classes still +render for now, but they are being phased out. Don't use them in new code. See +[PrimeVue removal migration](/custom-nodes/js/primevue-removal-migration). ## Stateful Tab Example @@ -54,7 +57,7 @@ You can create tabs that maintain state: ```javascript app.extensionManager.registerSidebarTab({ id: "statefulTab", - icon: "pi pi-list", + icon: "icon-[lucide--list]", title: "Notes", type: "custom", render: (el) => { @@ -97,7 +100,7 @@ import ReactDOM from "react-dom/client"; // Register sidebar tab with React content app.extensionManager.registerSidebarTab({ id: "reactSidebar", - icon: "mdi mdi-react", + icon: "icon-[lucide--blocks]", title: "React Tab", type: "custom", render: (el) => { @@ -139,7 +142,7 @@ You can update sidebar content in response to graph changes: ```javascript app.extensionManager.registerSidebarTab({ id: "dynamicSidebar", - icon: "pi pi-chart-line", + icon: "icon-[lucide--activity]", title: "Stats", type: "custom", render: (el) => { diff --git a/es/custom-nodes/js/javascript_about_panel_badges.mdx b/es/custom-nodes/js/javascript_about_panel_badges.mdx index c9b589d701..3cd405d312 100644 --- a/es/custom-nodes/js/javascript_about_panel_badges.mdx +++ b/es/custom-nodes/js/javascript_about_panel_badges.mdx @@ -1,7 +1,7 @@ --- title: "Insignias del panel Acerca de" description: "Agrega insignias personalizadas con etiquetas, URL e iconos al panel Acerca de de ComfyUI mediante la API About Panel Badges." -translationSourceHash: e9fe305d +translationSourceHash: 9e3d732a translationFrom: custom-nodes/js/javascript_about_panel_badges.mdx --- @@ -16,12 +16,12 @@ app.registerExtension({ { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-file" + icon: "icon-[lucide--file]" }, { label: "GitHub", url: "https://github.com/username/repo", - icon: "pi pi-github" + icon: "icon-[lucide--github]" } ] }); @@ -35,23 +35,24 @@ Cada insignia requiere todas estas propiedades: { label: string, // Texto que se muestra en la insignia url: string, // URL que se abre al hacer clic en la insignia - icon: string // Clase de icono (por ejemplo, un icono de PrimeVue) + icon: string // Clase de icono (por ejemplo, "icon-[lucide--github]") } ``` ## Opciones de iconos -Los iconos de las insignias usan el conjunto de iconos de PrimeVue. Estos son algunos de los iconos más usados: +Los iconos de las insignias usan clases de iconos de [Lucide](https://lucide.dev/icons/) con el formato `icon-[lucide--]`. Estos son algunos de los iconos más usados: -- Documentación: `pi pi-file` o `pi pi-book` -- GitHub: `pi pi-github` -- Enlace externo: `pi pi-external-link` -- Información: `pi pi-info-circle` -- Descargar: `pi pi-download` -- Sitio web: `pi pi-globe` -- Discord: `pi pi-discord` +- Documentación: `icon-[lucide--file]` o `icon-[lucide--book-open]` +- GitHub: `icon-[lucide--github]` +- Enlace externo: `icon-[lucide--external-link]` +- Información: `icon-[lucide--info]` +- Descargar: `icon-[lucide--download]` +- Sitio web: `icon-[lucide--globe]` -Para ver la lista completa de iconos disponibles, consulta la [documentación de iconos de PrimeVue](https://primevue.org/icons/). +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). ## Ejemplo @@ -62,17 +63,17 @@ app.registerExtension({ { label: "Website", url: "https://example.com", - icon: "pi pi-home" + icon: "icon-[lucide--globe]" }, { label: "Donate", url: "https://example.com/donate", - icon: "pi pi-heart" + icon: "icon-[lucide--heart]" }, { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-book" + icon: "icon-[lucide--book-open]" } ] }); diff --git a/es/custom-nodes/js/javascript_selection_toolbox.mdx b/es/custom-nodes/js/javascript_selection_toolbox.mdx index 10583dc161..40bf097393 100644 --- a/es/custom-nodes/js/javascript_selection_toolbox.mdx +++ b/es/custom-nodes/js/javascript_selection_toolbox.mdx @@ -1,16 +1,16 @@ --- title: "Selection Toolbox" description: "Añade comandos de acción personalizados a Selection Toolbox de ComfyUI para nodos, grupos y elementos del lienzo seleccionados con getSelectionToolboxCommands." -translationSourceHash: f66d3f91 +translationSourceHash: 333b273c translationFrom: custom-nodes/js/javascript_selection_toolbox.mdx translationBlockHashes: "_intro": 356ec52a - "Basic Usage": a850ba5d + "Basic Usage": 33dac51e "Command Definition": b0aab3a4 - "Icon Options": c511932a - "Dynamic Command Visibility": 49b6198d - "Working with Selected Items": 90ff1ddb - "Complete Example": dc8a50e4 + "Icon Options": 9122c5e1 + "Dynamic Command Visibility": a3bcf2c6 + "Working with Selected Items": 6c9c69b4 + "Complete Example": 90ad0a46 "Notes": 6f71c3bf --- @@ -31,7 +31,7 @@ app.registerExtension({ { id: "my-extension.duplicate-special", label: "Duplicate Special", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: (selectedItem) => { // Your command logic here console.log("Duplicating selected nodes with special behavior"); @@ -61,10 +61,11 @@ La `function` recibe el elemento o los elementos seleccionados como parámetro, ## Opciones de iconos -Los botones del cuadro de herramientas de selección admiten las mismas bibliotecas de iconos que otros elementos de la interfaz: +Los botones del cuadro de herramientas de selección usan clases de iconos de [Lucide](https://lucide.dev/icons/) con el formato `icon-[lucide--]` (por ejemplo, `icon-[lucide--star]`). -- Iconos de PrimeVue: `pi pi-[icon-name]` (por ejemplo, `pi pi-star`) -- Iconos de Material Design: `mdi mdi-[icon-name]` (por ejemplo, `mdi mdi-content-copy`) +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). ## Visibilidad dinámica de comandos @@ -77,7 +78,7 @@ app.registerExtension({ { id: "my-ext.align-nodes", label: "Align Nodes", - icon: "pi pi-align-left", + icon: "icon-[lucide--align-start-vertical]", function: () => { // Align multiple nodes } @@ -85,7 +86,7 @@ app.registerExtension({ { id: "my-ext.configure-single", label: "Configure", - icon: "pi pi-cog", + icon: "icon-[lucide--settings]", function: () => { // Configure single node } @@ -118,7 +119,7 @@ app.registerExtension({ { id: "my-ext.show-info", label: "Show Selection Info", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const selectedItems = app.canvas.selectedItems; @@ -149,7 +150,7 @@ app.registerExtension({ { id: "selection-tools.count", label: "Count Selection", - icon: "pi pi-hashtag", + icon: "icon-[lucide--tag]", function: () => { const count = app.canvas.selectedItems?.size || 0; app.extensionManager.toast.add({ @@ -163,7 +164,7 @@ app.registerExtension({ { id: "selection-tools.copy-ids", label: "Copy IDs", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const ids = items.map(item => item.id).filter(id => id !== undefined); @@ -182,7 +183,7 @@ app.registerExtension({ { id: "selection-tools.log-types", label: "Log Types", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const typeCount = {}; diff --git a/es/custom-nodes/js/javascript_settings.mdx b/es/custom-nodes/js/javascript_settings.mdx index 9bad36ae80..0d1b52e233 100644 --- a/es/custom-nodes/js/javascript_settings.mdx +++ b/es/custom-nodes/js/javascript_settings.mdx @@ -1,12 +1,12 @@ --- title: "API de configuraciones" description: "Agrega, lee, escribe y reacciona a las configuraciones de extensiones de ComfyUI con app.registerExtension: tipos booleano, texto, número, slider, combo, color e imagen." -translationSourceHash: 30dee1fd +translationSourceHash: d1a5f9a1 translationFrom: custom-nodes/js/javascript_settings.mdx translationBlockHashes: "_intro": ac25633e - "Basic operation": 2cef8fa5 - "Types": 00f1c38c + "Basic operation": 4c40d43d + "Types": a9f6d073 "Other": 0bbfcc3c --- @@ -89,11 +89,9 @@ try { ### Configuración adicional -Los tipos de configuración se basan en componentes de [PrimeVue](https://primevue.org/). -Puedes definir las props descritas en la documentación de PrimeVue para las -configuraciones de ComfyUI agregándolas en un campo `attrs`. +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. -Por ejemplo, esto agrega botones de incremento y decremento a una entrada de número: +Por ejemplo, esto limita una entrada de número a un rango y un paso: ```javascript { @@ -102,21 +100,23 @@ Por ejemplo, esto agrega botones de incremento y decremento a una entrada de nú type: "number", defaultValue: 0, attrs: { - showButtons: true, + min: 0, + max: 100, + step: 5, }, onChange: (newVal, oldVal) => { console.log(`Setting was changed from ${oldVal} to ${newVal}`); }, } ``` +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. + ## Tipos ### Booleano Muestra un interruptor de activado/desactivado. -Basado en el [componente ToggleSwitch de PrimeVue](https://primevue.org/toggleswitch/). - ```javascript { id: "example.boolean", @@ -133,8 +133,6 @@ Basado en el [componente ToggleSwitch de PrimeVue](https://primevue.org/togglesw Es texto de forma libre. -Basado en el [componente InputText de PrimeVue](https://primevue.org/inputtext/). - ```javascript { id: "example.text", @@ -151,9 +149,7 @@ Basado en el [componente InputText de PrimeVue](https://primevue.org/inputtext/) 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](https://primevue.org/inputnumber/). +La entrada siempre muestra botones de incremento y decremento. Los `attrs` admitidos son `min`, `max`, `step` y `formatOptions`. `formatOptions` acepta [`Intl.NumberFormatOptions`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options), así que `maximumFractionDigits` controla cuántos decimales se muestran. ```javascript { @@ -162,8 +158,8 @@ Basado en el [componente InputNumber de PrimeVue](https://primevue.org/inputnumb type: "number", defaultValue: 42, attrs: { - showButtons: true, - maxFractionDigits: 1, + step: 0.1, + formatOptions: { maximumFractionDigits: 1 }, }, onChange: (newVal, oldVal) => { console.log(`Setting was changed from ${oldVal} to ${newVal}`); @@ -175,7 +171,7 @@ Basado en el [componente InputNumber de PrimeVue](https://primevue.org/inputnumb Permite al usuario introducir un número directamente o mediante un control deslizante. -Basado en el [componente Slider de PrimeVue](https://primevue.org/slider/). No se admiten rangos. +Los `attrs` admitidos son `min`, `max` y `step`. No se admiten rangos. ```javascript { @@ -200,9 +196,7 @@ 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á tanto como texto como valor. -Puedes permitir que el usuario introduzca texto libre aportando el atributo `editable: true`, o que busque aportando el atributo `filter: true`. - -Basado en el [componente Select de PrimeVue](https://primevue.org/select/). No se admiten grupos. +Puedes permitir que el usuario busque en la lista aportando el atributo `searchable: true`. No se admiten grupos ni la entrada de texto libre. ```javascript { @@ -215,8 +209,7 @@ Basado en el [componente Select de PrimeVue](https://primevue.org/select/). No s "My second option", ], attrs: { - editable: true, - filter: true, + searchable: true, }, onChange: (newVal, oldVal) => { console.log(`Setting was changed from ${oldVal} to ${newVal}`); @@ -228,9 +221,7 @@ Basado en el [componente Select de PrimeVue](https://primevue.org/select/). No s Permite al usuario seleccionar un color desde 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](https://primevue.org/colorpicker/). +Ten en cuenta que el formato requiere seis dígitos hexadecimales completos (u ocho, con alfa). La forma abreviada de tres dígitos no funciona. ```javascript { @@ -250,8 +241,6 @@ Permite al usuario subir una imagen. La configuración se guarda como [data URL](https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data). -Basado en el [componente FileUpload de PrimeVue](https://primevue.org/fileupload/). - ```javascript { id: "example.image", diff --git a/es/custom-nodes/js/javascript_sidebar_tabs.mdx b/es/custom-nodes/js/javascript_sidebar_tabs.mdx index 0985a4da11..d9bbbb45cf 100644 --- a/es/custom-nodes/js/javascript_sidebar_tabs.mdx +++ b/es/custom-nodes/js/javascript_sidebar_tabs.mdx @@ -1,16 +1,16 @@ --- title: "Pestañas de la barra lateral" description: "Domina la API de Comfy Extension y crea pestañas personalizadas en la barra lateral. Explora ejemplos de React y actualizaciones dinámicas. Lee la documentación." -translationSourceHash: bf389e93 +translationSourceHash: af1c491b translationFrom: custom-nodes/js/javascript_sidebar_tabs.mdx translationBlockHashes: "_intro": 3df6f709 - "Basic Usage": 8dc773cb + "Basic Usage": 2bebd35b "Tab Configuration": f4594df2 - "Icon Options": 32c3f0a8 - "Stateful Tab Example": 063a70c3 - "Using React Components": 68aa4ede - "Dynamic Content Updates": d90422de + "Icon Options": 9ccf6f62 + "Stateful Tab Example": 9a13d974 + "Using React Components": d846d348 + "Dynamic Content Updates": 51fb66f8 --- La API de Sidebar Tabs permite que las extensiones agreguen pestañas personalizadas a la barra lateral de la interfaz de ComfyUI. Esto es útil para agregar funciones que requieren visibilidad persistente y acceso rápido. @@ -20,7 +20,7 @@ La API de Sidebar Tabs permite que las extensiones agreguen pestañas personaliz ```javascript app.extensionManager.registerSidebarTab({ id: "customSidebar", - icon: "pi pi-compass", + icon: "icon-[lucide--compass]", title: "Custom Tab", tooltip: "My Custom Sidebar Tab", type: "custom", @@ -48,13 +48,11 @@ La función `render` recibe un elemento DOM donde debes insertar el contenido de ## Opciones de iconos -Los iconos de las pestañas de la barra lateral pueden usar varios conjuntos de iconos: +Los iconos de las pestañas de la barra lateral usan clases de iconos de [Lucide](https://lucide.dev/icons/) con el formato `icon-[lucide--]` (por ejemplo, `icon-[lucide--compass]`). -- Iconos de PrimeVue: `pi pi-[icon-name]` (por ejemplo, `pi pi-home`) -- Iconos de Material Design: `mdi mdi-[icon-name]` (por ejemplo, `mdi mdi-robot`) -- Iconos de Font Awesome: `fa-[style] fa-[icon-name]` (por ejemplo, `fa-solid fa-star`) +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. -Asegúrate de que la biblioteca de iconos correspondiente esté cargada antes de usar estos iconos. +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). ## Ejemplo de pestaña con estado @@ -63,7 +61,7 @@ Puedes crear pestañas que conservan su estado: ```javascript app.extensionManager.registerSidebarTab({ id: "statefulTab", - icon: "pi pi-list", + icon: "icon-[lucide--list]", title: "Notes", type: "custom", render: (el) => { @@ -105,7 +103,7 @@ import ReactDOM from "react-dom/client"; // Registra la pestaña de la barra lateral con contenido de React app.extensionManager.registerSidebarTab({ id: "reactSidebar", - icon: "mdi mdi-react", + icon: "icon-[lucide--blocks]", title: "React Tab", type: "custom", render: (el) => { @@ -147,7 +145,7 @@ Puedes actualizar el contenido de la barra lateral en respuesta a cambios en el ```javascript app.extensionManager.registerSidebarTab({ id: "dynamicSidebar", - icon: "pi pi-chart-line", + icon: "icon-[lucide--activity]", title: "Stats", type: "custom", render: (el) => { diff --git a/ja/custom-nodes/js/javascript_about_panel_badges.mdx b/ja/custom-nodes/js/javascript_about_panel_badges.mdx index 6478fcd0b1..c78c197719 100644 --- a/ja/custom-nodes/js/javascript_about_panel_badges.mdx +++ b/ja/custom-nodes/js/javascript_about_panel_badges.mdx @@ -1,7 +1,7 @@ --- title: "情報パネルバッジ" description: "About Panel Badges API を使って ComfyUI の About パネルにラベル・URL・アイコン付きのカスタムバッジを追加し、ドキュメントや GitHub、拡張リソースへリンクできます。" -translationSourceHash: e9fe305d +translationSourceHash: 9e3d732a translationFrom: custom-nodes/js/javascript_about_panel_badges.mdx --- @@ -16,12 +16,12 @@ app.registerExtension({ { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-file" + icon: "icon-[lucide--file]" }, { label: "GitHub", url: "https://github.com/username/repo", - icon: "pi pi-github" + icon: "icon-[lucide--github]" } ] }); @@ -35,23 +35,24 @@ app.registerExtension({ { label: string, // バッジに表示されるテキスト url: string, // バッジがクリックされたときに開く URL - icon: string // アイコンクラス(例:PrimeVue アイコン) + icon: string // アイコンクラス(例:"icon-[lucide--github]") } ``` ## アイコンオプション -バッジのアイコンには PrimeVue のアイコンセットが使用されます。以下はよく使用されるアイコンの一部です: +バッジのアイコンには、`icon-[lucide--]` 形式の [Lucide](https://lucide.dev/icons/) アイコンクラスを使用します。以下はよく使用されるアイコンの一部です: -- ドキュメント:`pi pi-file` または `pi pi-book` -- GitHub: `pi pi-github` -- 外部リンク:`pi pi-external-link` -- 情報:`pi pi-info-circle` -- ダウンロード:`pi pi-download` -- ウェブサイト:`pi pi-globe` -- Discord: `pi pi-discord` +- ドキュメント:`icon-[lucide--file]` または `icon-[lucide--book-open]` +- GitHub: `icon-[lucide--github]` +- 外部リンク:`icon-[lucide--external-link]` +- 情報:`icon-[lucide--info]` +- ダウンロード:`icon-[lucide--download]` +- ウェブサイト:`icon-[lucide--globe]` -利用可能なアイコンの完全なリストについては、[PrimeVue アイコンドキュメント](https://primevue.org/icons/) を参照してください。 +これらのクラスはフロントエンドのビルド時に生成されるため、使用できるのはフロントエンド自体が使用している Lucide アイコンのみです。アイコンが表示されない場合は、別のアイコンを選ぶか、拡張機能が読み込むスタイルシートで独自のアイコンクラスを定義してください。 + +`pi pi-file` などの PrimeIcons クラスは現時点ではまだ表示されますが、段階的に廃止されています。新しいコードでは使用しないでください。[PrimeVue 削除に伴う移行](/custom-nodes/js/primevue-removal-migration) を参照してください。 ## 例 @@ -62,17 +63,17 @@ app.registerExtension({ { label: "Website", url: "https://example.com", - icon: "pi pi-home" + icon: "icon-[lucide--globe]" }, { label: "Donate", url: "https://example.com/donate", - icon: "pi pi-heart" + icon: "icon-[lucide--heart]" }, { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-book" + icon: "icon-[lucide--book-open]" } ] }); diff --git a/ja/custom-nodes/js/javascript_selection_toolbox.mdx b/ja/custom-nodes/js/javascript_selection_toolbox.mdx index 6e9ed7fae6..75f85e7175 100644 --- a/ja/custom-nodes/js/javascript_selection_toolbox.mdx +++ b/ja/custom-nodes/js/javascript_selection_toolbox.mdx @@ -1,16 +1,16 @@ --- title: "選択ツールボックス" description: "getSelectionToolboxCommands を使い、選択中のノード、グループ、キャンバス項目向けに ComfyUI の選択ツールボックスへカスタムアクションコマンドを追加します。" -translationSourceHash: f66d3f91 +translationSourceHash: 333b273c translationFrom: custom-nodes/js/javascript_selection_toolbox.mdx translationBlockHashes: "_intro": 356ec52a - "Basic Usage": a850ba5d + "Basic Usage": 33dac51e "Command Definition": b0aab3a4 - "Icon Options": c511932a - "Dynamic Command Visibility": 49b6198d - "Working with Selected Items": 90ff1ddb - "Complete Example": dc8a50e4 + "Icon Options": 9122c5e1 + "Dynamic Command Visibility": a3bcf2c6 + "Working with Selected Items": 6c9c69b4 + "Complete Example": 90ad0a46 "Notes": 6f71c3bf --- @@ -31,7 +31,7 @@ app.registerExtension({ { id: "my-extension.duplicate-special", label: "特殊複製", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: (selectedItem) => { // ここにコマンドのロジックを記述 console.log("特殊な動作で選択されたノードを複製中"); @@ -62,10 +62,11 @@ app.registerExtension({ ## アイコンオプション -選択ツールボックスのボタンは、他の UI 要素と同じアイコンライブラリをサポートします: +選択ツールボックスのボタンには、`icon-[lucide--]` 形式の [Lucide](https://lucide.dev/icons/) アイコンクラスを使用します(例:`icon-[lucide--star]`)。 -- PrimeVue アイコン:`pi pi-[icon-name]`(例:`pi pi-star`) -- Material Design アイコン:`mdi mdi-[icon-name]`(例:`mdi mdi-content-copy`) +これらのクラスはフロントエンドのビルド時に生成されるため、使用できるのはフロントエンド自体が使用している Lucide アイコンのみです。アイコンが表示されない場合は、別のアイコンを選ぶか、拡張機能が読み込むスタイルシートで独自のアイコンクラスを定義してください。 + +PrimeIcons(`pi pi-*`)と Material Design Icons(`mdi mdi-*`)のクラスは現時点ではまだ表示されますが、段階的に廃止されています。新しいコードでは使用しないでください。[PrimeVue 削除に伴う移行](/custom-nodes/js/primevue-removal-migration) を参照してください。 ## 動的なコマンドの表示 @@ -78,7 +79,7 @@ app.registerExtension({ { id: "my-ext.align-nodes", label: "ノードを整列", - icon: "pi pi-align-left", + icon: "icon-[lucide--align-start-vertical]", function: () => { // 複数のノードを整列 } @@ -86,7 +87,7 @@ app.registerExtension({ { id: "my-ext.configure-single", label: "設定", - icon: "pi pi-cog", + icon: "icon-[lucide--settings]", function: () => { // 単一のノードを設定 } @@ -120,7 +121,7 @@ app.registerExtension({ { id: "my-ext.show-info", label: "選択情報を表示", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const selectedItems = app.canvas.selectedItems; @@ -152,7 +153,7 @@ app.registerExtension({ { id: "selection-tools.count", label: "選択数をカウント", - icon: "pi pi-hashtag", + icon: "icon-[lucide--tag]", function: () => { const count = app.canvas.selectedItems?.size || 0; app.extensionManager.toast.add({ @@ -166,7 +167,7 @@ app.registerExtension({ { id: "selection-tools.copy-ids", label: "ID をコピー", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const ids = items.map(item => item.id).filter(id => id !== undefined); @@ -185,7 +186,7 @@ app.registerExtension({ { id: "selection-tools.log-types", label: "タイプをログ出力", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const typeCount = {}; diff --git a/ja/custom-nodes/js/javascript_settings.mdx b/ja/custom-nodes/js/javascript_settings.mdx index ece2ed1087..ed3f7798c1 100644 --- a/ja/custom-nodes/js/javascript_settings.mdx +++ b/ja/custom-nodes/js/javascript_settings.mdx @@ -1,12 +1,12 @@ --- title: "設定 API" description: "app.registerExtension を使って ComfyUI 拡張の設定を追加・読み取り・書き込みし、変更に反応する方法。boolean、text、number、slider、combo、color、image などの設定タイプをカバーします。" -translationSourceHash: 30dee1fd +translationSourceHash: d1a5f9a1 translationFrom: custom-nodes/js/javascript_settings.mdx translationBlockHashes: "_intro": ac25633e - "Basic operation": 2cef8fa5 - "Types": 00f1c38c + "Basic operation": 4c40d43d + "Types": a9f6d073 "Other": 0bbfcc3c --- @@ -85,10 +85,9 @@ try { ### 追加設定 -設定タイプは [PrimeVue](https://primevue.org/) コンポーネントに基づいています。 -PrimeVue ドキュメントに記載されている Props は、`attrs` フィールドに追加することで ComfyUI 設定用に定義できます。 +各設定タイプは ComfyUI フロントエンドのフォームコンポーネントを表示します。`attrs` フィールドで、そのコンポーネントに追加の Props を渡せます。各タイプがサポートする Props は、以下の各タイプの説明に記載しています。 -例えば、これは数値入力に増減ボタンを追加します: +例えば、これは数値入力の範囲とステップを制限します: ```javascript { @@ -97,7 +96,9 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ type: "number", defaultValue: 0, attrs: { - showButtons: true, + min: 0, + max: 100, + step: 5, }, onChange: (newVal, oldVal) => { console.log(`設定が ${oldVal} から ${newVal} に変更されました`); @@ -106,14 +107,14 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ ``` +拡張機能で `showButtons`、`maxFractionDigits`、`editable`、`filter` などの PrimeVue の Props を渡していた場合は、[PrimeVue 削除に伴う移行](/custom-nodes/js/primevue-removal-migration) を参照してください。設定パネルは PrimeVue コンポーネントを使用しなくなったため、これらの Props は効果がありません。 + ## タイプ ### ブール値 (Boolean) これはオン/オフのトグルを表示します。 -[ToggleSwitch PrimeVue コンポーネント](https://primevue.org/toggleswitch/) に基づいています。 - ```javascript { id: "example.boolean", @@ -130,8 +131,6 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ これは自由形式のテキストです。 -[InputText PrimeVue コンポーネント](https://primevue.org/inputtext/) に基づいています。 - ```javascript { id: "example.text", @@ -148,9 +147,7 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ これは数値を入力するためのものです。 -小数点以下を許可するには、`maxFractionDigits` 属性を 0 より大きい数値に設定します。 - -[InputNumber PrimeVue コンポーネント](https://primevue.org/inputnumber/) に基づいています。 +入力には常に増減ボタンが表示されます。サポートされる `attrs` は `min`、`max`、`step`、`formatOptions` です。`formatOptions` は [`Intl.NumberFormatOptions`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options) を受け取るため、`maximumFractionDigits` で表示する小数点以下の桁数を制御できます。 ```javascript { @@ -159,8 +156,8 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ type: "number", defaultValue: 42, attrs: { - showButtons: true, - maxFractionDigits: 1, + step: 0.1, + formatOptions: { maximumFractionDigits: 1 }, }, onChange: (newVal, oldVal) => { console.log(`設定が ${oldVal} から ${newVal} に変更されました`); @@ -172,7 +169,7 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ これにより、ユーザーは直接数値を入力するか、スライダー経由で入力できます。 -[Slider PrimeVue コンポーネント](https://primevue.org/slider/) に基づいています。範囲はサポートされていません。 +サポートされる `attrs` は `min`、`max`、`step` です。範囲はサポートされていません。 ```javascript { @@ -197,9 +194,7 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ オプションは単純な文字列として、または `text` と `value` フィールドを持つオブジェクトとして提供できます。単純な文字列のみを提供する場合、それは両方に使用されます。 -`editable: true` 属性を指定してユーザーに自由形式のテキストを入力させたり、`filter: true` 属性を指定して検索可能にしたりできます。 - -[Select PrimeVue コンポーネント](https://primevue.org/select/) に基づいています。グループはサポートされていません。 +`searchable: true` 属性を指定すると、ユーザーがリストを検索できるようになります。グループと自由形式のテキスト入力はサポートされていません。 ```javascript { @@ -212,8 +207,7 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ "2 番目のオプション", ], attrs: { - editable: true, - filter: true, + searchable: true, }, onChange: (newVal, oldVal) => { console.log(`設定が ${oldVal} から ${newVal} に変更されました`); @@ -225,9 +219,7 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ これにより、ユーザーはカラーピッカーから色を選択するか、16 進数参照を入力できます。 -形式には 6 桁の完全な 16 進数が必要です。3 桁の省略形は機能しません。 - -[ColorPicker PrimeVue コンポーネント](https://primevue.org/colorpicker/) に基づいています。 +形式には 6 桁(アルファ付きの場合は 8 桁)の完全な 16 進数が必要です。3 桁の省略形は機能しません。 ```javascript { @@ -247,8 +239,6 @@ PrimeVue ドキュメントに記載されている Props は、`attrs` フィ 設定は [data URL](https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data) として保存されます。 -[FileUpload PrimeVue コンポーネント](https://primevue.org/fileupload/) に基づいています。 - ```javascript { id: "example.image", diff --git a/ja/custom-nodes/js/javascript_sidebar_tabs.mdx b/ja/custom-nodes/js/javascript_sidebar_tabs.mdx index 86fc106818..a1e5eeb745 100644 --- a/ja/custom-nodes/js/javascript_sidebar_tabs.mdx +++ b/ja/custom-nodes/js/javascript_sidebar_tabs.mdx @@ -1,16 +1,16 @@ --- title: "サイドバータブ" description: "ComfyUI Extension API でカスタム JavaScript サイドバータブを構築しましょう。React コンポーネントと動的コンテンツ更新のコード例を紹介します。" -translationSourceHash: bf389e93 +translationSourceHash: af1c491b translationFrom: custom-nodes/js/javascript_sidebar_tabs.mdx translationBlockHashes: "_intro": 3df6f709 - "Basic Usage": 8dc773cb + "Basic Usage": 2bebd35b "Tab Configuration": f4594df2 - "Icon Options": 32c3f0a8 - "Stateful Tab Example": 063a70c3 - "Using React Components": 68aa4ede - "Dynamic Content Updates": d90422de + "Icon Options": 9ccf6f62 + "Stateful Tab Example": 9a13d974 + "Using React Components": d846d348 + "Dynamic Content Updates": 51fb66f8 --- @@ -21,7 +21,7 @@ translationBlockHashes: ```javascript app.extensionManager.registerSidebarTab({ id: "customSidebar", - icon: "pi pi-compass", + icon: "icon-[lucide--compass]", title: "カスタムタブ", tooltip: "マイカスタムサイドバータブ", type: "custom", @@ -50,13 +50,11 @@ app.extensionManager.registerSidebarTab({ ## アイコンオプション -サイドバータブのアイコンには、さまざまなアイコンセットを使用できます: +サイドバータブのアイコンには、`icon-[lucide--]` 形式の [Lucide](https://lucide.dev/icons/) アイコンクラスを使用します(例:`icon-[lucide--compass]`)。 -- PrimeVue アイコン:`pi pi-[icon-name]`(例:`pi pi-home`) -- Material Design アイコン:`mdi mdi-[icon-name]`(例:`mdi mdi-robot`) -- Font Awesome アイコン:`fa-[style] fa-[icon-name]`(例:`fa-solid fa-star`) +これらのクラスはフロントエンドのビルド時に生成されるため、使用できるのはフロントエンド自体が使用している Lucide アイコンのみです。アイコンが表示されない場合は、別のアイコンを選ぶか、拡張機能が読み込むスタイルシートで独自のアイコンクラスを定義してください。 -これらのアイコンを使用する前に、対応するアイコンライブラリが読み込まれていることを確認してください。 +PrimeIcons(`pi pi-*`)と Material Design Icons(`mdi mdi-*`)のクラスは現時点ではまだ表示されますが、段階的に廃止されています。新しいコードでは使用しないでください。[PrimeVue 削除に伴う移行](/custom-nodes/js/primevue-removal-migration) を参照してください。 ## 状態を持つタブの例 @@ -65,7 +63,7 @@ app.extensionManager.registerSidebarTab({ ```javascript app.extensionManager.registerSidebarTab({ id: "statefulTab", - icon: "pi pi-list", + icon: "icon-[lucide--list]", title: "メモ", type: "custom", render: (el) => { @@ -108,7 +106,7 @@ import ReactDOM from "react-dom/client"; // React コンテンツを持つサイドバータブを登録 app.extensionManager.registerSidebarTab({ id: "reactSidebar", - icon: "mdi mdi-react", + icon: "icon-[lucide--blocks]", title: "React タブ", type: "custom", render: (el) => { @@ -150,7 +148,7 @@ app.extensionManager.registerSidebarTab({ ```javascript app.extensionManager.registerSidebarTab({ id: "dynamicSidebar", - icon: "pi pi-chart-line", + icon: "icon-[lucide--activity]", title: "統計", type: "custom", render: (el) => { diff --git a/ko/custom-nodes/js/javascript_about_panel_badges.mdx b/ko/custom-nodes/js/javascript_about_panel_badges.mdx index 57044ca0ca..bf175edbf6 100644 --- a/ko/custom-nodes/js/javascript_about_panel_badges.mdx +++ b/ko/custom-nodes/js/javascript_about_panel_badges.mdx @@ -1,7 +1,7 @@ --- title: "패널 배지에 대하여" description: "About Panel Badges API로 ComfyUI About 패널에 라벨, URL, 아이콘이 있는 커스텀 배지를 추가하고 문서, GitHub, 확장 리소스로 연결할 수 있습니다." -translationSourceHash: e9fe305d +translationSourceHash: 9e3d732a translationFrom: custom-nodes/js/javascript_about_panel_badges.mdx --- @@ -16,12 +16,12 @@ app.registerExtension({ { label: "문서", url: "https://example.com/docs", - icon: "pi pi-file" + icon: "icon-[lucide--file]" }, { label: "GitHub", url: "https://github.com/username/repo", - icon: "pi pi-github" + icon: "icon-[lucide--github]" } ] }); @@ -35,23 +35,24 @@ app.registerExtension({ { label: string, // 배지에 표시할 텍스트 url: string, // 배지를 클릭했을 때 열리는 URL - icon: string // 아이콘 클래스 (예: PrimeVue 아이콘) + icon: string // 아이콘 클래스 (예: "icon-[lucide--github]") } ``` ## 아이콘 옵션 -배지 아이콘은 PrimeVue의 아이콘 세트를 사용합니다. 다음은 자주 사용되는 아이콘들입니다: +배지 아이콘은 `icon-[lucide--]` 형식의 [Lucide](https://lucide.dev/icons/) 아이콘 클래스를 사용합니다. 다음은 자주 사용되는 아이콘들입니다: -- 문서: `pi pi-file` 또는 `pi pi-book` -- GitHub: `pi pi-github` -- 외부 링크: `pi pi-external-link` -- 정보: `pi pi-info-circle` -- 다운로드: `pi pi-download` -- 웹사이트: `pi pi-globe` -- 디스코드: `pi pi-discord` +- 문서: `icon-[lucide--file]` 또는 `icon-[lucide--book-open]` +- GitHub: `icon-[lucide--github]` +- 외부 링크: `icon-[lucide--external-link]` +- 정보: `icon-[lucide--info]` +- 다운로드: `icon-[lucide--download]` +- 웹사이트: `icon-[lucide--globe]` -사용 가능한 아이콘의 전체 목록은 [PrimeVue 아이콘 문서](https://primevue.org/icons/)를 참조하십시오. +이 클래스는 프론트엔드 빌드 시 생성되므로 프론트엔드 자체에서 사용하는 Lucide 아이콘만 사용할 수 있습니다. 아이콘이 표시되지 않으면 다른 아이콘을 선택하거나, 확장에서 로드하는 스타일시트에 직접 아이콘 클래스를 정의하세요. + +`pi pi-file` 같은 PrimeIcons 클래스는 당분간 계속 표시되지만 단계적으로 제거되고 있습니다. 새 코드에서는 사용하지 마세요. [PrimeVue 제거 마이그레이션](/custom-nodes/js/primevue-removal-migration)을 참조하세요. ## 예제 @@ -62,17 +63,17 @@ app.registerExtension({ { label: "웹사이트", url: "https://example.com", - icon: "pi pi-home" + icon: "icon-[lucide--globe]" }, { label: "기부하기", url: "https://example.com/donate", - icon: "pi pi-heart" + icon: "icon-[lucide--heart]" }, { label: "문서", url: "https://example.com/docs", - icon: "pi pi-book" + icon: "icon-[lucide--book-open]" } ] }); diff --git a/ko/custom-nodes/js/javascript_selection_toolbox.mdx b/ko/custom-nodes/js/javascript_selection_toolbox.mdx index e6b37a826f..1c766e9257 100644 --- a/ko/custom-nodes/js/javascript_selection_toolbox.mdx +++ b/ko/custom-nodes/js/javascript_selection_toolbox.mdx @@ -1,16 +1,16 @@ --- title: "선택 도구 상자" description: "getSelectionToolboxCommands를 사용해 선택된 노드, 그룹, 캔버스 항목에 대해 ComfyUI 선택 도구 상자에 커스텀 액션 명령을 추가합니다." -translationSourceHash: f66d3f91 +translationSourceHash: 333b273c translationFrom: custom-nodes/js/javascript_selection_toolbox.mdx translationBlockHashes: "_intro": 356ec52a - "Basic Usage": a850ba5d + "Basic Usage": 33dac51e "Command Definition": b0aab3a4 - "Icon Options": c511932a - "Dynamic Command Visibility": 49b6198d - "Working with Selected Items": 90ff1ddb - "Complete Example": dc8a50e4 + "Icon Options": 9122c5e1 + "Dynamic Command Visibility": a3bcf2c6 + "Working with Selected Items": 6c9c69b4 + "Complete Example": 90ad0a46 "Notes": 6f71c3bf --- @@ -31,7 +31,7 @@ app.registerExtension({ { id: "my-extension.duplicate-special", label: "특별 복제", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: (selectedItem) => { // 여기에 명령 로직을 작성하세요 console.log("특별한 동작으로 선택된 노드 복제 중"); @@ -62,10 +62,11 @@ app.registerExtension({ ## 아이콘 옵션 -선택 도구 상자 버튼은 다른 UI 요소와 동일한 아이콘 라이브러리를 지원합니다: +선택 도구 상자 버튼은 `icon-[lucide--]` 형식의 [Lucide](https://lucide.dev/icons/) 아이콘 클래스를 사용합니다 (예: `icon-[lucide--star]`). -- PrimeVue 아이콘: `pi pi-[아이콘 이름]` (예: `pi pi-star`) -- Material Design 아이콘: `mdi mdi-[아이콘 이름]` (예: `mdi mdi-content-copy`) +이 클래스는 프론트엔드 빌드 시 생성되므로 프론트엔드 자체에서 사용하는 Lucide 아이콘만 사용할 수 있습니다. 아이콘이 표시되지 않으면 다른 아이콘을 선택하거나, 확장에서 로드하는 스타일시트에 직접 아이콘 클래스를 정의하세요. + +PrimeIcons(`pi pi-*`)와 Material Design Icons(`mdi mdi-*`) 클래스는 당분간 계속 표시되지만 단계적으로 제거되고 있습니다. 새 코드에서는 사용하지 마세요. [PrimeVue 제거 마이그레이션](/custom-nodes/js/primevue-removal-migration)을 참조하세요. ## 동적 명령 표시 여부 @@ -78,7 +79,7 @@ app.registerExtension({ { id: "my-ext.align-nodes", label: "노드 정렬", - icon: "pi pi-align-left", + icon: "icon-[lucide--align-start-vertical]", function: () => { // 여러 노드 정렬하기 } @@ -86,7 +87,7 @@ app.registerExtension({ { id: "my-ext.configure-single", label: "구성", - icon: "pi pi-cog", + icon: "icon-[lucide--settings]", function: () => { // 단일 노드 구성하기 } @@ -120,7 +121,7 @@ app.registerExtension({ { id: "my-ext.show-info", label: "선택 정보 표시", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const selectedItems = app.canvas.selectedItems; @@ -152,7 +153,7 @@ app.registerExtension({ { id: "selection-tools.count", label: "선택 개수", - icon: "pi pi-hashtag", + icon: "icon-[lucide--tag]", function: () => { const count = app.canvas.selectedItems?.size || 0; app.extensionManager.toast.add({ @@ -166,7 +167,7 @@ app.registerExtension({ { id: "selection-tools.copy-ids", label: "ID 복사", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const ids = items.map(item => item.id).filter(id => id !== undefined); @@ -185,7 +186,7 @@ app.registerExtension({ { id: "selection-tools.log-types", label: "타입 로그", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const typeCount = {}; diff --git a/ko/custom-nodes/js/javascript_settings.mdx b/ko/custom-nodes/js/javascript_settings.mdx index 8135a8d7da..c1c1430763 100644 --- a/ko/custom-nodes/js/javascript_settings.mdx +++ b/ko/custom-nodes/js/javascript_settings.mdx @@ -1,12 +1,12 @@ --- title: "설정 API" description: "app.registerExtension으로 ComfyUI 확장 설정을 추가, 읽기, 쓰기하고 변경에 반응하는 방법. boolean, text, number, slider, combo, color, image 등 설정 타입을 다룹니다." -translationSourceHash: 30dee1fd +translationSourceHash: d1a5f9a1 translationFrom: custom-nodes/js/javascript_settings.mdx translationBlockHashes: "_intro": ac25633e - "Basic operation": 2cef8fa5 - "Types": 00f1c38c + "Basic operation": 4c40d43d + "Types": a9f6d073 "Other": 0bbfcc3c --- @@ -84,10 +84,9 @@ try { ### 추가 구성 -설정 유형은 [PrimeVue](https://primevue.org/) 컴포넌트를 기반으로 합니다. -PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI 설정에도 적용할 수 있습니다. +각 설정 유형은 ComfyUI 프론트엔드의 폼 컴포넌트를 렌더링합니다. `attrs` 필드로 해당 컴포넌트에 추가 속성을 전달할 수 있습니다. 유형별로 지원되는 속성은 아래 각 유형 설명에 나와 있습니다. -예를 들어, 숫자 입력에 증감 버튼을 추가하려면 다음과 같이 작성합니다: +예를 들어, 숫자 입력의 범위와 단계를 제한하려면 다음과 같이 작성합니다: ```javascript { @@ -96,7 +95,9 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI type: "number", defaultValue: 0, attrs: { - showButtons: true, + min: 0, + max: 100, + step: 5, }, onChange: (newVal, oldVal) => { console.log(`설정이 ${oldVal}에서 ${newVal}로 변경되었습니다.`); @@ -105,14 +106,14 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI ``` +확장에서 `showButtons`, `maxFractionDigits`, `editable`, `filter` 같은 PrimeVue 속성을 전달했다면 [PrimeVue 제거 마이그레이션](/custom-nodes/js/primevue-removal-migration)을 참조하세요. 설정 패널은 더 이상 PrimeVue 컴포넌트를 사용하지 않으므로 해당 속성은 효과가 없습니다. + ## 유형 ### 부울 이것은 켜기/끄기 토글을 표시합니다. -[ToggleSwitch PrimeVue 컴포넌트](https://primevue.org/toggleswitch/)를 기반으로 합니다. - ```javascript { id: "example.boolean", @@ -129,8 +130,6 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI 이것은 자유 형식 텍스트입니다. -[InputText PrimeVue 컴포넌트](https://primevue.org/inputtext/)를 기반으로 합니다. - ```javascript { id: "example.text", @@ -147,9 +146,7 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI 숫자를 입력하는 데 사용됩니다. -소수점 자리를 허용하려면 `maxFractionDigits` 속성을 0보다 큰 숫자로 설정하세요. - -[InputNumber PrimeVue 컴포넌트](https://primevue.org/inputnumber/)를 기반으로 합니다. +입력에는 항상 증가 및 감소 버튼이 표시됩니다. 지원되는 `attrs`는 `min`, `max`, `step`, `formatOptions`입니다. `formatOptions`는 [`Intl.NumberFormatOptions`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options)를 받으므로 `maximumFractionDigits`로 표시할 소수 자릿수를 제어할 수 있습니다. ```javascript { @@ -158,8 +155,8 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI type: "number", defaultValue: 42, attrs: { - showButtons: true, - maxFractionDigits: 1, + step: 0.1, + formatOptions: { maximumFractionDigits: 1 }, }, onChange: (newVal, oldVal) => { console.log(`설정이 ${oldVal}에서 ${newVal}로 변경되었습니다.`); @@ -171,7 +168,7 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI 사용자가 직접 숫자를 입력하거나 슬라이더를 통해 입력할 수 있도록 합니다. -[Slider PrimeVue 컴포넌트](https://primevue.org/slider/)를 기반으로 합니다. 범위는 지원되지 않습니다. +지원되는 `attrs`는 `min`, `max`, `step`입니다. 범위는 지원되지 않습니다. ```javascript { @@ -196,9 +193,7 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI 옵션을 일반 문자열 또는 `text`와 `value` 필드가 있는 객체로 제공할 수 있습니다. 일반 문자열만 제공하면 두 값 모두에 사용됩니다. -`editable: true` 속성을 제공해 사용자가 자유 형식 텍스트를 입력하게 하거나, `filter: true` 속성을 제공해 검색할 수 있게 할 수 있습니다. - -[Select PrimeVue 컴포넌트](https://primevue.org/select/)를 기반으로 합니다. 그룹은 지원되지 않습니다. +`searchable: true` 속성을 제공하면 사용자가 목록을 검색할 수 있습니다. 그룹과 자유 형식 텍스트 입력은 지원되지 않습니다. ```javascript { @@ -211,8 +206,7 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI "내 두 번째 옵션", ], attrs: { - editable: true, - filter: true, + searchable: true, }, onChange: (newVal, oldVal) => { console.log(`설정이 ${oldVal}에서 ${newVal}로 변경되었습니다.`); @@ -224,9 +218,7 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI 사용자가 색상 피커에서 색상을 선택하거나 16진수 참조를 입력할 수 있도록 합니다. -포맷은 6자리 16진수를 요구하며, 3자리 축약형은 작동하지 않습니다. - -[ColorPicker PrimeVue 컴포넌트](https://primevue.org/colorpicker/)를 기반으로 합니다. +포맷은 6자리 16진수(알파 포함 시 8자리)를 요구하며, 3자리 축약형은 작동하지 않습니다. ```javascript { @@ -246,8 +238,6 @@ PrimeVue 문서에 설명된 속성을 `attrs` 필드에 추가하면 ComfyUI 설정은 [데이터 URL](https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data)로 저장됩니다. -[FileUpload PrimeVue 컴포넌트](https://primevue.org/fileupload/)를 기반으로 합니다. - ```javascript { id: "example.image", diff --git a/ko/custom-nodes/js/javascript_sidebar_tabs.mdx b/ko/custom-nodes/js/javascript_sidebar_tabs.mdx index 373e0566ec..898f028a4c 100644 --- a/ko/custom-nodes/js/javascript_sidebar_tabs.mdx +++ b/ko/custom-nodes/js/javascript_sidebar_tabs.mdx @@ -1,16 +1,16 @@ --- title: "사이드바 탭" description: "ComfyUI Extension API로 커스텀 JavaScript 사이드바 탭을 만드세요. React 컴포넌트와 동적 콘텐츠 업데이트 코드 예제를 확인하세요." -translationSourceHash: bf389e93 +translationSourceHash: af1c491b translationFrom: custom-nodes/js/javascript_sidebar_tabs.mdx translationBlockHashes: "_intro": 3df6f709 - "Basic Usage": 8dc773cb + "Basic Usage": 2bebd35b "Tab Configuration": f4594df2 - "Icon Options": 32c3f0a8 - "Stateful Tab Example": 063a70c3 - "Using React Components": 68aa4ede - "Dynamic Content Updates": d90422de + "Icon Options": 9ccf6f62 + "Stateful Tab Example": 9a13d974 + "Using React Components": d846d348 + "Dynamic Content Updates": 51fb66f8 --- 사이드바 탭 API를 사용하면 확장 프로그램에서 ComfyUI 인터페이스의 사이드바에 맞춤형 탭을 추가할 수 있습니다. 이는 지속적인 가시성과 빠른 접근이 필요한 기능을 추가하는 데 유용합니다. @@ -20,7 +20,7 @@ translationBlockHashes: ```javascript app.extensionManager.registerSidebarTab({ id: "customSidebar", - icon: "pi pi-compass", + icon: "icon-[lucide--compass]", title: "맞춤형 탭", tooltip: "내 맞춤형 사이드바 탭", type: "custom", @@ -49,13 +49,11 @@ app.extensionManager.registerSidebarTab({ ## 아이콘 옵션 -사이드바 탭 아이콘은 다양한 아이콘 세트를 사용할 수 있습니다: +사이드바 탭 아이콘은 `icon-[lucide--]` 형식의 [Lucide](https://lucide.dev/icons/) 아이콘 클래스를 사용합니다 (예: `icon-[lucide--compass]`). -- PrimeVue 아이콘: `pi pi-[아이콘 이름]` (예: `pi pi-home`) -- Material Design 아이콘: `mdi mdi-[아이콘 이름]` (예: `mdi mdi-robot`) -- Font Awesome 아이콘: `fa-[스타일] fa-[아이콘 이름]` (예: `fa-solid fa-star`) +이 클래스는 프론트엔드 빌드 시 생성되므로 프론트엔드 자체에서 사용하는 Lucide 아이콘만 사용할 수 있습니다. 아이콘이 표시되지 않으면 다른 아이콘을 선택하거나, 확장에서 로드하는 스타일시트에 직접 아이콘 클래스를 정의하세요. -해당 아이콘 라이브러리를 사용하기 전에 반드시 로드되어야 합니다. +PrimeIcons(`pi pi-*`)와 Material Design Icons(`mdi mdi-*`) 클래스는 당분간 계속 표시되지만 단계적으로 제거되고 있습니다. 새 코드에서는 사용하지 마세요. [PrimeVue 제거 마이그레이션](/custom-nodes/js/primevue-removal-migration)을 참조하세요. ## 상태 유지 탭 예제 @@ -64,7 +62,7 @@ app.extensionManager.registerSidebarTab({ ```javascript app.extensionManager.registerSidebarTab({ id: "statefulTab", - icon: "pi pi-list", + icon: "icon-[lucide--list]", title: "메모", type: "custom", render: (el) => { @@ -107,7 +105,7 @@ import ReactDOM from "react-dom/client"; // React 콘텐츠로 사이드바 탭 등록 app.extensionManager.registerSidebarTab({ id: "reactSidebar", - icon: "mdi mdi-react", + icon: "icon-[lucide--blocks]", title: "React 탭", type: "custom", render: (el) => { @@ -149,7 +147,7 @@ app.extensionManager.registerSidebarTab({ ```javascript app.extensionManager.registerSidebarTab({ id: "dynamicSidebar", - icon: "pi pi-chart-line", + icon: "icon-[lucide--activity]", title: "통계", type: "custom", render: (el) => { diff --git a/zh/custom-nodes/js/javascript_about_panel_badges.mdx b/zh/custom-nodes/js/javascript_about_panel_badges.mdx index 8553704f58..41f733703a 100644 --- a/zh/custom-nodes/js/javascript_about_panel_badges.mdx +++ b/zh/custom-nodes/js/javascript_about_panel_badges.mdx @@ -1,7 +1,7 @@ --- title: "关于面板徽章" description: "使用 About Panel Badges API 为 ComfyUI 关于面板添加带标签、URL 和图标的自定义徽章,并链接到文档、GitHub 或扩展资源。" -translationSourceHash: e9fe305d +translationSourceHash: 9e3d732a translationFrom: custom-nodes/js/javascript_about_panel_badges.mdx --- @@ -16,12 +16,12 @@ app.registerExtension({ { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-file" + icon: "icon-[lucide--file]" }, { label: "GitHub", url: "https://github.com/username/repo", - icon: "pi pi-github" + icon: "icon-[lucide--github]" } ] }); @@ -35,23 +35,24 @@ app.registerExtension({ { label: string, // 徽章上显示的文本 url: string, // 点击徽章时打开的 URL - icon: string // 图标类名(例如 PrimeVue 图标) + icon: string // 图标类名(例如 "icon-[lucide--github]") } ``` ## 图标选项 -徽章图标使用 PrimeVue 的图标集。以下是一些常用图标: +徽章图标使用 `icon-[lucide--]` 格式的 [Lucide](https://lucide.dev/icons/) 图标类名。以下是一些常用图标: -- 文档:`pi pi-file` 或 `pi pi-book` -- GitHub:`pi pi-github` -- 外部链接:`pi pi-external-link` -- 信息:`pi pi-info-circle` -- 下载:`pi pi-download` -- 网站:`pi pi-globe` -- Discord:`pi pi-discord` +- 文档:`icon-[lucide--file]` 或 `icon-[lucide--book-open]` +- GitHub:`icon-[lucide--github]` +- 外部链接:`icon-[lucide--external-link]` +- 信息:`icon-[lucide--info]` +- 下载:`icon-[lucide--download]` +- 网站:`icon-[lucide--globe]` -完整的可用图标列表请参考 [PrimeVue 图标文档](https://primevue.org/icons/)。 +这些类名在前端构建时生成,因此只能使用前端自身用到的 Lucide 图标。如果图标无法显示,请换一个图标,或在扩展加载的样式表中定义自己的图标类名。 + +`pi pi-file` 等 PrimeIcons 类名目前仍可显示,但正在逐步淘汰,请勿在新代码中使用。请参阅 [PrimeVue 移除迁移指南](/custom-nodes/js/primevue-removal-migration)。 ## 示例 @@ -62,17 +63,17 @@ app.registerExtension({ { label: "Website", url: "https://example.com", - icon: "pi pi-home" + icon: "icon-[lucide--globe]" }, { label: "Donate", url: "https://example.com/donate", - icon: "pi pi-heart" + icon: "icon-[lucide--heart]" }, { label: "Documentation", url: "https://example.com/docs", - icon: "pi pi-book" + icon: "icon-[lucide--book-open]" } ] }); diff --git a/zh/custom-nodes/js/javascript_selection_toolbox.mdx b/zh/custom-nodes/js/javascript_selection_toolbox.mdx index a48723bbdc..4dcc447814 100644 --- a/zh/custom-nodes/js/javascript_selection_toolbox.mdx +++ b/zh/custom-nodes/js/javascript_selection_toolbox.mdx @@ -1,16 +1,16 @@ --- title: "选择工具箱" description: "使用 getSelectionToolboxCommands,为选中的节点、组和画布项在 ComfyUI 选择工具箱中添加自定义操作命令。" -translationSourceHash: f66d3f91 +translationSourceHash: 333b273c translationFrom: custom-nodes/js/javascript_selection_toolbox.mdx translationBlockHashes: "_intro": 356ec52a - "Basic Usage": a850ba5d + "Basic Usage": 33dac51e "Command Definition": b0aab3a4 - "Icon Options": c511932a - "Dynamic Command Visibility": 49b6198d - "Working with Selected Items": 90ff1ddb - "Complete Example": dc8a50e4 + "Icon Options": 9122c5e1 + "Dynamic Command Visibility": a3bcf2c6 + "Working with Selected Items": 6c9c69b4 + "Complete Example": 90ad0a46 "Notes": 6f71c3bf --- @@ -31,7 +31,7 @@ app.registerExtension({ { id: "my-extension.duplicate-special", label: "特殊复制", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: (selectedItem) => { // 您的命令逻辑 console.log("使用特殊行为复制选定的节点"); @@ -62,10 +62,11 @@ app.registerExtension({ ## 图标选项 -选择工具箱按钮支持与其他 UI 元素相同的图标库: +选择工具箱按钮使用 `icon-[lucide--]` 格式的 [Lucide](https://lucide.dev/icons/) 图标类名(例如 `icon-[lucide--star]`)。 -- PrimeVue 图标:`pi pi-[icon-name]`(例如 `pi pi-star`) -- Material Design 图标:`mdi mdi-[icon-name]`(例如 `mdi mdi-content-copy`) +这些类名在前端构建时生成,因此只能使用前端自身用到的 Lucide 图标。如果图标无法显示,请换一个图标,或在扩展加载的样式表中定义自己的图标类名。 + +PrimeIcons(`pi pi-*`)和 Material Design Icons(`mdi mdi-*`)类名目前仍可显示,但正在逐步淘汰,请勿在新代码中使用。请参阅 [PrimeVue 移除迁移指南](/custom-nodes/js/primevue-removal-migration)。 ## 动态命令可见性 @@ -78,7 +79,7 @@ app.registerExtension({ { id: "my-ext.align-nodes", label: "对齐节点", - icon: "pi pi-align-left", + icon: "icon-[lucide--align-start-vertical]", function: () => { // 对齐多个节点 } @@ -86,7 +87,7 @@ app.registerExtension({ { id: "my-ext.configure-single", label: "配置", - icon: "pi pi-cog", + icon: "icon-[lucide--settings]", function: () => { // 配置单个节点 } @@ -120,7 +121,7 @@ app.registerExtension({ { id: "my-ext.show-info", label: "显示选择信息", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const selectedItems = app.canvas.selectedItems; @@ -152,7 +153,7 @@ app.registerExtension({ { id: "selection-tools.count", label: "计数选择", - icon: "pi pi-hashtag", + icon: "icon-[lucide--tag]", function: () => { const count = app.canvas.selectedItems?.size || 0; app.extensionManager.toast.add({ @@ -166,7 +167,7 @@ app.registerExtension({ { id: "selection-tools.copy-ids", label: "复制 ID", - icon: "pi pi-copy", + icon: "icon-[lucide--copy]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const ids = items.map(item => item.id).filter(id => id !== undefined); @@ -185,7 +186,7 @@ app.registerExtension({ { id: "selection-tools.log-types", label: "记录类型", - icon: "pi pi-info-circle", + icon: "icon-[lucide--info]", function: () => { const items = Array.from(app.canvas.selectedItems || []); const typeCount = {}; diff --git a/zh/custom-nodes/js/javascript_settings.mdx b/zh/custom-nodes/js/javascript_settings.mdx index e61aa70401..eee661a696 100644 --- a/zh/custom-nodes/js/javascript_settings.mdx +++ b/zh/custom-nodes/js/javascript_settings.mdx @@ -1,12 +1,12 @@ --- title: "设置 API" description: "使用 app.registerExtension 添加、读取、写入 ComfyUI 扩展设置并响应变更,涵盖 boolean、text、number、slider、combo、color 和 image 等设置类型。" -translationSourceHash: 30dee1fd +translationSourceHash: d1a5f9a1 translationFrom: custom-nodes/js/javascript_settings.mdx translationBlockHashes: "_intro": ac25633e - "Basic operation": 2cef8fa5 - "Types": 00f1c38c + "Basic operation": 4c40d43d + "Types": a9f6d073 "Other": 0bbfcc3c --- @@ -84,10 +84,9 @@ try { ### 额外配置 -设置类型基于 [PrimeVue](https://primevue.org/) 组件。 -在 `attrs` 字段中添加 PrimeVue 文档中描述的属性即可为 ComfyUI 设置项配置更多参数。 +每种设置类型都会渲染一个 ComfyUI 前端表单组件。可以在 `attrs` 字段中为该组件传入额外属性。各类型支持的属性见下文对应类型的说明。 -例如,下面为数字输入框添加了增减按钮: +例如,下面限制了数字输入框的范围和步长: ```javascript { @@ -96,7 +95,9 @@ try { type: "number", defaultValue: 0, attrs: { - showButtons: true, + min: 0, + max: 100, + step: 5, }, onChange: (newVal, oldVal) => { console.log(`设置从 ${oldVal} 变为 ${newVal}`); @@ -105,14 +106,14 @@ try { ``` +如果你的扩展传入了 `showButtons`、`maxFractionDigits`、`editable` 或 `filter` 等 PrimeVue 属性,请参阅 [PrimeVue 移除迁移指南](/custom-nodes/js/primevue-removal-migration)。设置面板已不再使用 PrimeVue 组件,这些属性不会生效。 + ## 类型 ### 布尔值(Boolean) 显示一个开关。 -基于 [ToggleSwitch PrimeVue 组件](https://primevue.org/toggleswitch/)。 - ```javascript { id: "example.boolean", @@ -129,8 +130,6 @@ try { 自由文本输入。 -基于 [InputText PrimeVue 组件](https://primevue.org/inputtext/)。 - ```javascript { id: "example.text", @@ -147,9 +146,7 @@ try { 用于输入数字。 -如需允许小数位,请将 `maxFractionDigits` 属性设置为大于 0 的数字。 - -基于 [InputNumber PrimeVue 组件](https://primevue.org/inputnumber/)。 +输入框始终显示增减按钮。支持的 `attrs` 有 `min`、`max`、`step` 和 `formatOptions`。`formatOptions` 接受 [`Intl.NumberFormatOptions`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options),因此可以用 `maximumFractionDigits` 控制显示的小数位数。 ```javascript { @@ -158,8 +155,8 @@ try { type: "number", defaultValue: 42, attrs: { - showButtons: true, - maxFractionDigits: 1, + step: 0.1, + formatOptions: { maximumFractionDigits: 1 }, }, onChange: (newVal, oldVal) => { console.log(`设置从 ${oldVal} 变为 ${newVal}`); @@ -171,7 +168,7 @@ try { 允许用户直接输入数字或通过滑块选择。 -基于 [Slider PrimeVue 组件](https://primevue.org/slider/)。不支持区间。 +支持的 `attrs` 有 `min`、`max` 和 `step`。不支持区间。 ```javascript { @@ -196,9 +193,7 @@ try { 你可以用纯字符串或带 `text` 和 `value` 字段的对象提供选项。如果只提供字符串,则会同时作为显示和实际值。 -通过 `editable: true` 属性允许用户输入自定义内容,通过 `filter: true` 属性允许搜索。 - -基于 [Select PrimeVue 组件](https://primevue.org/select/)。不支持分组。 +通过 `searchable: true` 属性允许用户搜索列表。不支持分组和自定义文本输入。 ```javascript { @@ -211,8 +206,7 @@ try { "我的第二个选项", ], attrs: { - editable: true, - filter: true, + searchable: true, }, onChange: (newVal, oldVal) => { console.log(`设置从 ${oldVal} 变为 ${newVal}`); @@ -224,9 +218,7 @@ try { 允许用户通过颜色选择器选择颜色或输入十六进制颜色值。 -注意格式必须为六位十六进制,不支持三位简写。 - -基于 [ColorPicker PrimeVue 组件](https://primevue.org/colorpicker/)。 +注意格式必须为六位十六进制(带透明度时为八位),不支持三位简写。 ```javascript { @@ -246,8 +238,6 @@ try { 设置会以 [data URL](https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data) 格式保存。 -基于 [FileUpload PrimeVue 组件](https://primevue.org/fileupload/)。 - ```javascript { id: "example.image", diff --git a/zh/custom-nodes/js/javascript_sidebar_tabs.mdx b/zh/custom-nodes/js/javascript_sidebar_tabs.mdx index 2f510cf3cc..c36d6f85f7 100644 --- a/zh/custom-nodes/js/javascript_sidebar_tabs.mdx +++ b/zh/custom-nodes/js/javascript_sidebar_tabs.mdx @@ -1,16 +1,16 @@ --- title: "侧边栏标签页" description: "掌握 ComfyUI Extension API,构建自定义 JavaScript 侧边栏标签页。查看 React 组件和动态内容更新的代码示例。" -translationSourceHash: bf389e93 +translationSourceHash: af1c491b translationFrom: custom-nodes/js/javascript_sidebar_tabs.mdx translationBlockHashes: "_intro": 3df6f709 - "Basic Usage": 8dc773cb + "Basic Usage": 2bebd35b "Tab Configuration": f4594df2 - "Icon Options": 32c3f0a8 - "Stateful Tab Example": 063a70c3 - "Using React Components": 68aa4ede - "Dynamic Content Updates": d90422de + "Icon Options": 9ccf6f62 + "Stateful Tab Example": 9a13d974 + "Using React Components": d846d348 + "Dynamic Content Updates": 51fb66f8 --- 侧边栏标签页 API 允许扩展为 ComfyUI 界面的侧边栏添加自定义标签页。这对于添加需要持续可见性和快速访问的功能非常有用。 @@ -20,7 +20,7 @@ translationBlockHashes: ```javascript app.extensionManager.registerSidebarTab({ id: "customSidebar", - icon: "pi pi-compass", + icon: "icon-[lucide--compass]", title: "自定义标签页", tooltip: "我的自定义侧边栏标签页", type: "custom", @@ -49,13 +49,11 @@ app.extensionManager.registerSidebarTab({ ## 图标选项 -侧边栏标签页图标可使用多种图标集: +侧边栏标签页图标使用 `icon-[lucide--]` 格式的 [Lucide](https://lucide.dev/icons/) 图标类名(如 `icon-[lucide--compass]`)。 -- PrimeVue 图标:`pi pi-[icon-name]`(如 `pi pi-home`) -- Material Design 图标:`mdi mdi-[icon-name]`(如 `mdi mdi-robot`) -- Font Awesome 图标:`fa-[style] fa-[icon-name]`(如 `fa-solid fa-star`) +这些类名在前端构建时生成,因此只能使用前端自身用到的 Lucide 图标。如果图标无法显示,请换一个图标,或在扩展加载的样式表中定义自己的图标类名。 -使用这些图标前请确保已加载相应的图标库。 +PrimeIcons(`pi pi-*`)和 Material Design Icons(`mdi mdi-*`)类名目前仍可显示,但正在逐步淘汰,请勿在新代码中使用。请参阅 [PrimeVue 移除迁移指南](/custom-nodes/js/primevue-removal-migration)。 ## 有状态标签页示例 @@ -64,7 +62,7 @@ app.extensionManager.registerSidebarTab({ ```javascript app.extensionManager.registerSidebarTab({ id: "statefulTab", - icon: "pi pi-list", + icon: "icon-[lucide--list]", title: "笔记", type: "custom", render: (el) => { @@ -107,7 +105,7 @@ import ReactDOM from "react-dom/client"; // 注册带有 React 内容的侧边栏标签页 app.extensionManager.registerSidebarTab({ id: "reactSidebar", - icon: "mdi mdi-react", + icon: "icon-[lucide--blocks]", title: "React 标签页", type: "custom", render: (el) => { @@ -149,7 +147,7 @@ app.extensionManager.registerSidebarTab({ ```javascript app.extensionManager.registerSidebarTab({ id: "dynamicSidebar", - icon: "pi pi-chart-line", + icon: "icon-[lucide--activity]", title: "统计信息", type: "custom", render: (el) => {