TextField

PDF 매핑: 텍스트 필드 (/FT /Tx, ISO 32000 § 12.7.4.3)

한 줄 텍스트를 입력받는 필드입니다. 표준 PDF 폼 필드로 저장되므로 Acrobat 등 다른 PDF 뷰어에서도 값이 그대로 보이고 입력할 수 있습니다.

1.그리기

편집 모드에서 그리기를 시작하고 드래그하면 그 영역에 필드가 생성됩니다.

실행 예제: 버튼을 누르고 문서 위에 드래그해 보세요준비 중…
JSTextField 그리기
viewer.document.drawing.beginDraw(DRAWING_DRAW_MODE.TEXT_FIELD);

2.속성

선택한 필드의 field 객체에서 읽고 쓸 수 있습니다. 변경 사항은 저장 시 PDF의 /DA(기본 외관)로 기록되어 왕복됩니다.

속성타입설명PDF 대응
valuestring입력 값/V
fontNamestring글꼴 이름/DA Tf
fontSizenumber글자 크기 (pt)/DA Tf
quaddingenum정렬 (왼쪽/중앙/오른쪽)/Q
maxLennumber최대 입력 길이/MaxLen
multilineboolean여러 줄 입력/Ff Multiline
readOnlyboolean읽기 전용/Ff ReadOnly
JS속성 변경: 대입하면 즉시 화면 반영, 저장 시 PDF 기록
const field = viewer.document.selectedAnnotations[0].field;

field.fontSize = 14;
field.value = '홍길동';

3.형식 필드 (숫자, 날짜)

format 속성으로 입력 형식을 지정하면 입력을 제한할 수 있습니다. 숫자 형식은 숫자, 소수점만 받고, 날짜 형식은 날짜 선택으로 동작합니다.

• 여러 줄 입력

multiline을 true로 두면 텍스트필드가 textarea처럼 여러 줄을 입력받습니다. 그리기는 beginDraw(DRAWING_DRAW_MODE.TEXT_FIELD, { multiline: true })로 시작합니다.