문서
email
이메일 아이템
목록 및 공통 속성

목록 및 공통 속성

아이템 목록

일반 아이템

  • 텍스트
  • 이미지
  • 요약
  • 간격
  • 테이블

차트 아이템

밴드 아이템

  • 테이블 밴드

컨테이너 아이템

  • 로우박스
  • 컬럼박스

기본 속성

모든 아이템에 해당되는 기본 속성

이름타입설명필수여부
Namestring아이템에 고유한 이름을 설정합니다.no
Visibleboolean아이템의 표시 여부를 설정합니다.yes

Name

아이템에 고유한 이름을 설정합니다.

  • 타입: string
  • 기본값: undefined
💡

아이템 Event에서 특정 아이템을 가져올 때 사용 가능

Visible

아이템의 표시 여부를 설정합니다.

  • 타입: boolean
  • 기본값: true

Event

아이템의 이벤트 함수 관련 로직을 javascript 문법으로 선언할 수 있는 속성

ℹ️

Return 구문에 올바른 반환 타입의 데이터를 설정하면 반환 타입의 정보대로 아이템이 설정된다.

이름타입설명필수여부
OnGetValueEmailItemValueCallback아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.no
OnGetStylesEmailItemStyleCallback아이템에 적용되는 스타일을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.no
OnGetVisibleEmailItemVisibleCallback아이템에 표시 여부를 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.no

인자

인자타입설명
ctxPrintContext출력 관련 정보를 가지고 있는 객체
itemEmailItem아이템 관련 정보를 가지고 있는 객체
rowNumber아이템이 DataRow로 표시되는 경우에 각 줄의 행번호 정보
valueany아이템에 표시되는 값

OnGetValue

아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.

  • 타입: EmailItemValueCallback
  • 기본값: undefined
  • 인자: ctx | item | row | value
  • 반환 타입: string | number
⚠️

OnGetValue EventOnGetContextValue Event보다 먼저 실행된다.

💬

아이템의 값이 "0" 이하인 경우 데이터를 변경

onGetValue
function onGetValue(ctx, item, row, value) {
    if (value <= 0) {
        return '무료';
    }
}

OnGetStyles

아이템에 적용되는 스타일을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.

🔥

background, fontWeight, color, fontSize 스타일 변경만 가능합니다.

설명

반환 타입에서 { key: value, ... } 형태의 데이터를 반환하면 아이템 스타일을 변경할 수 있다.

ℹ️

사용법 예시

  • key = camelCase 형식의 스타일 속성명
  • value = 적용될 값
return { 
    borderTop: '2px solid #red',
    borderBottom: '1px solid #red'
}
💬

아이템의 값이 "검출"인 경우 스타일을 변경

onGetStyles
function onGetStyles(ctx, item, row, value) {
    if (value === '검출') {
        return {
            color: 'red',
            backgroundColor: 'gray'
        };
    }
}

Bounds

아이템의 위치 및 사이즈에 해당되는 속성

이름타입설명필수여부
Widthnumber아이템의 넓이를 설정합니다.no
Heightnumber아이템의 높이를 설정합니다.no
Alignstring아이템의 정렬을 설정합니다.no

Width

아이템의 넓이를 설정합니다.

  • 타입: number
  • 기본값: undefined

Height

아이템의 높이를 설정합니다.

  • 타입: number
  • 기본값: undefined

Align

아이템의 수평 정렬을 설정합니다.

  • 타입: string
  • 기본값: undefined

Data

아이템에 데이터를 연결시키는 속성

이름타입설명필수여부
Datastring아이템에 리포트에 존재하는 데이터를 연결합니다.no
Valuestring아이템에 연결된 데이터에서 표시할 필드를 설정합니다.no

Data

아이템에 데이터를 연결합니다.

  • 타입: string
  • 기본값: undefined

Value

아이템에 연결된 데이터에서 표시할 필드를 설정합니다.

  • 타입: string
  • 기본값: undefined

Styles

아이템의 스타일과 관련된 속성

이름타입설명필수여부
Font Familystring아이템의 글꼴을 설정합니다.no
Font Sizenumber아이템의 텍스트 크기를 설정합니다.no
Font Stylestring아이템의 글꼴체를 설정합니다.no
Text Decorationstring아이템의 텍스트에 선 스타일을 설정합니다.no
Font Weightstring아이템의 텍스트 굵기를 설정합니다.no
Colorstring아이템의 텍스트 색상을 설정합니다.no
Background Colorstring아이템의 배경 색상을 설정합니다.no
Text Alignstring아이템의 텍스트 가로 정렬을 설정합니다.no
Padding Topstring아이템의 위쪽 내부 여백을 설정합니다.no
Padding Bottomstring아이템의 아래쪽 내부 여백을 설정합니다.no
Borderstring아이템의 테두리를 설정합니다.no
Border Leftstring아이템의 왼쪽 테두리를 설정합니다.no
Border Rightstring아이템의 오른쪽 테두리를 설정합니다.no
Border Topstring아이템의 위쪽 테두리를 설정합니다.no
Border Bottomstring아이템의 아래쪽 테두리를 설정합니다.no

Font Family

아이템의 글꼴을 설정합니다.

  • 타입: string
  • 기본값: undefined

Font Size

아이템의 텍스트 크기를 설정합니다.

  • 타입: number
  • 기본값: undefined

Font Style

아이템의 글꼴체를 설정합니다.

  • 타입: string
  • 기본값: undefined

Text Decoration

아이템의 텍스트에 선 스타일을 설정합니다.

  • 타입: string
  • 기본값: undefined

Font Weight

아이템의 텍스트 굵기를 설정합니다.

  • 타입: string
  • 기본값: undefined

Color

아이템의 텍스트 색상을 설정합니다.

  • 타입: string
  • 기본값: undefined

Background Color

아이템의 배경 색상을 설정합니다.

  • 타입: string
  • 기본값: undefined

Text Align

아이템의 텍스트에 가로 정렬을 설정합니다.

  • 타입: string
  • 기본값: undefined

Padding Top

아이템의 위쪽 내부 여백을 설정합니다.

  • 타입: string
  • 기본값: undefined

Padding Bottom

아이템의 아래쪽 내부 여백을 설정합니다.

  • 타입: string
  • 기본값: undefined

Border

아이템의 테두리를 설정합니다.

  • 타입: string
  • 기본값: undefined
⚠️

Border 관련 속성이 모두 설정될 경우 Border Left, Right, Top, Bottom 테두리 설정값이 우선시 된다.

Border Left

아이템의 왼쪽 테두리를 설정합니다.

  • 타입: string
  • 기본값: undefined

Border Right

아이템의 오른쪽 테두리를 설정합니다.

  • 타입: string
  • 기본값: undefined

Border Top

아이템의 위쪽 테두리를 설정합니다.

  • 타입: string
  • 기본값: undefined

Border Bottom

아이템의 아래쪽 테두리를 설정합니다.

  • 타입: string
  • 기본값: undefined