---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideModal - 클라이언트

# GlideModal - 클라이언트 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분

GlideModal API는 컨텐츠 오버레이를 표시하는 메서드를 제공합니다.

클라이언트 측 JavaScript를 사용할 수 있는 모든 스크립트에서 이러한 메서드를 사용합니다. 이러한 메서드는 클라이언트 확인란이 선택된 UI 작업에서 가장 자주 호출됩니다.  
이는 GlideWindow 및 GlideDialogWindow API를 완벽하게 대체합니다.그림 1. 오버레이 예

## GlideModal - GlideModal(문자열 ID, 부울 읽기 전용, 숫자 너비) {#ariaid-title2}

GlideModalV3 클래스의 인스턴스를 작성합니다.
{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| id | 문자열 | 모달로 로드할 UI 페이지입니다. |
| readOnly | 부울 | 모달에서 닫기 버튼을 숨길지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 모달에 닫기 버튼을 표시하지 않습니다. * false: 모달에 닫기 버튼을 표시합니다. 기본값: false |
| width | 번호 | 모달의 너비(픽셀)입니다. 기본값: 최대 너비: 900픽셀 주: 메서드를 사용하여 모달 너비를 [GlideModal - setWidth(숫자 너비)](https://servicenow-prod.fluidtopics.net/kzN1GByOrcgwLuOOBeFIHQ#r_GMODV3-setWidth_N "모달의 너비를 픽셀 단위로 설정합니다.") 설정할 수도 있습니다. |
[표 1. 매개변수]

{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v}

## GlideModal - get(문자열 ID) {#ariaid-title3}

ID로 GlideModal 객체를 가져옵니다.
{#r_GMODV3-get_S__table_vwy_xjz_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| id | 문자열 | GlideModal 객체의 요소 ID입니다. |
[표 2. 매개변수]

{#r_GMODV3-get_S__table_vwy_xjz_3v} {#r_GMODV3-get_S__table_wwy_xjz_3v__entry__2}

| 유형 | 설명 |
|-|-|
| GlideModal | 개체입니다. |
[표 3. 반환]

{#r_GMODV3-get_S__table_wwy_xjz_3v}

## GlideModal - getPreference(문자열 이름) {#ariaid-title4}

지정된 기본 설정(속성) 값을 반환합니다.
모달을 만드는 작업을 호출하면 일반적으로 메서드를 사용하여 [GlideModal - setPreference(문자열 이름, 문자열 값)](https://servicenow-prod.fluidtopics.net/kzN1GByOrcgwLuOOBeFIHQ#r_GMODV3-setPreference_S_S "현재 양식의 지정된 필드를 지정된 값으로 설정합니다.") 모달에 필요한 기본 설정도 생성됩니다. 그런 다음 UI 페이지 클라이언트 스크립트는 이 메서드를 사용하여 이러한 기본 설정을 사용합니다.
{#r_GMODV3-getPreference_S__table_r2h_mrs_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 검색할 기본 설정 값의 이름입니다. 이 값은 메서드를 사용하여 [GlideModal - setPreference(문자열 이름, 문자열 값)](https://servicenow-prod.fluidtopics.net/kzN1GByOrcgwLuOOBeFIHQ#r_GMODV3-setPreference_S_S "현재 양식의 지정된 필드를 지정된 값으로 설정합니다.") 모달에서 미리 설정했어야 합니다. |
[표 4. 매개변수]

{#r_GMODV3-getPreference_S__table_r2h_mrs_3v} {#r_GMODV3-getPreference_S__table_s2h_mrs_3v__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 기본 설정 값입니다. |
[표 5. 반환]

{#r_GMODV3-getPreference_S__table_s2h_mrs_3v}  
이 예제에서는 기본 설정을 설정한 다음 지정된 모달에서 해당 기본 설정을 검색하는 간단한 사례를 보여 줍니다.

    var gm = new GlideModal('UI_dialog_name');
    //Sets the dialog title
    gm.setTitle('Show title');

    //sets the value of the preference table
    gm.setPreference('table', 'incident');

    //gets the value of the preference table
    var title = gm.getPreference('table');

## GlideModal - render() {#ariaid-title5}

모달에서 UI 페이지를 렌더링합니다.
{#r_GMODV3-render__table_zky_hpy_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 6. 매개변수]

{#r_GMODV3-render__table_zky_hpy_3v} {#r_GMODV3-render__table_aly_hpy_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 7. 반환]

{#r_GMODV3-render__table_aly_hpy_3v}  

    var gm = new GlideModal("UI_dialog_name");

    //Sets the dialog title
    gm.setTitle('Show title');		      	
    gm.setWidth(550);

    //Opens the dialog
    gm.render();

## GlideModal - renderWithContent(객체 html) {#ariaid-title6}

지정된 HTML 컨텐츠를 포함하는 모달을 표시합니다.
renderWithContent() 메서드는 render() 메서드를 대체하며 렌더링할 UI 페이지를 요청하지 않습니다.
{#r_GMODV3-renderWithContent_O__table_n43_xhz_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| html | 객체 | 모달에 표시할 HTML 콘텐츠입니다. |
[표 8. 매개변수]

{#r_GMODV3-renderWithContent_O__table_n43_xhz_3v} {#r_GMODV3-renderWithContent_O__table_o43_xhz_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 9. 반환]

{#r_GMODV3-renderWithContent_O__table_o43_xhz_3v}

## GlideModal - renderWithContent(문자열 html) {#ariaid-title7}

지정된 HTML 컨텐츠를 포함하는 모달을 표시합니다.
renderWithContent() 메서드는 render() 메서드를 대체하며 렌더링할 UI 페이지를 요청하지 않습니다.
{#r_GMODV3-renderWithContent_S__table_xss_3hz_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| html | 문자열 | 모달에 표시할 HTML 콘텐츠입니다. |
[표 10. 매개변수]

{#r_GMODV3-renderWithContent_S__table_xss_3hz_3v} {#r_GMODV3-renderWithContent_S__table_yss_3hz_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 11. 반환]

{#r_GMODV3-renderWithContent_S__table_yss_3hz_3v}

## GlideModal - setPreference(문자열 이름, 문자열 값) {#ariaid-title8}

현재 양식의 지정된 필드를 지정된 값으로 설정합니다.
{#r_GMODV3-setPreference_S_S__table_cvd_zqs_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 업데이트할 양식 필드의 이름입니다. 이 필드가 현재 양식에 없으면 요청이 무시됩니다. |
| 값 | 문자열 | 지정된 양식 필드에 저장할 값입니다. |
[표 12. 매개변수]

{#r_GMODV3-setPreference_S_S__table_cvd_zqs_3v} {#r_GMODV3-setPreference_S_S__table_dvd_zqs_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 13. 반환]

{#r_GMODV3-setPreference_S_S__table_dvd_zqs_3v}  

    var gm = new GlideModal('UI_dialog_name');
    //Sets the dialog title
    gm.setTitle('Show title'); 
    gm.setPreference('table', 'task'); 			
    gm.setPreference('name', 'value');        	

    //Opens the dialog
    gm.render();

## GlideModal - setPreferenceAndReload(배열 속성) {#ariaid-title9}

속성을 설정하고 모달을 다시 로드합니다.
{#r_GMODV3-setPrefAndReload_A__table_u3v_jqy_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 속성 | 배열 | 설정할 이름-값 쌍의 배열입니다. |
[표 14. 매개변수]

{#r_GMODV3-setPrefAndReload_A__table_u3v_jqy_3v} {#r_GMODV3-setPrefAndReload_A__table_v3v_jqy_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 15. 반환]

{#r_GMODV3-setPrefAndReload_A__table_v3v_jqy_3v}

## GlideModal - setTitle(문자열 제목) {#ariaid-title10}

모달의 제목을 설정합니다.
{#r_GMODV3-setTitle_S__table_kxd_l5s_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 제목 | 문자열 | 표시할 제목 |
[표 16. 매개변수]

{#r_GMODV3-setTitle_S__table_kxd_l5s_3v} {#r_GMODV3-setTitle_S__table_lxd_l5s_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 17. 반환]

{#r_GMODV3-setTitle_S__table_lxd_l5s_3v}  

    var dialog = new GlideModal('UI_dialog_name');

    //Sets the dialog title
    dialog.setTitle('Show title');
    dialog.setPreference('name', 'value');
     			      	        
    //Opens the dialogdialog.render(); 

## GlideModal - setWidth(숫자 너비) {#ariaid-title11}

모달의 너비를 픽셀 단위로 설정합니다.
메서드를 사용하여 모달을 처음 인스턴스화할 때 모달의 너비를 [GlideModal - GlideModal(문자열 ID, 부울 읽기 전용, 숫자 너비)](https://servicenow-prod.fluidtopics.net/kzN1GByOrcgwLuOOBeFIHQ#r_GMODV3-GlideModal_S_B_N "GlideModalV3 클래스의 인스턴스를 작성합니다.") 설정할 수도 있습니다.
{#r_GMODV3-setWidth_N__table_msx_wts_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| width | 번호 | 모달의 너비로 설정할 픽셀 수입니다. 최대: 900픽셀 |
[표 18. 매개변수]

{#r_GMODV3-setWidth_N__table_msx_wts_3v} {#r_GMODV3-setWidth_N__table_nsx_wts_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 19. 반환]

{#r_GMODV3-setWidth_N__table_nsx_wts_3v}  

    var dialog = new GlideModal('UI_dialog_name');

    //Sets the dialog title
    dialog.setTitle('Show title'); 
    dialog.setPreference('name', 'value'); 			      	
    dialog.setWidth(550);

    //Opens the dialog
    dialog.render();

## GlideModal - switchView(String newView) {#ariaid-title12}

뷰를 변경하고 모달을 다시 로드합니다.
{#r_GMODV3-switchView_S__table_ovv_5py_3v__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| newView | 문자열 | 사용할 뷰입니다. |
[표 20. 매개변수]

{#r_GMODV3-switchView_S__table_ovv_5py_3v} {#r_GMODV3-switchView_S__table_pvv_5py_3v__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 21. 반환]

{#r_GMODV3-switchView_S__table_pvv_5py_3v}