HTML Service

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ć obsługiwany przez skrypt.
HtmlOutputMetaTagObiekt reprezentujący metatag dodany do strony przez wywołanie HtmlOutput.addMetaTag(name, content).
HtmlServiceUsługa do zwracania kodu HTML i innej treści tekstowej ze skryptu.
HtmlTemplateObiekt szablonu do dynamicznego tworzenia kodu HTML.
SandboxModeWyliczenie reprezentujące tryby piaskownicy, których można używać w skryptach HtmlService po stronie klienta.
XFrameOptionsModeWyliczenie reprezentujące tryby X-Frame-Options, których można używać w skryptach HtmlService po stronie klienta.

HtmlOutput

Metody

MetodaZwracany typKrótki opis
addMetaTag(name, content)HtmlOutputDodaje do strony metatag.
append(addedContent)HtmlOutputDołącza nową treść do treści tego obiektu HtmlOutput.
appendUntrusted(addedContent)HtmlOutputDołącza nową treść do treści tego obiektu HtmlOutput, używając kontekstowego ucieczki.
asTemplate()HtmlTemplateZwraca obiekt HtmlTemplate obsługiwany przez ten obiekt HtmlOutput.
clear()HtmlOutputCzyści bieżącą treść.
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 treść tego obiektu HtmlOutput.
getFaviconUrl()StringPobiera adres URL tagu linku favicon 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 reprezentujących 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ść tego obiektu HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputDodaje do strony tag linku do favicon.
setHeight(height)HtmlOutputUstawia początkową wysokość niestandardowego okna w Dokumentach, Arkuszach lub Formularzach Google.
setSandboxMode(mode)HtmlOutputTa metoda nie ma teraz żadnego efektu – wcześniej ustawiała sandbox mode używany w skryptach po stronie klienta.
setTitle(title)HtmlOutputUstawia tytuł strony wyjściowej.
setWidth(width)HtmlOutputUstawia 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 kliknięciom.

HtmlOutputMetaTag

Metody

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

HtmlService

Właściwości

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

Metody

MetodaZwracany typKrótki opis
createHtmlOutput()HtmlOutputTworzy nowy obiekt HtmlOutput, który może być zwracany przez skrypt.
createHtmlOutput(blob)HtmlOutputTworzy nowy HtmlOutput obiekt z zasobu BlobSource.
createHtmlOutput(html)HtmlOutputTworzy nowy obiekt HtmlOutput, który może być zwracany przez skrypt.
createHtmlOutputFromFile(filename)HtmlOutputTworzy nowy obiekt HtmlOutput z pliku w edytorze kodu.
createTemplate(blob)HtmlTemplateTworzy nowy HtmlTemplate obiekt z zasobu BlobSource.
createTemplate(html)HtmlTemplateTworzy nowy obiekt HtmlTemplate, który może być zwracany 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()HtmlOutputOcenia ten szablon i zwraca obiekt HtmlOutput.
getCode()StringGeneruje ciąg znaków 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ą treść 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, który zamiast technologii piaskownicy Caja używanej w trybach EMULATED i NATIVE używa piaskownicy iframe.
NATIVEEnumTryb piaskownicy, który jest oparty na trybie ścisłym ECMAScript 5.

XFrameOptionsMode

Właściwości

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