Class HtmlOutput

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

Powrót

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

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

Powrót

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

Rzuty

Error – jeśli kod HTML jest nieprawidłowy

Zobacz też

• 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

Powrót

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

Rzuty

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

Zobacz też

• append(addedContent)

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.

Usuwa bieżącą zawartość.

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

Powrót

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

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

Powrót

Blob – dane w postaci obiektu blob.

Zwraca dane wewnątrz tego obiektu jako obiekt blob.

Powrót

Blob – dane w postaci obiektu blob.

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ść.

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.

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.

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

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.

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.

Ustawia zawartość tego elementu (HtmlOutput).

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

Parametry

Powrót

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

Rzuty

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

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

Powrót

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

Ustawia początkową wysokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze. Jeśli HtmlOutput została opublikowana jako aplikacja internetowa, ten tag 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

Powrót

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

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

Powrót

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

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

Powrót

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

Określa początkową szerokość okna niestandardowego w Google Dokumenty, Arkusze lub Formularze. Jeśli HtmlOutput została opublikowana jako aplikacja internetowa, ten tag 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

Powrót

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

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

Powrót

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