PDF 내보내기 · Syidax Grid Docs

동작 원리와 선택 기준

한글과 CJK 문자는 지원 글꼴이 필요합니다. 앱이 제공하는 TTF/OTF URL이나 명시적인 fontBytes를 사용하고, 브라우저 로컬 글꼴에 접근할 수 있다는 가정에만 의존하지 않습니다.

이 기능을 제품에서 사용하려면 Pro 패키지와 유효한 라이선스가 필요합니다. 설정 이름이 같더라도 Community에서 Pro 기능이 활성화되는 것은 아닙니다.

코드의 grid는 설치와 연결 장에서 준비한 Grid 요소입니다. 예제마다 필요한 데이터·설정을 확인하고, 코드에서 소개하는 앱 함수와 서버 주소는 프로젝트에 맞게 구현하세요.

아래 URL은 앱이 실제로 호스팅하는 글꼴 파일 경로로 바꿉니다.

javascript

grid.pdfFontUrl = '/fonts/NotoSansKR-Regular.ttf';
await grid.exportDataAsPdf({ fileName: 'orders.pdf' });

결과 확인: 한글 제목과 값이 네모 문자로 깨지지 않는지 생성된 PDF에서 확인합니다.

다운로드 없이 PDF 결과 객체를 얻습니다.

javascript

const result = await grid.getDataAsPdf();
console.log(result);

결과 확인: PdfExportResult 계약에 따라 결과를 처리합니다. 문자열이나 XLSX 바이트와 같은 타입이라고 가정하지 않습니다.

출력할 열과 페이지 관련 옵션을 SyGridPdfExportOptions에서 선택합니다. 긴 제품명·한글·음수·빈 값·다수 페이지가 있는 샘플을 준비해 결과를 검토합니다.

결과 확인: 페이지 경계에서 머리글과 데이터가 읽히는지, 필요한 열이 잘리지 않는지 PDF 뷰어에서 확인합니다. 화면 캡처와는 다른 문서 출력입니다.

폰트 URL의 접근·CORS·라이선스 조건은 앱에서 준비합니다. 개발 환경에서만 읽히는 경로를 배포 문서에 사용하지 마세요.

자동 글꼴 탐색이 실패하는 환경에서도 결과를 확인하고 사용자에게 오류 또는 대체 경로를 안내합니다.

pdfFontUrl
한글 등 PDF 기본 글꼴에 없는 문자를 출력할 앱 호스팅 TTF/OTF 파일 주소입니다.
pdfAutoFont
fontBytes가 없을 때 PDF 글꼴을 자동으로 찾습니다. 지정한 pdfFontUrl을 먼저 사용하고 가능한 환경에서 로컬 글꼴 접근을 시도합니다.
getDataAsPdf
PDF 다운로드 없이 생성 결과 객체를 얻습니다. 한글 출력에는 지원하는 글꼴을 준비합니다.
exportDataAsPdf
표를 PDF 파일로 내려받고 생성 결과를 반환합니다.