HTML Service

w kodzie HTML,

Ta usługa umożliwia aplikacjom Apps Script zwracanie kodu HTML, zwykle jako interfejsu użytkownika. Jeśli dopiero zaczynasz korzystać z tej klasy, zapoznaj się też z przewodnikiem po usłudze HTML.

.

Zajęcia

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

HtmlOutput

Metody

MetodaZwracany typKrótki opis
addMetaTag(name, content)HtmlOutputDodaje metatag do strony.
append(addedContent)HtmlOutputDołącza nowe treści do treści tego elementu HtmlOutput.
appendUntrusted(addedContent)HtmlOutputDołącza nowe treści do treści tego elementu HtmlOutput, używając ucieczki kontekstowej.
asTemplate()HtmlTemplateZwraca wartość HtmlTemplate obsługiwaną przez ten obiekt HtmlOutput.
clear()HtmlOutputCzyści bieżącą zawartość.
getAs(contentType)BlobZwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane w tym obiekcie jako obiekt blob.
getContent()StringPobiera zawartość tego elementu HtmlOutput.
getFaviconUrl()StringPobiera adres URL tagu linku do favikony dodanego do strony przez wywołanie funkcji setFaviconUrl(iconUrl).
getHeight()IntegerPobiera początkową wysokość niestandardowego okna dialogowego w Dokumentach, Arkuszach lub Formularzach Google.
getMetaTags()HtmlOutputMetaTag[]Pobiera tablicę obiektów reprezentujących metatagi dodane do strony przez wywołanie funkcji addMetaTag(name, content).
getTitle()StringPobiera tytuł strony wyjściowej.
getWidth()IntegerPobiera początkową szerokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setContent(content)HtmlOutputUstawia zawartość tego elementu HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputDodaje do strony tag linku do favikony.
setHeight(height)HtmlOutputUstawia początkową wysokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setSandboxMode(mode)HtmlOutputTa metoda nie ma już żadnego wpływu – wcześniej ustawiała wartość sandbox mode używaną w skryptach po stronie klienta.
setTitle(title)HtmlOutputUstawia tytuł strony wyjściowej.
setWidth(width)HtmlOutputUstawia początkową szerokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setXFrameOptionsMode(mode)HtmlOutputOkreśla stan nagłówka X-Frame-Options strony, który zapobiega kliknięciu w celu oszustwa.

HtmlOutputMetaTag

Metody

MetodaZwracany typKrótki opis
getContent()StringPobiera zawartość tego metatagu.
getName()StringPobiera nazwę tego HtmlOutputMetaTag.

HtmlService

Właściwości

WłaściwośćTypOpis
SandboxModeSandboxModeWyliczenie reprezentujące tryby piaskownicy, których można używać w przypadku skryptów HtmlService po stronie klienta.
XFrameOptionsModeXFrameOptionsModeWyliczenie reprezentujące X-Frame-Options tryby, które można stosować 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 przez skrypt.
createHtmlOutput(blob)HtmlOutputTworzy nowy obiekt HtmlOutput z zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.
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 przez skrypt.
createTemplateFromFile(filename)HtmlTemplateTworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu.
getUserAgent()StringPobiera ciąg znaków klienta użytkownika bieżącej przeglądarki.

HtmlTemplate

Metody

MetodaZwracany typKrótki opis
evaluate()HtmlOutputSprawdza ten szablon i zwraca obiekt HtmlOutput.
getCode()StringGeneruje ciąg kodu JavaScript na podstawie pliku szablonu, który można ocenić.
getCodeWithComments()StringGeneruje ciąg znaków kodu JavaScript, który można ocenić. Każdy wiersz kodu zawiera oryginalny wiersz z szablonu jako komentarz.
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, korzystając tylko z funkcji dostępnych w ECMAScript 3.
IFRAMEEnumTryb piaskownicy, który zamiast technologii piaskownicy Caja używanej w trybach EMULATEDNATIVE wykorzystuje piaskownicę iframe.
NATIVEEnumTryb piaskownicy oparty na trybie ścisłym ECMAScript 5.

XFrameOptionsMode

Właściwości

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