Ta strona została przetłumaczona przez Cloud Translation API.

Class HtmlOutput

Obiekt HtmlOutput, który może być wyświetlany ze skryptu. Ze względów bezpieczeństwa skrypty nie mogą bezpośrednio zwracać kodu HTML do przeglądarki. Zamiast tego muszą być oczyszczone, nie mogą wykonywać szkodliwych działań. Przetworzony kod HTML możesz zwrócić w ten sposób:

function doGet() {
  return HtmlService.createHtmlOutput('<b>Hello, world!</b>');
}

Kod w sekcji HtmlOutput może zawierać osadzony JavaScript i CSS. (To standard JavaScript po stronie klienta, który modyfikuje model DOM, a nie Apps Script). Wszystkie te treści w piaskownicy za pomocą iframe w piaskownicy. Więcej informacji znajdziesz w przewodniku po ograniczeniach w usłudze HTML.

Metody

Metoda	Zwracany typ	Krótki opis
`addMetaTag(name, content)`	`HtmlOutput`	Dodaje metatag do strony.
`append(addedContent)`	`HtmlOutput`	Dołącza nowe treści do treści tego elementu `HtmlOutput`.
`appendUntrusted(addedContent)`	`HtmlOutput`	Dołącza nowe treści do treści tego elementu `HtmlOutput` przy użyciu kontekstowego zmiany znaczenia.
`asTemplate()`	`HtmlTemplate`	Zwraca `HtmlTemplate` wspierany przez ten argument `HtmlOutput`.
`clear()`	`HtmlOutput`	Usuwa bieżącą zawartość.
`getAs(contentType)`	`Blob`	Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
`getBlob()`	`Blob`	Zwraca dane wewnątrz tego obiektu jako obiekt blob.
`getContent()`	`String`	Pobiera zawartość tego zasobu (`HtmlOutput`).
`getFaviconUrl()`	`String`	Pobiera adres URL tagu linku favikony dodanego do strony przez wywołanie metody `setFaviconUrl(iconUrl)`.
`getHeight()`	`Integer`	Pobiera początkową wysokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze.
`getMetaTags()`	`HtmlOutputMetaTag[]`	Pobiera tablicę obiektów reprezentujących metatagi dodane do strony przez wywołanie metody `addMetaTag(name, content)`.
`getTitle()`	`String`	Pobiera tytuł strony wyjściowej.
`getWidth()`	`Integer`	Pobiera początkową szerokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze.
`setContent(content)`	`HtmlOutput`	Ustawia zawartość tego elementu (`HtmlOutput`).
`setFaviconUrl(iconUrl)`	`HtmlOutput`	Dodaje do strony tag linku dla favikony.
`setHeight(height)`	`HtmlOutput`	Ustawia początkową wysokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze.
`setSandboxMode(mode)`	`HtmlOutput`	Ta metoda nie działa – poprzednio ustawiała właściwość `sandbox mode` używaną w przypadku skryptów po stronie klienta.
`setTitle(title)`	`HtmlOutput`	Ustawia tytuł strony wyjściowej.
`setWidth(width)`	`HtmlOutput`	Określa początkową szerokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze.
`setXFrameOptionsMode(mode)`	`HtmlOutput`	Ustawia stan nagłówka `X-Frame-Options` strony, który kontroluje przechwytywanie kliknięć profilaktyki.

Szczegółowa dokumentacja

`addMetaTag(name, content)`

Dodaje metatag do strony. Metatagi umieszczone bezpośrednio w pliku HTML Apps Script są zignorowano. Dozwolone są tylko te metatagi:

<meta name="apple-mobile-web-app-capable" content="..."/>
<meta name="google-site-verification" content="..."/>
<meta name="mobile-web-app-capable" content="..."/>
<meta name="viewport" content="..."/>

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

Parametry

Nazwa	Typ	Opis
`name`	`String`	Wartość atrybutu name tagu meta.
`content`	`String`	Wartość atrybutu content tagu meta.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

`append(addedContent)`

Dołącza nowe treści do treści tego elementu HtmlOutput. Używaj go tylko w przypadku treści z zaufanego źródła, ponieważ nie ma on znaczenia.

// Log "<b>Hello, world!</b><p>Hello again, world.</p>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.append('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Parametry

