Class HtmlService

HtmlService

Usługa zwracająca kod HTML i inne treści tekstowe ze skryptu.

Ze względów bezpieczeństwa skrypty nie mogą bezpośrednio zwracać treści do przeglądarki. Zamiast tego muszą oczyścić kod HTML, aby nie mógł wykonywać szkodliwych działań. Zapoznaj się z opisem HtmlOutput, aby dowiedzieć się, jakie ograniczenia to nakłada na zwracane wartości.

Właściwości

Właściwość	Typ	Opis
SandboxMode	SandboxMode	Wyliczenie reprezentujące tryby piaskownicy, których można używać w przypadku skryptów HtmlService po stronie klienta.
XFrameOptionsMode	XFrameOptionsMode	Wyliczenie reprezentujące X-Frame-Options tryby, które można stosować w przypadku skryptów HtmlService po stronie klienta.

Metody

Metoda	Zwracany typ	Krótki opis
createHtmlOutput()	HtmlOutput	Tworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.
createHtmlOutput(blob)	HtmlOutput	Tworzy nowy obiekt HtmlOutput z zasobu BlobSource.
createHtmlOutput(html)	HtmlOutput	Tworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.
createHtmlOutputFromFile(filename)	HtmlOutput	Tworzy nowy obiekt HtmlOutput z pliku w edytorze kodu.
createTemplate(blob)	HtmlTemplate	Tworzy nowy obiekt HtmlTemplate z zasobu BlobSource.
createTemplate(html)	HtmlTemplate	Tworzy nowy obiekt HtmlTemplate, który może zostać zwrócony przez skrypt.
createTemplateFromFile(filename)	HtmlTemplate	Tworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu.
getUserAgent()	String	Pobiera ciąg znaków klienta użytkownika bieżącej przeglądarki.

Szczegółowa dokumentacja

createHtmlOutput()

Tworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.

const output = HtmlService.createHtmlOutput();

Powrót

HtmlOutput – nowy obiekt HtmlOutput

---

createHtmlOutput(blob)

Tworzy nowy obiekt HtmlOutput z zasobu BlobSource.

function createFromBlob(blob) {
  const output = HtmlService.createHtmlOutput(blob);
  return output;
}

Parametry

Nazwa	Typ	Opis
blob	BlobSource	obiekt, z którego ma zostać wygenerowany kod HTML.

Powrót

HtmlOutput – nowy obiekt HtmlOutput.

Rzuty

Error – jeśli obiekt blob nie zawiera kodu HTML lub jest on nieprawidłowy.

---

createHtmlOutput(html)

Tworzy nowy obiekt HtmlOutput, który może zostać zwrócony przez skrypt.

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

Parametry

Nazwa	Typ	Opis
html	String	treści do wyświetlenia,

Powrót

HtmlOutput – nowy obiekt HtmlOutput

Rzuty

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

---

createHtmlOutputFromFile(filename)

Tworzy nowy obiekt HtmlOutput z pliku w edytorze kodu.

const output = HtmlService.createHtmlOutputFromFile('myPage');

Parametry

Nazwa	Typ	Opis
filename	String	nazwa pliku do użycia.

Powrót

HtmlOutput – nowy obiekt HtmlOutput.

Rzuty

Error – jeśli nie znaleziono pliku lub kod HTML w nim jest nieprawidłowy.

---

createTemplate(blob)

Tworzy nowy obiekt HtmlTemplate z zasobu BlobSource.

function createFromBlob(blob) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

Parametry

Nazwa	Typ	Opis
blob	BlobSource	Obiekt, z którego ma zostać wyodrębniony kod HTML.

Powrót

HtmlTemplate – nowy obiekt HtmlTemplate.

Rzuty

Error – jeśli obiekt blob nie zawiera kodu HTML.

---

createTemplate(html)

Tworzy nowy obiekt HtmlTemplate, który może zostać zwrócony przez skrypt.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);

Parametry

Nazwa	Typ	Opis
html	String	zawartość szablonu,

Powrót

HtmlTemplate – nowy obiekt HtmlTemplate.

---

createTemplateFromFile(filename)

Tworzy nowy obiekt HtmlTemplate z pliku w edytorze kodu.

const template = HtmlService.createTemplateFromFile('myTemplate');

Parametry

Nazwa	Typ	Opis
filename	String	nazwa pliku do użycia.

Powrót

HtmlTemplate – nowy obiekt HtmlTemplate.

Rzuty

Error – jeśli nie znaleziono pliku.

---

getUserAgent()

Pobiera ciąg znaków klienta użytkownika bieżącej przeglądarki. Zwraca null w przypadku większości wykonań skryptu, jeśli nie jest używana w funkcji doGet() lub doPost() aplikacji internetowej.

Powrót

String – ciąg znaków klienta użytkownika.