스타일 - 범위 지정, 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기13분
  • 글꼴 크기, 테두리 및 정렬과 같은 속성을 정의하기 위한 스타일을 만듭니다. 여러 객체에 동일한 스타일을 동시에 적용할 수 있습니다.

    이 API는 PDF 생성 유틸리티 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 sn_pdfgeneratorutils 네임스페이스 내에서 제공됩니다. 플러그인은 기본적으로 활성화됩니다.

    이 API는 PDF를 생성하기 위해 문서 API 와 함께 사용되는 구성요소입니다.

    다음 API 요소에 사용자 지정 스타일을 적용할 수 있습니다.

    스타일 - style()

    Style 개체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    안 함

    다음 예제에서는 Cell, Paragraph 또는 Table 요소에 추가할 수 있는 Style 개체를 만드는 방법을 보여 줍니다.

    var style = new sn_pdfgeneratorutils.Style();

    스타일 – setBackgroundColor(Color color)

    요소의 배경색을 지정합니다.

    표 2. 매개변수
    이름 유형 설명
    색상 색상 배경색.
    표 3. 반환
    유형 설명
    안 함

    다음 예제에서는 요소 배경색을 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var color = new sn_pdfgeneratorutils.Color([1, 0.9, 0.9]); // provided as array of RGB float values
    
    style.setBackGroundColor(color);

    스타일 – setBold()

    스타일을 굵게 글꼴로 설정합니다.

    표 4. 매개변수
    이름 유형 설명
    없음
    표 5. 반환
    유형 설명
    안 함

    다음 예제에서는 스타일을 굵게 글꼴로 설정하는 방법을 보여 줍니다.

    var style = new sn_pdfgeneratorutils.Style();
    style.setBold();

    스타일 – setBorder(Number width)

    요소의 네 면 모두에 스타일 테두리를 설정합니다.

    표 6. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    표 7. 반환
    유형 설명
    안 함

    다음 예제에서는 스타일 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorder(width);

    스타일 – setBorderBottom(Number width)

    스타일 테두리를 요소의 맨 아래로 설정합니다.

    표 8. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    표 9. 반환
    유형 설명
    안 함

    다음 예제에서는 스타일 테두리를 요소의 아래쪽으로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderBottom(width);

    스타일 – setBorderLeft(Number width)

    요소의 왼쪽에 스타일 테두리를 설정합니다.

    표 10. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    표 11. 반환
    유형 설명
    안 함

    다음 예제에서는 요소의 왼쪽에 스타일 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderLeft(width);

    스타일 – setBorderRight(Number width)

    요소의 오른쪽에 스타일 테두리를 설정합니다.

    표 12. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    표 13. 반환
    유형 설명
    안 함

    다음 예제에서는 요소의 오른쪽에 스타일 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderRight(width);

    스타일 – setBorderTop(Number width)

    스타일 테두리를 요소의 맨 위로 설정합니다.

    표 14. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    표 15. 반환
    유형 설명
    안 함

    다음 예제에서는 스타일 테두리를 요소의 맨 위로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 2;
    
    style.setBorderTop(width);

    스타일 – setColoredBorder(Number width, Color color)

    요소의 네 면 모두에 색으로 스타일 테두리를 설정합니다.

    표 16. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    색상 색상 스타일 테두리 색입니다.
    표 17. 반환
    유형 설명
    안 함

    다음 예제에서는 색을 사용하여 스타일 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorder(width, borderColor);

    스타일 – setColoredBorderBottom(숫자, 너비, 색상)

    색상이 있는 스타일 테두리를 요소의 아래쪽으로 설정합니다.

    표 18. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    색상 색상 스타일 테두리 색입니다.
    표 19. 반환
    유형 설명
    안 함

    다음 예제에서는 스타일 테두리를 요소의 아래쪽으로 설정하는 방법을 보여 줍니다.문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderBottom(width, borderColor);

    스타일 – setColoredBorderLeft(숫자, 너비, 색상)

    요소의 왼쪽에 색으로 스타일 테두리를 설정합니다.

    표 20. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    색상 색상 스타일 테두리 색입니다.
    표 21. 반환
    유형 설명
    안 함

    다음 예제에서는 스타일 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderLeft(width, borderColor);

    스타일 – setColoredBorderRight(Number width, Color color)

    요소의 오른쪽에 색으로 스타일 테두리를 설정합니다.

    표 22. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    색상 색상 스타일 테두리 색입니다.
    표 23. 반환
    유형 설명
    안 함

    다음 예제에서는 색을 사용하여 스타일 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderRight(width, borderColor);

    스타일 – setColoredBorderTop(숫자, 너비, 색상)

    색상이 있는 스타일 테두리를 요소의 위쪽으로 설정합니다.

    표 24. 매개변수
    이름 유형 설명
    width 번호 스타일 테두리 너비(포인트)입니다.
    색상 색상 스타일 테두리 색입니다.
    표 25. 반환
    유형 설명
    안 함

    다음 예제에서는 스타일 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var width = 1.0;
    var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
    
    style.setColoredBorderTop(width, borderColor);

    스타일 – setFontColor(Color color)

    글꼴 색상을 설정합니다.

    표 26. 매개변수
    이름 유형 설명
    색상 색상 글꼴 색상입니다.
    표 27. 반환
    유형 설명
    안 함

    다음 예제에서는 글꼴 색을 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var fontColor = new sn_pdfgeneratorutils.Color([1,0.5,0.5]);
    
    style.setFontColor(fontColor);

    스타일 – setFontSize(Number, fontSize)

    스타일 글꼴 크기를 설정합니다.

    표 28. 매개변수
    이름 유형 설명
    글꼴 크기 번호 글꼴 크기(포인트)입니다.
    표 29. 반환
    유형 설명
    안 함

    다음 예제에서는 글꼴 크기를 설정하는 방법을 보여 줍니다.

    var style = new sn_pdfgeneratorutils.Style();
    
    style.setFontSize(12);

    스타일 – setHorizontalAlignment(String alignment)

    스타일의 가로 맞춤을 설정합니다.

    표 30. 매개변수
    이름 유형 설명
    정렬 문자열 가로 맞춤 설정.
    유효한 값은 다음과 같습니다.
    • center: 내용을 중앙에 맞춥니다.
    • 왼쪽: 내용을 왼쪽으로 정렬합니다.
    • 오른쪽: 내용을 오른쪽으로 정렬합니다.
    표 31. 반환
    유형 설명
    안 함

    다음 예제에서는 요소에 가로 맞춤을 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var alignment = "Center";
    
    style.setHorizontalAlignment(alignment);
    

    스타일 – setItalic()

    스타일을 기울임꼴 글꼴로 설정합니다.

    표 32. 매개변수
    이름 유형 설명
    없음
    표 33. 반환
    유형 설명
    안 함

    다음 예제에서는 요소 스타일을 기울임꼴 글꼴로 설정하는 방법을 보여 줍니다.

    var style = new sn_pdfgeneratorutils.Style();
    style.setItalic();

    스타일 – setPadding(Number padding)

    요소의 네 면 모두의 안쪽 여백을 동일한 너비로 설정합니다.

    표 34. 매개변수
    이름 유형 설명
    패딩 번호 10진수 값으로 채워진 너비(포인트)입니다.
    표 35. 반환
    유형 설명
    안 함

    다음 예제에서는 아래쪽 스타일을 2.5포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPadding(padding);

    스타일 – setPaddingBottom(Number padding)

    요소의 아래쪽 패딩 너비 값을 설정합니다.

    표 36. 매개변수
    이름 유형 설명
    패딩 번호 10진수 값으로 채워진 너비(포인트)입니다.
    표 37. 반환
    유형 설명
    안 함

    다음 예제에서는 아래쪽 요소 안쪽 여백을 2.5포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingBottom(padding);

    스타일 – setPaddingLeft(Number padding)

    요소의 왼쪽 패딩 너비 값을 설정합니다.

    표 38. 매개변수
    이름 유형 설명
    패딩 번호 10진수 값으로 채워진 너비(포인트)입니다.
    표 39. 반환
    유형 설명
    안 함

    다음 예제에서는 왼쪽 요소 안쪽 여백을 2.5포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingLeft(padding);

    스타일 – setPaddingRight(숫자 패딩)

    스타일의 오른쪽 안쪽 여백 너비 값을 설정합니다.

    표 40. 매개변수
    이름 유형 설명
    패딩 번호 10진수 값으로 채워진 너비(포인트)입니다.
    표 41. 반환
    유형 설명
    안 함

    다음 예제에서는 오른쪽 요소 안쪽 여백을 2.5포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingRight(padding);

    스타일 – setPaddingTop(Number padding)

    요소의 위쪽 패딩 너비 값을 설정합니다.

    표 42. 매개변수
    이름 유형 설명
    패딩 번호 10진수 값으로 채워진 너비(포인트)입니다.
    표 43. 반환
    유형 설명
    안 함

    다음 예제에서는 상위 요소 안쪽 여백을 2.5포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var padding = 2.5;
    
    style.setPaddingTop(padding);

    스타일 – setTextAlignment(String alignment)

    스타일의 텍스트 정렬을 설정합니다.

    표 44. 매개변수
    이름 유형 설명
    정렬 문자열 텍스트 정렬 위치입니다.
    유효한 값은 다음과 같습니다.
    • text-center: 텍스트를 중앙에 정렬합니다.
    • text-justified: 문자 사이의 공백을 수정하여 왼쪽과 오른쪽 사이의 텍스트를 완전히 채웁니다. 마지막 줄은 왼쪽 맞춤됩니다.
    • text-justified-all: 마지막 줄을 포함하여 텍스트 정렬을 정당화합니다.
    • text-left: 텍스트를 왼쪽으로 정렬합니다.
    • text-right: 텍스트를 오른쪽으로 정렬합니다.
    표 45. 반환
    유형 설명
    안 함

    다음 예제에서는 요소 문자를 가운데 정렬로 설정하는 방법을 보여 줍니다.

    var style = new sn_pdfgeneratorutils.Style();
    
    String alignment = "text-center";
    
    style.setTextAlignment(alignment);

    스타일 – setVerticalAlignment(String alignment)

    이 요소의 세로 맞춤을 설정합니다.

    표 46. 매개변수
    이름 유형 설명
    정렬 문자열 세로 정렬 설정.
    유효한 값은 다음과 같습니다.
    • bottom: 콘텐츠를 하단에 정렬합니다.
    • mid: 콘텐츠를 중앙에 정렬합니다.
    • top: 콘텐츠를 맨 위에 정렬합니다.
    표 47. 반환
    유형 설명
    안 함

    다음 예제에서는 요소에 세로 맞춤을 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var style = new sn_pdfgeneratorutils.Style();
    
    var alignment = "Mid";
    
    style.setVerticalAlignment(alignment);