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 Service.

.

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 metody HtmlOutput.addMetaTag(name, content).
HtmlServiceUsługa zwracająca kod HTML i inne treści tekstowe ze skryptu.
HtmlTemplateObiekt szablonu do dynamicznego tworzenia kodu HTML.
SandboxModeTyp enumeracji reprezentujący tryby piaskownicy, które można stosować w przypadku skryptów po stronie klienta HtmlService
XFrameOptionsModeTyp enumeracji reprezentujący tryby X-Frame-Options, które można stosować w skryptach HtmlService po stronie klienta.

HtmlOutput

Metody

MetodaZwracany typKrótki opis
addMetaTag(name, content)HtmlOutputDodaje metatag do strony.
append(addedContent)HtmlOutputDodaje nowe treści do treści tego HtmlOutput.
appendUntrusted(addedContent)HtmlOutputDodaje nowe treści do treści tego HtmlOutput, używając ucieczki kontekstowej.
asTemplate()HtmlTemplateZwraca HtmlTemplate, który jest obsługiwany przez tę HtmlOutput.
clear()HtmlOutputCzyści bieżące treści.
getAs(contentType)BlobZwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane z tego obiektu jako blob.
getContent()StringPobiera zawartość tego HtmlOutput.
getFaviconUrl()StringPobiera adres URL tagu linku do ikony favicon dodanego do strony przez wywołanie funkcji setFaviconUrl(iconUrl).
getHeight()IntegerPobiera początkową wysokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
getMetaTags()HtmlOutputMetaTag[]Pobiera tablicę obiektów, które reprezentują metatagi dodane do strony przez wywołanie funkcji addMetaTag(name, content).
getTitle()StringPobiera tytuł strony wyjściowej.
getWidth()IntegerPobiera początkową szerokość okna dialogowego niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setContent(content)HtmlOutputOkreśla zawartość tego HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputDodaje tag linku do ikony favicon na stronie.
setHeight(height)HtmlOutputOkreśla początkową wysokość okna niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setSandboxMode(mode)HtmlOutputTa metoda nie ma teraz ż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 dialogowego niestandardowego w Dokumentach, Arkuszach lub Formularzach Google.
setXFrameOptionsMode(mode)HtmlOutputUstawia stan nagłówka X-Frame-Options strony, który kontroluje zapobieganie atakom typu clickjacking.

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
SandboxModeSandboxModeTyp enumeracji reprezentujący tryby piaskownicy, które można stosować w przypadku skryptów po stronie klienta HtmlService
XFrameOptionsModeXFrameOptionsModeTyp enumeracji reprezentujący tryby X-Frame-Options, które można stosować w skryptach 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 na podstawie zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.
createHtmlOutputFromFile(filename)HtmlOutputTworzy nowy obiekt HtmlOutput na podstawie pliku w edytorze kodu.
createTemplate(blob)HtmlTemplateTworzy nowy obiekt HtmlTemplate na podstawie zasobu BlobSource.
createTemplate(html)HtmlTemplateTworzy nowy obiekt HtmlTemplate, który może zostać zwrócony przez skrypt.
createTemplateFromFile(filename)HtmlTemplateTworzy nowy obiekt HtmlTemplate na podstawie pliku w edytorze kodu.
getUserAgent()StringPobiera ciąg znaków klienta użytkownika w przypadku bieżącej przeglądarki.

HtmlTemplate

Metody

MetodaZwracany typKrótki opis
evaluate()HtmlOutputSprawdza ten szablon i zwraca obiekt HtmlOutput.
getCode()StringNa podstawie pliku szablonu generuje ciąg kodu JavaScript, który można ocenić.
getCodeWithComments()StringGeneruje ciąg kodu JavaScript, który można ocenić, a każda linia kodu zawiera pierwotną linię z szablonu jako komentarz.
getRawContent()StringZwraca nieprzetworzone treści 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 wykorzystuje piaskownicę iframe zamiast technologii piaskownicy Caja używanej w trybach EMULATED i NATIVE.
NATIVEEnumTryb piaskownicy oparty na ECMAScript 5 w trybie ścisłym.

XFrameOptionsMode

Właściwości

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