HSplit
HSplit(가로 분할) 위젯은 하나의 영역을 여러 개로 나누고, 각 분할 영역의 크기 비율을 지정하거나 분할선을 드래그해 조절할 수 있는 배치 위젯입니다.
정보
이 위젯은 Free 플랜에서 잠겨 있으며, Pro·Enterprise 플랜에서 사용할 수 있습니다.
정의 / 역할
HSplit 위젯은 내부를 여러 개의 분할 영역(SplitItem)으로 나눕니다. 각 영역 사이에는 분할선(divider)이 그려지며, 영역 개수와 크기 비율, 분할선의 두께·색·여백·모서리 둥글기를 설정할 수 있습니다.
- 카테고리: Layouts
- 기본 분할 개수:
2 - 기본 분할선: 표시(흰색, 두께
10px)
기능
| 기능 | 설명 |
|---|---|
| 영역 분할 | itemCount 값만큼 분할 영역(SplitItem)으로 나눕니다. (2~99개) |
| 크기 비율 조절 | 각 분할 영역의 flex 값(splitItemNFlex)으로 크기 비율을 지정합니다. |
| 분할선 드래그 | 분할선 고정을 해제하면(isFixedDivider 끄기) 분할선을 드래그해 인접한 두 영역의 크기를 조절할 수 있습니다. |
| 분할선 꾸미기 | 분할선의 표시 여부·두께·색·여백·모서리 둥글기를 설정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Layouts 카테고리를 엽니다.
- HSplit 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서
itemCount로 분할 영역 개수를 지정합니다. - 각
splitItemNFlex값으로 영역별 크기 비율을 조절합니다. - 필요하면 분할선 표시·고정 여부(
isShowDivider,isFixedDivider)와 두께·색 등을 설정합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
itemCount | 분할 영역(SplitItem) 개수 | 2 | 정수 (2~99) |
isShowDivider | 분할선 표시 여부 | true (표시) | 참 / 거짓 |
isFixedDivider | 분할선 고정 여부. 고정하면 드래그로 크기 조절 불가 | true (고정) | 참 / 거짓 |
dividerThickness | 분할선 두께 | 10 | 숫자(px) |
dividerIndent | 분할선 시작 여백 | 0 | 숫자(px) |
dividerEndIndent | 분할선 끝 여백 | 0 | 숫자(px) |
dividerColor | 분할선 색 | #FFFFFF (흰색) | 색상 |
dividerBorderRadius | 분할선 모서리 둥글기 | 0 | 숫자(px) |
splitItem1Flex | 첫 번째 분할 영역의 크기 비율(가중치) | 1 | 정수 (1~1000) |
splitItem2Flex | 두 번째 분할 영역의 크기 비율(가중치). itemCount를 늘리면 splitItem3Flex … 가 그 수만큼 자동 생성됩니다 | 1 | 정수 (1~1000) |
주의 / 팁
경고
분할선을 드래그해 크기를 조절하려면 isFixedDivider를 꺼야(false) 합니다. 기본값은 고정(true)이라 이 상태에서는 분할선을 드래그해도 크기가 바뀌지 않습니다.
팁
각 영역의 크기는 splitItemNFlex 값의 비율로 정해집니다. 예를 들어 두 영역의 flex가 1과 2이면 크기 비율이 1:2가 됩니다. itemCount를 늘리면 그 수만큼 flex 속성이 자동으로 추가됩니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 HSplit (가로 분할) Widget Control 문서에서 확인하세요.