편집기 부가기능의 대화상자 및 사이드바

대부분의 편집기 부가기능의 경우 대화상자 창과 사이드바 패널은 기본 부가기능 사용자 인터페이스입니다. 둘 다 표준 HTML 및 CSS를 사용하여 완전히 맞춤설정할 수 있으며 Apps Script 클라이언트-서버 통신 모델 를 사용하면 사용자가 사이드바 또는 대화상자와 상호작용할 때 Apps Script 기능이 실행됩니다. 부가기능은 여러 개의 사이드바와 대화상자를 정의할 수 있지만, 하나씩만 만들 수 있습니다

사용자가 다음 작업을 할 때까지 편집기와 상호작용하지 못하게 하려는 경우 부가기능 인터페이스에서 선택하고 대화상자를 사용합니다. 그렇지 않은 경우 있습니다.

대화상자

대화상자는 기본 편집기 콘텐츠를 오버레이하는 창 패널입니다. 애플리케이션 스크립트 대화상자는 모달입니다. 열린 상태에서 사용자는 다른 요소에도 액세스할 수 있습니다. 콘텐츠와 크기를 맞춤설정할 수 있습니다. 확인할 수 있습니다.

부가기능 대화상자를 Apps Script와 동일한 방식으로 빌드합니다. 맞춤 대화상자 일반적인 권장 절차는 다음과 같습니다.

  1. 대화상자의 HTML 구조를 정의하는 스크립트 프로젝트 파일을 만듭니다. CSS 및 클라이언트 측 JavaScript 동작을 지원합니다. 대화상자를 정의할 때는 편집기 부가기능 스타일 가이드라인을 참고하세요.
  2. 대화상자를 열려는 서버 측 코드에서 다음을 호출합니다. HtmlService.createHtmlOutputFromFile(filename) HtmlOutput 만들기 대화상자를 나타냅니다. 또는 kube-apiserver와 템플릿 HTML 템플릿을 HtmlService.createTemplateFromFile(filename) 템플릿을 생성하고 HtmlTemplate.evaluate() 그것을 HtmlOutput 객체를 사용합니다.
  3. Ui.showModalDialog(htmlOutput, dialogTitle)를 호출합니다. 대화상자를 표시할 수 있습니다. HtmlOutput

대화상자가 열려 있는 동안에는 서버 측 스크립트를 정지하지 않습니다. 이 클라이언트 측 JavaScript는 서버 측에 비동기 호출을 할 수 있습니다. google.script.run() 및 관련 핸들러 함수를 정의합니다. 자세한 내용은 클라이언트 간 통신.

파일 열기 대화상자

파일 열기 대화상자는 사용자가 파일을 선택할 수 있도록 하는 사전 빌드된 대화상자입니다. Google Drive에서 문서를 가져올 수 있습니다. 별도의 설정 없이 파일 열기 대화상자를 부가기능에 추가할 수 있습니다. 설계가 필요하지만 몇 가지 추가 구성이 필요합니다. 또한 부가기능의 Cloud Platform 프로젝트 Google Picker API를 사용 설정해야 합니다.

자세한 내용은 파일 열기 대화상자를 참고하세요.

사이드바는 편집기 인터페이스의 오른쪽에 표시되는 패널입니다. 부가기능 인터페이스의 가장 일반적인 유형입니다. 대화상자와 달리 계속하여 편집기 인터페이스의 다른 요소와 상호작용할 수 있는 있습니다. 사이드바의 너비가 고정되어 있지만 콘텐츠를 맞춤설정할 수 있습니다.

부가기능 사이드바는 Apps Script와 동일한 방식으로 구축 맞춤 사이드바 일반적인 권장 절차는 다음과 같습니다.

  1. 사이드바의 HTML 구조를 정의하는 스크립트 프로젝트 파일을 만듭니다. CSS 및 클라이언트 측 JavaScript 동작을 지원합니다. 사이드바를 정의할 때는 편집기 부가기능 스타일 가이드라인을 참고하세요.

  2. 사이드바를 열려는 서버 측 코드에서 다음을 호출합니다. HtmlService.createHtmlOutputFromFile(filename) HtmlOutput 만들기 사이드바를 나타내는 객체입니다. 또는 kube-apiserver와 템플릿 HTML 템플릿을 HtmlService.createTemplateFromFile(filename) 템플릿을 생성하고 HtmlTemplate.evaluate() 그것을 HtmlOutput 객체를 사용합니다.

  3. Ui.showSidebar(htmlOutput)를 호출합니다. 사이드바를 표시하려면 HtmlOutput

사이드바는 열려 있는 동안 서버 측 스크립트를 정지하지 않습니다. 이 클라이언트 측 JavaScript는 서버 측에 비동기 호출을 할 수 있습니다. google.script.run() 및 관련 핸들러 함수를 정의합니다. 자세한 내용은 클라이언트 간 통신.