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

대부분의 편집기 부가기능의 경우 대화상자 창과 사이드바 패널은 기본 부가기능 사용자 인터페이스입니다. 둘 다 표준 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() 및 관련 핸들러 함수를 정의합니다. 자세한 내용은 클라이언트 간 통신.