HTML Service

w kodzie HTML,

Ta usługa pozwala aplikacjom Apps Script na zwracanie kodu HTML, zwykle jako interfejs użytkownika. Jeśli nie masz doświadczenia w korzystaniu z tej klasy, zalecamy zapoznanie się z przewodnikiem po usłudze HTML

.

Zajęcia

NazwaKrótki opis
HtmlOutputObiekt HtmlOutput, który może być wyświetlany za pomocą skryptu.
HtmlOutputMetaTagObiekt reprezentujący metatag dodany do strony przez wywołanie metody HtmlOutput.addMetaTag(name, content).
HtmlServiceUsługa zwracająca kod HTML i inną treść tekstową ze skryptu.
HtmlTemplateObiekt szablonu do dynamicznego tworzenia kodu HTML.
SandboxModeWyliczenie reprezentujące tryby piaskownicy, które można używać w przypadku skryptów HtmlService po stronie klienta.
XFrameOptionsModeWyliczenie reprezentujące tryby X-Frame-Options, których można używać w przypadku skryptów HtmlService po stronie klienta.

HtmlOutput

Metody

MetodaZwracany typKrótki opis
addMetaTag(name, content)HtmlOutputDodaje metatag do strony.
append(addedContent)HtmlOutputDodaje nowe treści do zawartości: HtmlOutput.
appendUntrusted(addedContent)HtmlOutputDodaje nowe treści do treści tego elementu (HtmlOutput) przy użyciu kontekstowych zmian znaczenia.
asTemplate()HtmlTemplateZwraca wartość HtmlTemplate opartą na tej wartości HtmlOutput.
clear()HtmlOutputUsuwa bieżącą zawartość.
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwracaj dane wewnątrz tego obiektu jako obiekt blob.
getContent()StringPobiera zawartość tego urządzenia HtmlOutput.
getFaviconUrl()StringPobiera adres URL tagu linku favikony dodanego do strony przez wywołanie setFaviconUrl(iconUrl).
getHeight()IntegerPobiera początkową wysokość niestandardowego okna w Dokumentach, Arkuszach lub Formularzach Google.
getMetaTags()HtmlOutputMetaTag[]Pobiera tablicę obiektów, które reprezentują metatagi dodane do strony przez wywołanie addMetaTag(name, content).
getTitle()StringPobiera tytuł strony wyjściowej.
getWidth()IntegerPobiera początkową szerokość niestandardowego okna w Dokumentach, Arkuszach lub Formularzach Google.
setContent(content)HtmlOutputUstawia treść: HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputDodaje do strony tag linku favikony.
setHeight(height)HtmlOutputUstawia początkową wysokość niestandardowego okna w Dokumentach, Arkuszach i Formularzach Google.
setSandboxMode(mode)HtmlOutputTa metoda nie działa już – wcześniej ustawiała ustawienie sandbox mode używane na potrzeby skryptów po stronie klienta.
setTitle(title)HtmlOutputUstawia tytuł strony wyjściowej.
setWidth(width)HtmlOutputOkreśla początkową szerokość niestandardowego okna w Dokumentach, Arkuszach lub Formularzach Google.
setXFrameOptionsMode(mode)HtmlOutputUstawia stan nagłówka X-Frame-Options strony, który kontroluje zapobieganie przechwytywaniu kliknięć.

HtmlOutputMetaTag

Metody

MetodaZwracany typKrótki opis
getContent()StringPobiera zawartość tego tagu meta.
getName()StringPobiera nazwę tego elementu: HtmlOutputMetaTag.

HtmlService

Właściwości

WłaściwośćTypOpis
SandboxModeSandboxModeWyliczenie reprezentujące tryby piaskownicy, które można używać w przypadku skryptów HtmlService po stronie klienta.
XFrameOptionsModeXFrameOptionsModeWyliczenie reprezentujące tryby X-Frame-Options, których można używać w przypadku skryptów HtmlService po stronie klienta.

Metody

MetodaZwracany typKrótki opis
createHtmlOutput()HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony ze skryptu.
createHtmlOutput(blob)HtmlOutputTworzy nowy obiekt HtmlOutput z zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony ze skryptu.
createHtmlOutputFromFile(filename)HtmlOutputTworzy nowy obiekt HtmlOutput z pliku w edytorze kodu.
createTemplate(blob)HtmlTemplateTworzy nowy obiekt HtmlTemplate z zasobu BlobSource.
createTemplate(html)HtmlTemplateTworzy nowy obiekt HtmlTemplate, który może zostać zwrócony ze skryptu.
createTemplateFromFile(filename)HtmlTemplateTworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu.
getUserAgent()StringPobiera ciąg klienta użytkownika dla bieżącej przeglądarki.

HtmlTemplate

Metody

MetodaZwracany typKrótki opis
evaluate()HtmlOutputAnalizuje ten szablon i zwraca obiekt HtmlOutput.
getCode()StringGeneruje na podstawie pliku szablonu ciąg kodu JavaScript, który można sprawdzić.
getCodeWithComments()StringGeneruje ciąg kodu JavaScript, który można ocenić. Każdy wiersz kodu będzie zawierać w postaci komentarza oryginalny wiersz z szablonu.
getRawContent()StringZwraca nieprzetworzoną zawartość tego szablonu.

SandboxMode

Właściwości

WłaściwośćTypOpis
EMULATEDEnumStarszy tryb piaskownicy, który emuluje tryb ścisły ECMAScript 5, używając tylko funkcji dostępnych w ECMAScript 3.
IFRAMEEnumTryb piaskownicy, w którym używa się piaskownicy iframe zamiast technologii piaskownicy Caja używanej w trybach EMULATED i NATIVE.
NATIVEEnumTryb piaskownicy oparty na trybie ścisłym ECMAScript 5.

XFrameOptionsMode

Właściwości

WłaściwośćTypOpis
ALLOWALLEnumNie zostanie ustawiony żaden nagłówek X-Frame-Options.
DEFAULTEnumUstawia wartość domyślną nagłówka X-Frame-Options, która zachowuje normalne założenia dotyczące zabezpieczeń.