ToolbarGrid
Collapsible 헤더(제목 + 도구 모음) 와 데이터 그리드(페이지네이션 포함)를 결합한 복합 컴포넌트
기본 사용
Preview
ID | 상품명 | 카테고리 | 가격 |
|---|---|---|---|
1 | 노트북 | 전자기기 | 1500000 |
2 | 마우스 | 주변기기 | 35000 |
3 | 키보드 | 주변기기 | 89000 |
4 | 모니터 | 전자기기 | 450000 |
5 | 헤드셋 | 주변기기 | 120000 |
검색 폼 포함
searchContent prop으로 헤더와 그리드 사이에 검색 입력 격자를 추가합니다.
Preview
ID | 상품명 | 카테고리 | 가격 |
|---|---|---|---|
1 | 노트북 | 전자기기 | 1500000 |
2 | 마우스 | 주변기기 | 35000 |
3 | 키보드 | 주변기기 | 89000 |
4 | 모니터 | 전자기기 | 450000 |
5 | 헤드셋 | 주변기기 | 120000 |
Props
ToolbarGrid 고유 Props
| Prop | Type | Default | 설명 |
|---|---|---|---|
title | ReactNode | - | 헤더 제목 |
actions | ReactNode | - | 도구 모음 버튼 |
visible | boolean | true | false이면 비렌더링 |
defaultCollapsed | boolean | false | 초기 접힘 상태 |
collapseDisabled | boolean | false | 접기 잠금 (항상 펼침) |
toolbarPosition | 'top' | 'bottom' | 'top' | 도구 모음 위치 |
showPageTotal | boolean | false | 전체 건수 표시 |
searchContent | ReactNode | - | 검색 폼 영역 콘텐츠 |
columns | number | 24 | 검색 폼 격자 컬럼 수 |
colGap | number | 15 | 검색 폼 가로 간격 (px) |
rowGap | number | 20 | 검색 폼 세로 간격 (px) |
readOnly | boolean | false | 검색 폼 읽기 전용 |
showLabel | boolean | true | 레이블 표시 여부 |
labelPosition | LabelPosition | 'left' | 레이블 위치 |
backgroundColor | string | - | wrapper + 헤더 + Grid 배경색 |
color | string | - | 헤더 글자색 |
borderWidth | string | - | 헤더 테두리 두께 |
borderColor | string | - | 헤더 테두리 색상 |
fullSize | boolean | false | 전체 화면 확장 |
className | string | - | wrapper CSS 클래스 |
style | CSSProperties | - | wrapper 인라인 스타일 |
Grid 패스스루 Props
Grid 컴포넌트의 모든 props(data, getRowId, children, loading, pagination, pageSize, selectable, virtualScroll 등)를 직접 전달합니다. 자세한 내용은 Grid 문서를 참조하세요.
ToolbarGrid.Col
검색 폼 격자 안에 컨트롤을 배치하는 열 컴포넌트입니다.
| Prop | Type | Default | 설명 |
|---|---|---|---|
span | number | 24 | 차지할 컬럼 수 |
offset | number | 0 | 시작 전 건너뛸 컬럼 |
hidden | boolean | false | 숨김 처리 |
접기 / 펴기
- 헤더를 클릭하면 콘텐츠(검색 폼 + 그리드)가 접힙니다.
defaultCollapsed={true}: 초기 접힌 상태로 시작합니다.collapseDisabled={true}: 항상 펼침 상태로 고정됩니다(토글 불가).
Preview
ID | 상품명 |
|---|---|
1 | 노트북 |
2 | 마우스 |
3 | 키보드 |
4 | 모니터 |
5 | 헤드셋 |
도구 모음 위치
toolbarPosition="bottom"으로 설정하면 actions가 콘텐츠 영역 하단에 배치됩니다.
<ToolbarGrid
title="하단 도구모음"
toolbarPosition="bottom"
actions={<button>조회</button>}
...
/>전체 건수 표시
showPageTotal={true}와 rowCount를 함께 전달하면 도구 모음에 “시작-끝 / 전체건수” 형식으로 표시됩니다.
Preview
1-20 / 350
ID | 상품명 | 가격 |
|---|---|---|
1 | 노트북 | 1500000 |
2 | 마우스 | 35000 |
3 | 키보드 | 89000 |
4 | 모니터 | 450000 |
5 | 헤드셋 | 120000 |
접근성
- Collapsible trigger에
aria-expanded자동 노출 collapseDisabled시aria-disabled설정- 검색 폼 영역에
role="search"적용 readOnly시 검색 폼에aria-readonly설정
Last updated on