mirror of https://github.com/willmiao/ComfyUI-Lora-Manager.git synced 2026-03-21 13:12:12 -03:00

Files

Will Miao 822ac046e0 docs: update DOM widget value persistence best practices guide

- Restructure document to clearly separate simple vs complex widget patterns
- Add detailed explanation of ComfyUI's built-in callback mechanism
- Provide complete implementation examples for both patterns
- Remove outdated sync chain diagrams and replace with practical guidance
- Emphasize using DOM element as source of truth for simple widgets
- Document proper use of internal state with widget.callback for complex widgets

2026-01-27 22:51:09 +08:00

README.md

fix(autocomplete): fix value persistence in DOM text widgets

2026-01-26 23:24:16 +08:00

value-persistence-best-practices.md

docs: update DOM widget value persistence best practices guide

2026-01-27 22:51:09 +08:00

README.md

DOM Widgets Documentation

Documentation for custom DOM widget development in ComfyUI LoRA Manager.

Files

Value Persistence Best Practices - Essential guide for implementing text input DOM widgets that persist values correctly

Key Lessons

Common Anti-Patterns

❌ Don't: Create internal state variables
❌ Don't: Use v-model for text inputs
❌ Don't: Add serializeValue, onSetValue callbacks
❌ Don't: Watch props.widget.value

Best Practices

✅ Do: Use DOM element as single source of truth
✅ Do: Store DOM reference on widget.inputEl
✅ Do: Direct getValue/setValue to DOM
✅ Do: Clean up reference on unmount

DOM Widget Development Guide - Comprehensive guide for building DOM widgets
ComfyUI Built-in Example - Reference implementation

README.md

DOM Widgets Documentation

Files

Key Lessons

Common Anti-Patterns

Best Practices

Related Documentation