Text

텍스트를 표시할 때 사용하는 아이템입니다.

text-item-sample

Basic

이름	타입	설명	필수여부
Name	string	아이템에 고유한 이름을 설정합니다.	no
Tag	string	아이템에 태그값을 설정합니다.	no
Visible	boolean	아이템의 표시 여부를 설정합니다.	yes
Page Break	PageBreakMode	아이템을 출력하기 전에 페이지를 어떻게 나눌 것인지 대해 설정합니다.	no

Design

이름	타입	설명	필수여부
Design Border	boolean	아이템의 디자인 가능한 경계 영역의 표시를 설정합니다.	yes

Event

이름	타입	설명	필수여부
OnGetValue	ReportItemValueCallback	아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.	no
OnGetStyles	ReportItemStyleCallback	아이템에 적용되는 스타일을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.	no
OnGetVisible	ReportItemVisibleCallback	아이템의 표시 여부를 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.	no
OnGetContextValue	ContextValueCallback	아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다.	no

Bound

이름	타입	설명	필수여부
Width	number	아이템의 넓이를 설정합니다.	no
Height	number	아이템의 높이를 설정합니다.	no
Rotation	number	아이템의 회전 각도를 설정합니다.	no
Left	number	아이템의 위치를 부모 요소 기준으로 "왼쪽"에서 설정합니다.	no
Right	number	아이템의 위치를 부모 요소 기준으로 "오른쪽"에서 설정합니다.	no
Top	number	아이템의 위치를 부모 요소 기준으로 "위"에서 설정합니다.	no
Bottom	number	아이템의 위치를 부모 요소 기준으로 "아래"에서 설정합니다.	no

Data

이름	타입	설명	필수여부
Data	string	아이템에 리포트에 존재하는 데이터를 연결합니다.	no
Value	string	아이템에 연결된 데이터에서 표시할 필드를 선택하거나 ContextData를 입력 합니다.	no
Link Field	string	링크기능 사용시 linkUrl 값을 연결할 필드를 선택합니다.	no
Merge Rule	string	다음행과 병합해야 할 조건을 설정합니다.	no

Merge Rule

Table Band 아이템의 Data Row 영역 안에서만 적용되는 규칙입니다.

다음행과 병합해야 할 조건을 설정합니다.

타입: string
기본값: undefined

설명

value로 설정하면 다음행의 값이 같은 경우에 자동으로 행을 병합합니다.
:필드명 데이터의 필드명으로 설정하면 다음 데이터 행의 설정한 필드명과 데이터가 같은 경우 자동으로 행을 병합합니다.

필드명 설정하기 예시

제조회사쪽 열을 모델명 데이터 필드를 기준으로 자동 행 병합 설정

merge-rule-design

merge-rule-preview

Link

이름	타입	설명	필수여부
LinkUrl	string	이 속성에 url 입력하면 미리보기 상태에서 클릭시 웹 브라우저에서 해당 url로 이동합니다.	no
LinkTarget	string	링크기능 사용시 브라우저의 실행 타겟 (opens in a new tab)을 지정합니다.	no

Text

텍스트 아이템에서 사용되는 속성

이름	타입	설명	필수여부
Wrap	boolean	표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다.	yes
Multi Line	boolean	텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다.	no
Boolean Format	string	텍스트 아이템에 연결된 데이터 타입이 `boolean`일 경우에 표현 방식을 설정합니다.	no
Number Format	string	텍스트 아이템에 연결된 데이터 타입이 `number`일 경우에 표현 방식을 설정합니다.	no
Date Format	string	텍스트 아이템에 연결된 데이터 타입이 `Date`일 경우에 표현 방식을 설정합니다.	no
Text Format	string	텍스트 아이템에 연결된 데이터 타입이 `Text`일 경우에 표현식을 설정합니다.	no
Prefix	string	텍스트 아이템에서 표시되는 값에 접두사를 설정합니다.	no
Suffix	string	텍스트 아이템에서 표시되는 값에 접미사를 설정합니다.	no
Text	string	텍스트 아이템에 표시될 문구를 설정합니다.	no
Rich	boolean	텍스트 아이템에 특정 Html 태그 사용을 허용합니다.	yes

Wrap

표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다. 이때 Width가 명시적으로 입력되지 않은 경우 wrap 속성은 적용되지 않습니다.

타입: boolean
기본값: false

Multi Line

텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다.

타입: boolean
기본값: false

설명

