Text
텍스트를 표시할 때 사용하는 아이템입니다.
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
로 설정하면 다음행의 값이 같은 경우에 자동으로 행을 병합합니다.:필드명
데이터의 필드명으로 설정하면 다음 데이터 행의 설정한 필드명과 데이터가 같은 경우 자동으로 행을 병합합니다.
필드명 설정하기 예시
제조회사쪽 열을 모델명 데이터 필드를 기준으로 자동 행 병합 설정
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
로 설정할 경우 문자열에 줄바꿈 기능의 문자가 포함된 경우 출력시 해당 위치에서 줄바꿈 됩니다.
줄바꿈 문자는 아래와 같습니다.
<br>
|<br/>
- 이스케이프 문자:
\r
|\n
|\r\n
Boolean Format
텍스트 아이템에 연결된 데이터 타입이 boolean
일 경우에 표현 방식을 설정합니다.
- 타입: boolean
- 기본값: false:true
설명
콜론(:)
을 기준으로"false 문구":"true 문구"
표현 방식을 설정합니다.
사용법 예시
미확인:확인
으로 설정- 데이터가
false
일 경우 "미확인"으로 표기 - 데이터가
true
일 경우 "확인"으로 표기
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일"로 표시합니다.
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
Prefix
텍스트 아이템에서 표시되는 값에 접두사를 설정합니다.
- 타입: string
- 기본값: undefined
Suffix
텍스트 아이템에서 표시되는 값에 접미사를 설정합니다.
- 타입: string
- 기본값: undefined
Text
텍스트 아이템에 표시될 문구를 설정합니다.
- 타입: string
- 기본값: undefined
Rich
텍스트 아이템에서 특정 Html Tag 사용을 허용합니다.
- 타입: boolean
- 기본값: false
사용 가능한 태그
<b>
<u>
<span>
사용 가능한 스타일 속성
- color
예시)
<span style="color:red">텍스트 아이템 문구</span>
- 허용한 태그 및 스타일 이외의 내용으로 사용시 출력 및 내보내기를 지원하지 않습니다.
- 문서 내보내기에서 Rich 속성은 PDF 내보내기만 지원합니다.
Editing
미리보기에서 편집이 가능하도록 설정하는 속성
Editable
텍스트 아이템을 미리보기에서 편집 가능하도록 설정합니다.
- 타입: boolean
- 기본값: false
Type
편집기의 종류를 설정합니다.
- 타입: EditType
- 기본값: text
Internationalization
다국어 관련 정보를 설정하는 속성
Field
다국어 설정에서 연결할 필드를 설정합니다.
- 타입: 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 |
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 |