기본 작동
설정 추가하기
id는 모든 확장 프로그램에서 고유해야 하며, 값을 가져오는 데 사용됩니다.
카테고리를 제공하지 않으면 id가 .로 분리되어 설정 패널의 위치를 결정합니다.
id에.이 없으면 “기타” 카테고리에 나타나며,id가 섹션 제목으로 사용됩니다.id에 적어도 하나의.이 있으면 가장 왼쪽 부분이 설정 카테고리로 사용되고, 두 번째 부분이 섹션 제목으로 사용됩니다. 그 이상의 부분은 무시됩니다.
설정 읽기
변경 사항 반응하기
onChange() 이벤트 핸들러는 사용자가 설정 패널에서 설정을 변경하자마자 호출됩니다.
확장 프로그램이 등록될 때와 페이지가 로드될 때마다 이 이벤트 핸들러가 호출됩니다.
설정 쓰기
추가 구성
각 설정 유형은 ComfyUI 프론트엔드의 폼 컴포넌트를 렌더링합니다.attrs 필드로 해당 컴포넌트에 추가 속성을 전달할 수 있습니다. 각 유형이 지원하는 속성은 유형에 나와 있습니다.
예를 들어, 숫자 입력의 범위와 단계를 제한하려면 다음과 같이 작성합니다:
showButtons, maxFractionDigits, editable, filter 같은 PrimeVue 속성을 전달했다면 PrimeVue 제거 마이그레이션을 참조하세요. 설정 패널은 더 이상 PrimeVue 컴포넌트를 사용하지 않으므로 해당 속성은 효과가 없습니다.
유형
부울
이것은 켜기/끄기 토글을 표시합니다.텍스트
이것은 자유 형식 텍스트입니다.숫자
숫자를 입력하는 데 사용됩니다. 입력에는 항상 증가 및 감소 버튼이 표시됩니다. 지원되는attrs는 min, max, step, formatOptions입니다. formatOptions는 Intl.NumberFormatOptions를 받으므로 maximumFractionDigits로 표시할 소수 자릿수를 제어할 수 있습니다.
슬라이더
사용자가 직접 숫자를 입력하거나 슬라이더를 통해 입력할 수 있도록 합니다. 지원되는attrs는 min, max, step입니다. 범위는 지원되지 않습니다.
콤보
사용자가 드롭다운 목록에서 값을 선택하도록 합니다. 옵션을 일반 문자열 또는text와 value 필드가 있는 객체로 제공할 수 있습니다. 일반 문자열만 제공하면 두 값 모두에 사용됩니다.
searchable: true 속성을 제공하면 사용자가 목록을 검색할 수 있습니다. 그룹과 자유 형식 텍스트 입력은 지원되지 않습니다.
색상
사용자가 색상 피커에서 색상을 선택하거나 16진수 참조를 입력할 수 있도록 합니다. 포맷은 6자리 16진수(알파 포함 시 8자리)를 요구하며, 3자리 축약형은 작동하지 않습니다.이미지
사용자가 이미지를 업로드할 수 있도록 합니다. 설정은 데이터 URL로 저장됩니다.숨겨진
숨겨진 설정은 설정 패널에 표시되지 않지만, 코드에서 읽고 쓸 수 있습니다.기타
카테고리
설정의 카테고리화를id와 별도로 지정할 수 있습니다. 이는 카테고리화와 이름을 변경하면서도 id를 바꾸지 않고 사용자가 이미 설정한 값을 잃지 않도록 합니다.
도구 설명
tooltip 필드를 통해 추가적인 상황별 도움말을 추가할 수 있습니다. 이는 필드 이름 뒤에 작은 ℹ︎ 아이콘을 추가하고, 사용자가 마우스를 갖다 대면 도움말 텍스트를 표시합니다.