true로 설정할 경우 문자열에 줄바꿈 기능의 문자가 포함된 경우 출력시 해당 위치에서 줄바꿈 됩니다. 줄바꿈 문자는 아래와 같습니다.

  |  
이스케이프 문자: \r | \n | \r\n

Boolean Format

텍스트 아이템에 연결된 데이터 타입이 boolean일 경우에 표현 방식을 설정합니다.

타입: boolean
기본값: false:true

설명

콜론(:)을 기준으로"false 문구":"true 문구" 표현 방식을 설정합니다.

ℹ️

사용법 예시

미확인:확인 으로 설정
데이터가 false일 경우 "미확인"으로 표기
데이터가 true일 경우 "확인"으로 표기

⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

Number Format

텍스트 아이템에 연결된 데이터 타입이 number일 경우에 표현 방식을 설정합니다.

타입: string
기본값: #,##0

설명

0의 의미는 고정된 자리를 의미하고, #은 가변 자리를 의미합니다.

ℹ️

사용법 예시
#,##0.### 의 경우

100 -> 100
10000 -> 10,000
100.1 -> 100.1
1000.12 -> 1,000.12
1000.1234 -> 1,000.123
1000.1237 -> 1,000.124

#,##0.000 의 경우

100 -> 100.000
10000 -> 10,000.000
100.1 -> 100.100
1000.12 -> 1,000.120
1000.1234 -> 1,000.123
1000.1237 -> 1,000.124

#,##0.0## 의 경우

100 -> 100.0
10000 -> 10,000.0
100.1 -> 100.1
1000.12 -> 1,000.12
1000.1234 -> 1,000.123
1000.1237 -> 1,000.124

Date Format

텍스트 아이템에 연결된 데이터 타입이 Date일 경우에 표현 방식을 설정합니다.

타입: string
기본값: yyyy.MM.dd

ℹ️

사용법 예시

yyyy-MM-dd: "2022-01-01"로 표시합니다.
yyyy년 MM월 dd일: "2022년 01월 01일"로 표시합니다.

⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

Text Format

텍스트 아이템에 연결된 데이터 타입이 Text일 경우에 표현식을 설정합니다.

타입: string
기본값: undefined

설명

세미콜론(;)을 기준으로 왼쪽에는 변경될 표현식을 설정하고, 오른쪽에는 javascript string.prototpye.replace() (opens in a new tab) 함수의 두 번째 매개변수와 같은 타입으로 지정합니다.

ℹ️

사용법 예시

Mr. 홍길동: ([A-Za-z]*);Mr. $1,
사업자번호: (\d{3})(\d{2})(\d{5});$1-$2-$3

⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

Prefix

텍스트 아이템에서 표시되는 값에 접두사를 설정합니다.

타입: string
기본값: undefined

⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

Suffix

텍스트 아이템에서 표시되는 값에 접미사를 설정합니다.

타입: string
기본값: undefined

⚠️

Data Value가 연결되어 있는 경우에만 적용됩니다.

Text

텍스트 아이템에 표시될 문구를 설정합니다.

타입: string
기본값: undefined

⚠️

Data Value가 연결되어 있을 경우 연결된 데이터로 표시됩니다.

Rich

텍스트 아이템에서 특정 Html Tag 사용을 허용합니다.

타입: boolean
기본값: false

사용 가능한 태그

사용 가능한 스타일 속성

color

예시)

<span style="color:red">텍스트 아이템 문구</span>

⚠️

허용한 태그 및 스타일 이외의 내용으로 사용시 출력 및 내보내기를 지원하지 않습니다.
문서 내보내기에서 Rich 속성은 PDF 내보내기만 지원합니다.

Editing

미리보기에서 편집이 가능하도록 설정하는 속성

Editable

텍스트 아이템을 미리보기에서 편집 가능하도록 설정합니다.

타입: boolean
기본값: false

Type

편집기의 종류를 설정합니다.

타입: EditType
기본값: text

Internationalization

다국어 관련 정보를 설정하는 속성

Field

다국어 설정에서 연결할 필드를 설정합니다.

타입: string
기본값: undefined

⚠️

Data Value가 연결되어 있을 경우 연결된 데이터로 표시됩니다.

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
Vertical Align	string	아이템의 세로 정렬을 설정합니다.	no
Writing Mode	string	아이템의 텍스트가 배치되는 방향을 설정합니다.	no
Padding Left	string	아이템의 왼쪽 내부 여백을 설정합니다.	no
Padding Top	string	아이템의 위쪽 내부 여백을 설정합니다.	no
Padding Right	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

페이지 내부 영역 Summary