Nazwa	Typ	Opis
`addedContent`	`String`	Treść do dołączenia.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

Rzuty

Error – jeśli kod HTML jest nieprawidłowy.

Zobacz też

appendUntrusted(addedContent)

`appendUntrusted(addedContent)`

Dołącza nowe treści do treści tego elementu HtmlOutput przy użyciu kontekstowego zmiany znaczenia.

Ta metoda prawidłowo zmienia znaczenie treści na podstawie bieżącego stanu obiektu HtmlOutput, aby uzyskać bezpieczny ciąg znaków bez znaczników i elementów dodatkowych. Używaj zamiast dołączaj przy każdym dodawaniu treści z niezaufanego źródła, np. od użytkownika, aby uniknąć przypadkowe zezwalanie na błąd typu cross-site scripting (XSS), który powoduje dodanie dodanych treści lub znaczników. powoduje nieoczekiwane uruchomienie kodu.

// Log "<b>Hello, world!</b>&lt;p&gt;Hello again, world.&lt;/p&gt;"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.appendUntrusted('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Parametry

Nazwa	Typ	Opis
`addedContent`	`String`	Treść do dołączenia.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

Rzuty

Error – jeśli kod HTML jest bardzo nieprawidłowy

Zobacz też

append(addedContent)

`asTemplate()`

Zwraca HtmlTemplate wspierany przez ten argument HtmlOutput. Można jej używać do: tworzyć szablony stopniowo. Przyszłe zmiany w usłudze HtmlOutput będą miały wpływ na zawartość tych usług: HtmlTemplate.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
var template = output.asTemplate();

Powrót

HtmlTemplate – nowe HtmlTemplate.

`clear()`

Usuwa bieżącą zawartość.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.clear();

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

