목록 및 공통 속성
아이템 목록
일반 아이템
- 텍스트
- 이미지
- 요약
- 간격
- 테이블
차트 아이템
밴드 아이템
- 테이블 밴드
컨테이너 아이템
- 로우박스
- 컬럼박스
기본 속성
모든 아이템에 해당되는 기본 속성
| 이름 | 타입 | 설명 | 필수여부 |
|---|---|---|---|
| Name | string | 아이템에 고유한 이름을 설정합니다. | no |
| Visible | boolean | 아이템의 표시 여부를 설정합니다. | yes |
Name
아이템에 고유한 이름을 설정합니다.
- 타입: string
- 기본값: undefined
아이템 Event에서 특정 아이템을 가져올 때 사용 가능
Visible
아이템의 표시 여부를 설정합니다.
- 타입: boolean
- 기본값: true
Event
아이템의 이벤트 함수 관련 로직을
javascript문법으로 선언할 수 있는 속성
Return 구문에 올바른 반환 타입의 데이터를 설정하면 반환 타입의 정보대로 아이템이 설정된다.
| 이름 | 타입 | 설명 | 필수여부 |
|---|---|---|---|
| OnGetValue | EmailItemValueCallback | 아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다. | no |
| OnGetStyles | EmailItemStyleCallback | 아이템에 적용되는 스타일을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다. | no |
| OnGetVisible | EmailItemVisibleCallback | 아이템에 표시 여부를 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다. | no |
인자
| 인자 | 타입 | 설명 |
|---|---|---|
| ctx | PrintContext | 출력 관련 정보를 가지고 있는 객체 |
| item | EmailItem | 아이템 관련 정보를 가지고 있는 객체 |
| row | Number | 아이템이 DataRow로 표시되는 경우에 각 줄의 행번호 정보 |
| value | any | 아이템에 표시되는 값 |
OnGetValue
아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.
- 타입: EmailItemValueCallback
- 기본값: undefined
- 인자:
ctx|item|row|value - 반환 타입: string | number
OnGetValue Event는 OnGetContextValue Event보다 먼저 실행된다.
아이템의 값이 "0" 이하인 경우 데이터를 변경
function onGetValue(ctx, item, row, value) {
if (value <= 0) {
return '무료';
}
}OnGetStyles
아이템에 적용되는 스타일을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.
background, fontWeight, color, fontSize 스타일 변경만 가능합니다.
- 타입: EmailItemStyleCallback
- 기본값: undefined
- 인자:
ctx|item|row|value - 반환 타입: object
설명
반환 타입에서 { key: value, ... } 형태의 데이터를 반환하면 아이템 스타일을 변경할 수 있다.
사용법 예시
key= camelCase 형식의 스타일 속성명value= 적용될 값
return {
borderTop: '2px solid #red',
borderBottom: '1px solid #red'
}아이템의 값이 "검출"인 경우 스타일을 변경
function onGetStyles(ctx, item, row, value) {
if (value === '검출') {
return {
color: 'red',
backgroundColor: 'gray'
};
}
}Bounds
아이템의 위치 및 사이즈에 해당되는 속성
| 이름 | 타입 | 설명 | 필수여부 |
|---|---|---|---|
| Width | number | 아이템의 넓이를 설정합니다. | no |
| Height | number | 아이템의 높이를 설정합니다. | no |
| Align | string | 아이템의 정렬을 설정합니다. | no |
Width
아이템의 넓이를 설정합니다.
- 타입: number
- 기본값: undefined
Height
아이템의 높이를 설정합니다.
- 타입: number
- 기본값: undefined
Align
아이템의 수평 정렬을 설정합니다.
- 타입: string
- 기본값: undefined
Data
아이템에 데이터를 연결시키는 속성
| 이름 | 타입 | 설명 | 필수여부 |
|---|---|---|---|
| Data | string | 아이템에 리포트에 존재하는 데이터를 연결합니다. | no |
| Value | string | 아이템에 연결된 데이터에서 표시할 필드를 설정합니다. | no |
Data
아이템에 데이터를 연결합니다.
- 타입: string
- 기본값: undefined
Value
아이템에 연결된 데이터에서 표시할 필드를 설정합니다.
- 타입: string
- 기본값: undefined
Styles
아이템의 스타일과 관련된 속성
| 이름 | 타입 | 설명 | 필수여부 |
|---|---|---|---|
| Font Family | string | 아이템의 글꼴을 설정합니다. | no |
| Font Size | number | 아이템의 텍스트 크기를 설정합니다. | no |
| Font Style | string | 아이템의 글꼴체를 설정합니다. | no |
| Text Decoration | string | 아이템의 텍스트에 선 스타일을 설정합니다. | no |
| Font Weight | string | 아이템의 텍스트 굵기를 설정합니다. | no |
| Color | string | 아이템의 텍스트 색상을 설정합니다. | no |
| Background Color | string | 아이템의 배경 색상을 설정합니다. | no |
| Text Align | string | 아이템의 텍스트 가로 정렬을 설정합니다. | no |
| Padding Top | string | 아이템의 위쪽 내부 여백을 설정합니다. | no |
| Padding Bottom | string | 아이템의 아래쪽 내부 여백을 설정합니다. | no |
| Border | string | 아이템의 테두리를 설정합니다. | no |
| Border Left | string | 아이템의 왼쪽 테두리를 설정합니다. | no |
| Border Right | string | 아이템의 오른쪽 테두리를 설정합니다. | no |
| Border Top | string | 아이템의 위쪽 테두리를 설정합니다. | no |
| Border Bottom | string | 아이템의 아래쪽 테두리를 설정합니다. | no |
| Border Radius | string | 아이템의 테두리 모서리를 둥글게 설정합니다. | no |
| Top Left | string | 아이템의 왼쪽 위 모서리를 둥글게 설정합니다. | no |
| Top Right | string | 아이템의 오른쪽 위 모서리를 둥글게 설정합니다. | no |
| Bottom Right | string | 아이템의 오른쪽 아래 모서리를 둥글게 설정합니다. | no |
| Bottom Left | string | 아이템의 왼쪽 아래 모서리를 둥글게 설정합니다. | 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
Border Radius
아이템의 테두리 가장자리 모서리를 둥글게 설정합니다.
속성 값을 지정하는 방법은 CSS border-radius (opens in a new tab)를 참고하세요.
- 타입: string
- 기본값: undefined
Border Radius Top Left
아이템의 왼쪽 위 모서리를 둥글게 설정합니다.
속성 값을 지정하는 방법은 CSS border-top-left-radius (opens in a new tab)를 참고하세요.
- 타입: string
- 기본값: undefined
Border Radius Top Right
아이템의 오른쪽 위 모서리를 둥글게 설정합니다.
속성 값을 지정하는 방법은 CSS border-top-right-radius (opens in a new tab)를 참고하세요.
- 타입: string
- 기본값: undefined
Border Radius Bottom Right
아이템의 오른쪽 아래 모서리를 둥글게 설정합니다.
속성 값을 지정하는 방법은 CSS border-bottom-right-radius (opens in a new tab)를 참고하세요.
- 타입: string
- 기본값: undefined
Border Radius Bottom Left
아이템의 왼쪽 아래 모서리를 둥글게 설정합니다.
속성 값을 지정하는 방법은 CSS border-bottom-left-radius (opens in a new tab)를 참고하세요.
- 타입: string
- 기본값: undefined