콘텐츠로 이동

2.2 표레이아웃

표 레이아웃 가이드

표 레이아웃은 행/열 구조, 너비, 높이, 병합 등 을 수정할 수 있습니다.

또한, 생성된 표 내부에는 style 설정을 통해
헤더, 열 너비, 표 테두리 스타일, 셀 배경색, 셀 내 여백, 텍스트 정렬 등을
추가로 지정할 수 있습니다.

2.2.1 헤더 행 지정 (headerRow)

헤더 행 지정 가이드

headerRow는 헤더로 처리할 행의 인덱스를 지정합니다.

기본 규칙

  • 인덱스는 0부터 시작하며, 기본값 0 입니다.
  • 지정된 행은 페이지 분할 시 반복 대상이 됩니다.

사용 예시

headerRow example
{
  "placeholder": "table_3",
  "type": "table",
  "data": [
    ["구분", "항목", "금액"],
    ["1", "품목A", "100,000"],
    ["2", "품목C", "200,000"],
    ["3", "품목D", "300,000"]
  ],
  "style": {
    "headerRow": 0,
    "repeatHeader": true,
    "columnWidths": [50, 50, 50]
  }
}

2.2.2 헤더 반복 (repeatHeader)

헤더 반복 가이드

repeatHeader=true이면 페이지 경계에서 표가 분할될 때
헤더 행이 다음 페이지에도 자동 반복됩니다.

기본 규칙

  • headerRow가 지정된 경우에만 동작합니다.
  • 기본값 true 입니다.

사용 예시

repeatHeader example
{
  "placeholder": "table_3",
  "type": "table",
  "data": [
    ["구분", "항목", "금액"],
    ["1", "품목A", "100,000"],
    ["2", "품목C", "200,000"],
    ["3", "품목D", "300,000"]
  ],
  "style": {
    "headerRow": 0,
    "repeatHeader": true,
    "columnWidths": [50, 50, 50]
  }
}

2.2.3 열 너비 지정 (columnWidths)

열 너비 지정 가이드

columnWidths는 각 열의 너비를 배열로 지정합니다.

기본 규칙

  • 배열 길이는 표의 열 개수와 반드시 동일해야 합니다.
  • mm 기반으로 입력해주세요.

사용 예시

column width example
{
  "placeholder": "table_3",
  "type": "table",
  "data": [
    ["구분", "항목", "금액"],
    ["1", "품목A", "100,000"],
    ["2", "품목C", "200,000"],
    ["3", "품목D", "300,000"]
  ],
  "style": {
    "headerRow": 0,
    "repeatHeader": true,
    "columnWidths": [50, 50, 50]
  }
}

2.2.4 스타일 확장 (style)

스타일 확장

표 생성 이후 아래의 style 속성을 추가할 수 있습니다.