`getAs(contentType)`

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ten dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME do skonwertowania. W przypadku większości blobów atrybut `'application/pdf'` to jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnego z tych atrybutów: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` lub `'image/png'`. prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość `'text/markdown'`.

Powrót

Blob – dane w postaci obiektu blob.

`getBlob()`

Zwraca dane wewnątrz tego obiektu jako obiekt blob.

Powrót

Blob – dane w postaci obiektu blob.

`getContent()`

Pobiera zawartość tego zasobu (HtmlOutput).

// Log "<b>Hello, world!</b>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getContent());

Powrót

String – wyświetlana treść.

`getFaviconUrl()`

Pobiera adres URL tagu linku favikony dodanego do strony przez wywołanie metody setFaviconUrl(iconUrl). Tagi linku favikony umieszczone bezpośrednio w pliku HTML Apps Script są zignorowano.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

Powrót

String – adres URL favikony.

`getHeight()`

Pobiera początkową wysokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze. Jeśli HtmlOutput została opublikowana jako aplikacja internetowa, ten zwraca wartość null. Aby zmienić rozmiar okna, które jest już otwarte, wywołaj google.script.host.setHeight(height) w kodzie po stronie klienta.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);
Logger.log(output.getHeight());

Powrót

Integer – wysokość w pikselach.

`getMetaTags()`

Pobiera tablicę obiektów reprezentujących metatagi dodane do strony przez wywołanie metody addMetaTag(name, content). Metatagi umieszczone bezpośrednio w pliku HTML Apps Script są zignorowano.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

var tags = output.getMetaTags();
Logger.log('<meta name="%s" content="%s"/>', tags[0].getName(), tags[0].getContent());

Powrót

HtmlOutputMetaTag[] – tablica obiektów reprezentujących metatagi dodanych do strony przez wywołanie addMetaTag(name, content).

`getTitle()`

Pobiera tytuł strony wyjściowej. Pamiętaj, że w tagu <title> Element HTML jest ignorowany.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getTitle());

Powrót

String – tytuł strony.

`getWidth()`

Pobiera początkową szerokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze. Jeśli HtmlOutput została opublikowana jako aplikacja internetowa, ten zwraca wartość null. Aby zmienić rozmiar okna, które jest już otwarte, wywołaj google.script.host.setWidth(width) w kodzie po stronie klienta.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);
Logger.log(output.getWidth());

Powrót

Integer – szerokość w pikselach.

`setContent(content)`

Ustawia zawartość tego elementu (HtmlOutput).

var output = HtmlService.createHtmlOutput();
output.setContent('<b>Hello, world!</b>');

Parametry

Nazwa	Typ	Opis
`content`	`String`	Treść do wyświetlenia.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

Rzuty

Error – jeśli kod HTML jest nieprawidłowy.

`setFaviconUrl(iconUrl)`

Dodaje do strony tag linku dla favikony. Tagi linku do favikony dołączane bezpośrednio do aplikacji Plik HTML skryptu są ignorowane.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');

Parametry

Nazwa	Typ	Opis
`iconUrl`	`String`	Adres URL favikony, przy czym rozszerzenie graficzne wskazuje obraz typu.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

`setHeight(height)`

Ustawia początkową wysokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze. Jeśli HtmlOutput została opublikowana jako aplikacja internetowa, ten nie ma żadnego efektu. Aby zmienić rozmiar okna, które jest już otwarte, wywołaj google.script.host.setHeight(height) w kodzie po stronie klienta.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);

Parametry

Nazwa	Typ	Opis
`height`	`Integer`	Nowa wysokość w pikselach; `null` zwraca wartość domyślną.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

`setSandboxMode(mode)`

Ta metoda nie działa – poprzednio ustawiała właściwość sandbox mode używaną w przypadku skryptów po stronie klienta. aby chronić użytkowników przed złośliwym kodem HTML lub JavaScript, kod po stronie klienta udostępniany z usługi HTML jest wykonywany w bezpiecznej piaskownicy, nakłada ograniczenia na kod. Początkowo ta metoda umożliwiała autorom skryptów wybór między różnymi wersjami piaskownicy, ale teraz wszystkie skrypty korzystają teraz z trybu IFRAME bez względu na ustawiony tryb piaskownicy. Więcej informacji znajdziesz w przewodniku po ograniczeniach w usłudze HTML.

Tryb IFRAME nakłada o wiele mniej ograniczeń niż pozostałe tryby piaskownicy. działa najszybciej, ale nie działa w niektórych starszych przeglądarkach, w tym Internet Explorerze. 9. Tryb piaskownicy można odczytać w skrypcie po stronie klienta, sprawdzając google.script.sandbox.mode. Zwróć uwagę, że ta właściwość zwraca rzeczywisty tryb klienta, który może się różnić od trybu żądanego przez serwer, jeśli żądany tryb nie jest obsługiwany. w przeglądarce użytkownika.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Parametry

Nazwa	Typ	Opis
`mode`	`SandboxMode`	Tryb piaskownicy, który ma być używany.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

`setTitle(title)`

Ustawia tytuł strony wyjściowej. W przypadku aplikacji internetowych jest to tytuł całej strony, a jest to tytuł okna dialogowego dla dokumentu HtmlOutput.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setTitle('My First Page');

Parametry

Nazwa	Typ	Opis
`title`	`String`	Nowy tytuł.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

`setWidth(width)`

Określa początkową szerokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze. Jeśli HtmlOutput została opublikowana jako aplikacja internetowa, ten nie ma żadnego efektu. Aby zmienić rozmiar okna, które jest już otwarte, wywołaj google.script.host.setWidth(width) w kodzie po stronie klienta.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);

Parametry

Nazwa	Typ	Opis
`width`	`Integer`	Nowa szerokość w pikselach; `null` zwraca wartość domyślną.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.

`setXFrameOptionsMode(mode)`

Ustawia stan nagłówka X-Frame-Options strony, który kontroluje przechwytywanie kliknięć profilaktyki.

Jeśli zasada XFrameOptionsMode.ALLOWALL pozwala umieścić stronę w elemencie iframe, tag powinien wdrożyć własną ochronę przed przechwytywaniem kliknięć.

Jeśli skrypt nie ustawia trybu X-Frame-Options, Apps Script domyślnie używa trybu XFrameOptionsMode.DEFAULT.

// Serve HTML with no X-Frame-Options header (in Apps Script server-side code).
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);

Parametry

Nazwa	Typ	Opis
`mode`	`XFrameOptionsMode`	Tryb opcji XFrame do ustawienia.

Powrót

HtmlOutput – dane wyjściowe do łańcuchów.