Dokumentacja języka JavaScript dotycząca gadżetów

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

W tym dokumencie opisujemy klasy i metody w przestrzeni nazw gadgets.*, niektóre z określonych funkcji. Więcej informacji o uwzględnianiu funkcji znajdziesz w specyfikacji gadżetów.

Konwenty typów

W tym dokumencie obowiązują następujące konwencje dotyczące typów:

Tablica<T> lub Tablica.<T>
Tablica zawierająca tylko obiekty typu T. Ta konwencja jest podobna do ogólnych zasad języka Java.
Mapa<K, V> lub Mapa&&;K, V>
Obiekt JavaScript z kluczami typu K, które mapują wartości na typ V. Taka konwencja jest podobna do ogólnych zasad Java. Jest często używany w przypadku zmiennych opt_params.
statyczne
Typ oznaczony za pomocą klasy statycznej nie ma konstruktora publicznego ani prywatnego. Inaczej mówiąc, typ to przestrzeń nazw, a nie klasa, w której można utworzyć instancje. Pola i funkcje tego typu są również oznaczone jako statyczne.
Wartość logiczna
Wartość logiczna (nie obiekt Boolean).
Ciąg znaków
Wartość ciągu (nie obiekt String).

Powrót do góry

Class Attributes.MiniWiadomość

Klasa MiniMessage używana do tworzenia wiadomości wyświetlanych użytkownikowi. Typowe przypadki użycia:

  • Komunikaty o stanie – wczytywanie, zapisywanie itp.
  • Wiadomości promocyjne – nowe funkcje, nowy gadżet itp.
  • Komunikaty o błędach lub debugowaniu – nieprawidłowe dane wejściowe, nieudane połączenie z serwerem itp.

Podsumowanie konstruktora

gadgets.MiniMessage(opt_moduleId, opt_container)
Tworzy miniwiadomość.
 

Podsumowanie metod

 HTMLElement createDismissibleMessage(message, opt_callback)
Tworzy wiadomość możliwą do zamknięcia z ikoną [x], która umożliwia użytkownikom zamknięcie wiadomości.
 HTMLElement createStaticMessage(message)
Tworzy wiadomość statyczną, którą można zamknąć tylko automatycznie (przez wywołanie metody exitMessage()).
 HTMLElement createTimerMessage(message, seconds, opt_callback)
Tworzy komunikat wyświetlany przez określoną liczbę sekund.
dismissMessage(message)
Zamyka określoną wiadomość.
 

Szczegóły konstruktora

Gadżety.MiniWiadomość

gadgets.MiniMessage(opt_moduleId, opt_container)
    Utworzy miniwiadomość.
    Parametry:
      String opt_moduleId – opcjonalny identyfikator modułu
      HTMLElement opt_container – opcjonalny element kontenera HTML, na którym występują

Szczegóły metody

createOdrzućibleMessage

HTMLElement createDismissibleMessage(message, opt_callback)
    Tworzy wiadomość możliwą do zamknięcia z ikoną [x], która umożliwia użytkownikom zamknięcie wiadomości. Po odrzuceniu wiadomości jest ona usuwana z interfejsu DOM i wywoływana jest opcjonalna funkcja wywołania zwrotnego.
    Parametry:
      String, Object message – wiadomość jako ciąg HTML lub element DOM
      Function opt_callback – opcjonalna funkcja wywołania zwrotnego, która ma być wywoływana po odrzuceniu wiadomości
    Zwraca:
      HTMLElement  element HTML utworzonej wiadomości

createStaticMessage

HTMLElement createStaticMessage(message)
    Tworzy wiadomość statyczną, którą można zamknąć tylko automatycznie (wywołując metodę exitMessage()).
    Parametry:
      String, Object message – wiadomość jako ciąg HTML lub element DOM
    Zwraca:
      HTMLElement  element HTML utworzonej wiadomości

createTimerMessage

HTMLElement createTimerMessage(message, seconds, opt_callback)
    Utworzy wiadomość wyświetlaną przez określoną liczbę sekund. Po upływie ustalonego czasu wiadomość zostaje zamknięta, a opcjonalna funkcja wywołania zwrotnego jest wykonywana.
    Parametry:
      String, Object message String, Object message

      Odrzuć wiadomość

      dismissMessage(message)
        Zamyka określoną wiadomość.
        Parametry:
          HTMLElement message – element HTML wiadomości do usunięcia

      Powrót do góry

      Class Attributes.Prefs

      Zapewnia dostęp do ustawień użytkownika, wymiarów modułów i wiadomości. Klienci mogą uzyskać dostęp do swoich preferencji, tworząc instancję gadżetu.Pref i przekazujący identyfikator modułu. Przykład:

      var prefs = new gadgets.Prefs();
      var name = prefs.getString("name");
      var lang = prefs.getLang();

      Podsumowanie konstruktora

      gadgets.Prefs(opt_moduleId)
      Utworzy nowy obiekt prefs.
       

      Podsumowanie metod

       Array.<String> getArray(key)
      Pobiera preferencje jako tablicę.
       Boolean getBool(key)
      Pobiera preferencje jako wartość logiczną.
       String getCountry()
      Pobiera bieżący kraj i zwraca kod ISO 3166-1 alfa-2.
       Number getFloat(key)
      Pobiera preferencje jako wartość zmiennoprzecinkową.
       Number getInt(key)
      Pobiera preferencje jako liczbę całkowitą.
       String getLang()
      Pobiera bieżący język, który powinien być używany przez gadżet podczas renderowania, jako kod języka ISO 639-1.
       String, Number getModuleId()
      Pobiera identyfikator modułu bieżącej instancji.
       String getMsg(key)
      Pobiera niesformatowaną wiadomość.
       String getString(key)
      Pobiera preferencje w postaci ciągu znaków.
      set(key, val)
      Zapisuje preferencje.
      setArray(key, val)
      Zapisuje ustawienie tablicy.
       

      Szczegóły konstruktora

      Gadżety.Prefs

      gadgets.Prefs(opt_moduleId)
        Utworzy nowy obiekt Prefs.
        Parametry:
          String, Number opt_moduleId – opcjonalny parametr określający identyfikator modułu, dla którego mają być określone ustawienia. Jeśli nie zostanie podany, używany jest domyślny identyfikator modułu

      Szczegóły metody

      getArray

      Array.<String> getArray(key)
        Pobiera preferencje jako tablicę. Wartości UserPref, które nie zostały zadeklarowane jako listy, są traktowane jako tablice jednoelementowe.
        Parametry:
          String key – preferencje dotyczące pobierania
        Zwraca:
          Array.<String>  – jeśli nie jest skonfigurowana, pusta tablica

      getBool

      Boolean getBool(key)
        Pobiera preferencje jako wartość logiczną.
        Parametry:
          String key – preferencje dotyczące pobierania
        Zwraca:
          Boolean  Ustawienie; jeśli nie jest ustawione,

      getCountry

      String getCountry()
        Pobieram bieżący kraj jako kod ISO 3166-1 alfa-2.
        Zwraca:
          String  Kraj instancji tego modułu

      getFloat

      Number getFloat(key)
        Pobiera preferencje jako wartość zmiennoprzecinkową.
        Parametry:
          String key - Preferencje dotyczące pobierania
        Zwraca:
          Number  Ustawienie; 0

      GetInt

      Number getInt(key)
        Pobiera preferencje jako liczbę całkowitą.
        Parametry:
          String key - Preferencje dotyczące pobierania
        Zwraca:
          Number  Ustawienie; 0

      GetLang

      String getLang()
        Pobiera bieżący język, który powinien być używany przez szablon podczas renderowania, jako kod języka ISO 639-1.
        Zwraca:
          String  Język instancji tego modułu

      identyfikator_modułu

      String, Number getModuleId()
        Pobiera identyfikator modułu dla bieżącej instancji.
        Zwraca:
          String, Number  Identyfikator modułu dla tego instancji

      GetMsg

      String getMsg(key)
        Pobiera niesformatowany komunikat.
        Parametry:
          String key – wiadomość do pobrania
        Zwraca:
          String  Wiadomość

      getString

      String getString(key)
        Pobiera preferencje w postaci ciągu znaków.
        Parametry:
          String key – preferencje dotyczące pobierania
        Zwraca:
          String  – jeśli nie jest skonfigurowana, pusty ciąg znaków

      Ustaw

      set(key, val)
        Zapisuje ustawienie. Aby można było użyć tego wywołania, gadżet musi być ustawiony na poziomie funkcji.

        Uwaga: jeśli widżet musi przechowywać tablicę, powinien użyć metody setArray zamiast tego wywołania.

        Parametry:
          String key – preferencje dotyczące sklepu
          Object val – wartości do zapisania

      setArray

      setArray(key, val)
        Zapisuje ustawienie tablicy. Aby można było użyć tego wywołania, gadżet musi być ustawiony na poziomie funkcji.
        Parametry:
          String key – preferencje dotyczące sklepu
          Array val – wartości do zapisania

      Powrót do góry

      Class Attributes.Tab

      Klasa karty dla gadżetów. Karty możesz tworzyć, korzystając z metody TabSet addTab(). Aby pobrać obiekty Tab, użyj metod tabSet getSelectedTab() lub getTabs().

      Zobacz też: TabSet

      Podsumowanie metod

       Function getCallback()
      Zwraca funkcję wywołania zwrotnego, która została wykonana po wybraniu karty.
       HTMLElement getContentContainer()
      Zwraca element HTML, w którym jest renderowana zawartość karty.
       Number getIndex()
      Zwraca indeks karty.
       String getName()
      Zwraca etykietę karty jako ciąg znaków (może zawierać kod HTML).
       HTMLElement getNameContainer()
      Zwraca element HTML zawierający etykietę tabulacji.
       

      Szczegóły metody

      oddzwonienie

      Function getCallback()
        Zwraca funkcję wywołania zwrotnego, która została wykonana po wybraniu karty.
        Zwraca:
          Function  Funkcja wywołania zwrotnego karty

      getContentContainer

      HTMLElement getContentContainer()
        Zwraca element HTML, w którym jest renderowana treść karty.
        Zwraca:
          HTMLElement  Element HTML kontenera treści

      getIndex

      Number getIndex()
        Zwraca indeks karty.
        Zwraca:
          Number  Indeks karty

      getName

      String getName()
        Zwraca etykietę karty jako ciąg znaków (może zawierać kod HTML).
        Zwraca:
          String  Etykieta karty

      getNameContainer

      HTMLElement getNameContainer()
        Zwraca element HTML zawierający etykietę tabulatora.
        Zwraca:
          HTMLElement  Element HTML karty na karcie

      Powrót do góry

      Class rozmieszczanie.TabSet

      Gadżety klas mogą służyć do tworzenia kart.

      Podsumowanie konstruktora

      gadgets.TabSet(opt_moduleId, opt_defaultTab, opt_container)
      Tworzy nowy obiekt TabSet

      Podsumowanie metod

       String addTab(tabName, opt_params)
      Dodaje nową kartę na podstawie par nazwa-wartość określonych w parametrze opt_params.
      alignTabs(align, opt_offset)
      Ustawia wyrównanie kart.
      displayTabs(display)
      Pokazuje lub ukrywa karty oraz całą powiązaną treść.
       HTMLElement getHeaderContainer()
      Zwraca element kontenera nagłówków kart.
       gadgets.Tab getSelectedTab()
      Zwraca obecnie wybrany obiekt karty.
       Array.<gadgets.Tab> getTabs()
      Zwraca tablicę wszystkich istniejących obiektów kart.
      removeTab(tabIndex)
      Usuwa kartę w tabIndex oraz całą powiązaną z nią treść.
      setSelectedTab(tabIndex)
      Wybiera kartę w indeksie i uruchamia funkcję wywołania zwrotnego tabulacji, jeśli istnieje.
      swapTabs(tabIndex1, tabIndex2)
      Zamienia pozycja kart na kartach tabIndex1 i tabIndex2.
       

      Szczegóły konstruktora

      Gadżety.TabSet

      gadgets.TabSet(opt_moduleId, opt_defaultTab, opt_container)
        Tworzy nowy obiekt TabSet
        Parametry:
          String opt_moduleId – opcjonalny sufiks identyfikatora kontenera karty.
          String opt_defaultTab – opcjonalna nazwa karty, która została wybrana po zainicjowaniu. Jeśli pominięto ten parametr, domyślnie wybrana jest karta
            ; {1 to
              .
                :}

                Szczegóły metody

                dodaj kartę

                String addTab(tabName, opt_params)
                  Dodaje nową kartę na podstawie par nazwa-wartość określonych w Opt_params. W parametrze Opt_params obsługiwane są te właściwości:
                  kontener treści
                  Istniejący element HTML, który ma być używany jako kontener zawartości karty. Jeśli ją pominiesz, biblioteka kart utworzy ją.
                  wywołanie zwrotne
                  Funkcja wywołania zwrotnego, która ma zostać wykonana po wybraniu karty.
                  etykietka
                  Opis etykietki, który pojawia się, gdy użytkownik najedzie na kartę kursorem.
                  index
                  Indeks, w którym należy wstawić kartę. Jeśli ją pominiesz, nowa karta zostanie dołączona na końcu.
                  Parametry:
                    String tabName – etykieta karty do utworzenia
                    Object opt_params – opcjonalny obiekt parametru
                  Zwraca:
                    String  identyfikator DOM kontenera karty

                Wyrównanie kart

                alignTabs(align, opt_offset)
                  Ustawia wyrównanie kart. Karty są domyślnie wyśrodkowane.
                  Parametry:
                    String align - ' w lewo i #

                    wyświetlaczeTab

                    displayTabs(display)
                      Pokazuje lub ukrywa karty wraz ze wszystkimi powiązanymi treściami.
                      Parametry:
                        Boolean display – true, aby wyświetlić karty; false, aby ukryć karty

                    getHeaderContainer

                    HTMLElement getHeaderContainer()
                      Zwraca element kontenera nagłówków kart.
                      Zwraca:
                        HTMLElement  Element kontenera nagłówków nagłówków

                    getSelectedTab

                    gadgets.Tab getSelectedTab()
                      Zwraca aktualnie wybrany obiekt karty.
                      Zwraca:
                        gadgets.Tab  Aktualnie wybrany obiekt na karcie

                    getTabs

                    Array.<gadgets.Tab> getTabs()
                      Zwraca tablicę wszystkich istniejących obiektów kart.
                      Zwraca:
                        Array.<gadgets.Tab>  Tablica ze wszystkimi istniejącymi obiektami karty

                    UsuńTab

                    removeTab(tabIndex)
                      Usuwa kartę w postaci tabIndex i całą powiązaną z nią treść.
                      Parametry:
                        Number tabIndex – indeks karty do usunięcia

                    setSelectedTab.

                    setSelectedTab(tabIndex)
                      Wybiera kartę w indeksie tabor i uruchamia funkcję wywołania zwrotnego tabulacji, jeśli istnieje. Jeśli karta jest już wybrana, wywołanie zwrotne nie jest uruchamiane.
                      Parametry:
                        Number tabIndex – indeks karty do wyboru

                    zamiana kart

                    swapTabs(tabIndex1, tabIndex2)
                      Zamienia pozycja kart na kartach tabIndex1 i tabIndex2. Wybrana karta nie ulegnie zmianie i nie zostaną wywołane żadne funkcje wywołania zwrotnego.
                      Parametry:
                        Number tabIndex1 – indeks pierwszej karty do zamiany
                        Number tabIndex2 – indeks karty Secnod do wymiany

                    Powrót do góry

                    Static Class Gadżet.Flash

                    Umieszczanie treści Flash w gadżetach.

                    Podsumowanie metod

                    <static>  Boolean embedCachedFlash()
                    Wstrzykuje plik Flash z pamięci podręcznej do drzewa DOM.
                    <static>  Boolean embedFlash(swfUrl, swfContainer, swfVersion, opt_params)
                    Wstrzykuje plik Flash do drzewa DOM.
                    <static>  Number getMajorVersion()
                    Wykrywa Flash Playera i jego główną wersję.
                     

                    Szczegóły metody

                    umieszczony z pamięci podręcznej Flash

                    <static> Boolean embedCachedFlash()
                      Wstawia plik Flash z pamięci podręcznej do drzewa DOM. Akceptuje te same parametry co gadżety widget.Flash.embeddedFlash.
                      Zwraca:
                        Boolean  Określa, czy wywołanie funkcji zostało zakończone

                    Umieść Flash

                    <static> Boolean embedFlash(swfUrl, swfContainer, swfVersion, opt_params)
                      Wstawia plik Flash do drzewa DOM.
                      Parametry:
                        String swfUrl - adres URL pliku
                      String, Object swfContainer - odniesienie do identyfikatora lub obiektu istniejącego elementu kontenera HTML
                      Number swfVersion - wymagana minimalna wersja odtwarzacza Flash Player
                      Object opt_params – opcjonalny obiekt, który może zawierać dowolny prawidłowy parametr HTML.
                {1// /1

                getMajorVersion

                <static> Number getMajorVersion()
                  Wykrywa odtwarzacz Flash i jego główną wersję.
                  Zwraca:
                    Number  Jeśli wersja Flash Playera nie jest obsługiwana

                Powrót do góry

                Static Class.io

                Udostępnia funkcje pobierania zdalnej treści.

                Podsumowanie metod

                <static>  String encodeValues(fields)
                Konwertuje obiekt wejściowy na ciąg danych zakodowany na potrzeby adresu URL.
                <static>  String getProxyUrl(url, opt_params)
                Pobiera wersję proxy przekazywanego adresu URL.
                <static> makeRequest(url, callback, opt_params)
                Pobiera treść z podanego adresu URL i przekazuje ją do funkcji wywołania zwrotnego.
                 

                Szczegóły metody

                kodowanie wartości

                <static> String encodeValues(fields)
                  Przekształca obiekt w ciąg znaków zakodowany na potrzeby adresu URL. (key=wartość&...)
                  Parametry:
                    Object fields – pola postów, które chcesz zakodować
                  Zwraca:
                    String  Przetworzone dane posta, w tym znak ampersand (&)

                getProxyUrl

                <static> String getProxyUrl(url, opt_params)
                  Pobiera wersję proxy przekazywanego adresu URL.
                  Parametry:
                    String url – adres URL, który służy do pobrania adresu URL serwera proxy
                    Map<String, String> opt_params – dodatkowe opcjonalne parametry do przekazywania żądania
                  Zwraca:
                    String  wersja adresu URL przesłaną przez serwer proxy
                }

                MakeRequest

                <static> makeRequest(url, callback, opt_params)
                  Pobiera treść z podanego adresu URL i przesyła ją do funkcji wywołania zwrotnego. Przykład:
                  var params = {};
                  params[gadgets.io.RequestParameters.CONTENT_TYPE] = gadgets.io.ContentType.TEXT;
                  gadgets.io.makeRequest(url, callback, params);
                  

                  Podpisana autoryzacja

                  Jeśli zasada opt_params[gadgets.io.RequestParameters.AUTHORIZATION] ma wartość gadgets.io.AuthorizationType.SIGNED, kontener musi potwierdzić tożsamość użytkownika na serwerze docelowym. Aby to zrobić, wykonaj te czynności:

                  1. Usunięcie parametrów żądania z nazwami zaczynającymi się od oauth, xoauth lub opensocial (wielkość liter nie jest rozróżniana).

                  2. Dodając do ciągu zapytania żądania te parametry:

                    identyfikator_społeczności
                    Opcjonalnie.
                    Identyfikator bieżącego przeglądającego, który pasuje do wartości getId() w obiekcie osoby przeglądającej.
                    identyfikator_właściciela_społeczności
                    Wymagane.
                    Identyfikator bieżącego właściciela, który pasuje do wartości getId() w obiekcie osoby właściciela.
                    Otwórz_aplikację_społecznościową
                    Wymagane.
                    Adres URL aplikacji, która przesłała żądanie. Kontenery mogą aliasy wielu adresów URL aplikacji w jednym kanonicznym adresie URL w przypadku, gdy aplikacja zmienia adresy URL.
                    identyfikator_społeczności_otwartej
                    Opcjonalnie.
                    Nieprzezroczysty identyfikator używany do rozróżniania wielu wystąpień tej samej aplikacji w jednym kontenerze. Jeśli kontener nie zezwala na wiele wystąpień tej samej aplikacji, ten parametr może zostać pominięty. Kombinacja opensocial_app_url i opensocial_instance_id jednoznacznie identyfikuje instancję aplikacji w kontenerze.
                    identyfikator_aplikacji_społecznościowej
                    Opcjonalnie.
                    Nieprzezroczysty identyfikator aplikacji, unikatowy dla danego kontenera. Kontenery, które chcą zachować zgodność wsteczną ze specyfikacją opensocial-0.7, mogą zawierać ten parametr.
                    xoauth_signature_publickey.
                    Opcjonalnie.
                    Nieprzezroczysty identyfikator klucza publicznego używany do podpisywania żądania. Ten parametr może być pomijany przez kontenery, które nie używają kluczy publicznych do podpisywania żądań, lub jeśli kontener umieszcza inne sposoby dystrybucji kluczy w miejscu docelowym żądania.
                  3. Podpisywanie otrzymanego żądania zgodnie z punktem 9 w specyfikacji OAuth.

                Zarządzanie kluczami widget.io.AuthorizationType.SIGNED

                Jeśli kontener używa kluczy publicznych do podpisywania żądań, może zdecydować się na używanie certyfikatów podpisanych samodzielnie lub certyfikatów podpisanych przez znany urząd certyfikacji. Jeśli kontener nie rozpowszechnia klucza podpisywania OAuth przez HTTPS, powinien użyć certyfikatu podpisanego przez dobrze znany urząd certyfikacji.

                Atrybut commonName certyfikatu powinien odpowiadać nazwie hosta serwera kontenera i powinien odpowiadać wartości parametru oauth_consumer_key określonego w żądaniu.

                Kontener powinien być dostępny do pobrania w znanej lokalizacji. Zalecana jest lokalizacja https://container-hostname/opensocial/certificates/xoauth_signature_publickeyvalue.

                Adresaci podpisanych żądań muszą potwierdzić, że podpis w żądaniu jest prawidłowy, a sygnatura czasowa żądania znajduje się w rozsądnym czasie. Zalecamy przedział czasu wynoszący 5 minut przed obecną godziną i po niej.

                Adresaci podpisanych żądań mogą używać parametrów oauth_consumer_key i xoauth_signature_publickey, aby automatycznie wykrywać, kiedy kontener wdraża nowe certyfikaty. Jeśli kontener wdraża certyfikaty w dobrze znanej lokalizacji, odbiorca może automatycznie pobrać nowy certyfikat. Adresaci, którzy automatycznie pobierają nowe certyfikaty, powinni buforować wyświetlone certyfikaty.

                Jeśli certyfikat kontenera nie został pobrany z https://container-hostname, odbiorca powinien najpierw sprawdzić, czy certyfikat jest podpisany przez znany urząd certyfikacji.

                Autoryzacja OAuth

                Jeśli opt_params[gadgets.io.RequestParameters.AUTHORIZATION] ma wartość gadgets.io.AuthorizationType.OAUTH, kontener musi używać protokołu OAuth, aby mieć dostęp do zasobu określonego w żądaniu. Może to wymagać, aby gadżet pobierał dane użytkownika, przekierowując go do usługodawcy.

                Dodatkowe parametry

                W opt_params można określić te dodatkowe parametry:

                widget.io.RequestParameters.OAUTH_SERVICE_NAME
                Pseudonim używany przez gadżet w odniesieniu do elementu OAuth <Service> ze specyfikacji XML. Jeśli nie określono inaczej, domyślnie jest używany "".
                widget.io.RequestParameters.OAUTH_TOKEN_NAME
                Pseudonim używany przez gadżetu w odniesieniu do tokena OAuth przyznającego dostęp do określonych zasobów. Jeśli nie podano tego argumentu, domyślnie jest on ustawiany na &". Na przykład token z dostępem do listy kontaktów może mieć nazwę tokena "contacts" aby można było korzystać z tokena listy kontaktów, a lista kontaktów z &kalendarza kontaktów.
                widget.io.RequestParameters.OAUTH_REQUEST_TOKEN
                Dostawca usług może być w stanie automatycznie udostępnić token za pomocą tokena żądania, który został wstępnie zatwierdzony dla dostępu do zasobu. Gadżet może używać tego tokena z parametrem OAUTH_REQUEST_TOKEN. Ten parametr jest opcjonalny.
                categories.io.RequestParameters.OAUTH_REQUEST_TOKEN_SECRET,
                Tajny klucz odpowiadający wstępnie zatwierdzonemu tokenowi żądania. Ten parametr jest opcjonalny.

                W przypadku użycia protokołu OAuth kontener powinien wykonać protokół OAuth w imieniu użytkownika gadżetu. Jeśli gadżet nie zarejestrował klucza klienta na potrzeby tego dostawcy usług, do podpisywania żądań można użyć domyślnego klucza podpisywania RSA odpowiadającego znanemu certyfikatowi. Jeśli kontener używa domyślnego klucza klienta, będzie zawierał dodatkowy parametr OAuth xoauth_app_url, który identyfikuje urządzenie wysyłające żądanie.

                Parametr wywołania zwrotnego

                Parametr wywołania zwrotnego makeRequest() przekazuje obiekt JavaScript z kilkoma polami dotyczącymi protokołu OAuth oprócz zwykłych wartości zwracanych przez makeRequest():

                "oauthApprovalUrl"
                Jeśli określisz tę wartość, użytkownik będzie musiał otworzyć stronę zewnętrzną, aby zatwierdzić dostęp do gadżetu. Zalecamy użycie wyskakującego okienka, który przekieruje użytkownika do strony zewnętrznej. Po zatwierdzeniu dostępu użytkownik może ponownie wykonać wywołanie MakeRequest w celu pobrania danych.
                "oauthError"
                Jeśli ta wartość jest określona, oznacza to, że wystąpił błąd związany z OAuth. Wartość będzie jednym z zestawu stałych ciągów znaków, których można użyć do automatycznego wykrywania błędów. Stałe nieokreślone w zasadzie opensocial-0.8, ale implementatory powinny spróbować uzgodnić zestaw przydatnych wartości stałych w standardzie opensocial-0.9.
                "oauthErrorText"
                Jeśli podasz tę wartość, oznacza to, że wystąpił błąd protokołu OAuth. Wartością jest dowolny tekst, który można podać programistom debugowania.
                  Parametry:
                    String url - Adres URL, pod którym znajduje się treść
                    Function callback - Funkcja do wywoływania danych z adresu URL po jego pobraniu

                Powrót do góry

                Static Class.io.AuthorizationType,

                Używany przez RequestRequest.

                Podsumowanie pola

                <static> object NONE
                Brak autoryzacji.
                <static> object OAUTH
                Kontener będzie używać uwierzytelniania OAuth.
                <static> object SIGNED
                Żądanie zostanie podpisane przez kontener.
                 

                Szczegóły pola

                BRAK

                <static> object NONE
                  Brak autoryzacji.

                UWIERZYTELNIANIE

                <static> object OAUTH
                  Kontener będzie używać uwierzytelniania OAuth.

                Podpisano

                <static> object SIGNED
                  Żądanie zostanie podpisane przez kontener.

                Powrót do góry

                Static Class.io.ContentType;

                Używany przez RequestRequest.

                Podsumowanie pola

                <static> object DOM
                Zwraca obiekt DOM; służy do pobierania plików XML.
                <static> object FEED
                Zwraca plik JSON lub kanał RSS lub Atom.
                <static> object JSON
                Zwraca obiekt JSON.
                <static> object TEXT
                Zwraca tekst; służy do pobierania kodu HTML.
                 

                Szczegóły pola

                DOM

                <static> object DOM
                  Zwraca obiekt DOM; służy do pobierania plików XML.

                AKTYWNOŚĆ

                <static> object FEED
                  Zwraca reprezentację kanału RSS lub Atom w formacie JSON.

                JSON

                <static> object JSON
                  Zwraca obiekt JSON.

                TEKST

                <static> object TEXT
                  Zwraca tekst; służy do pobierania kodu HTML.

                Powrót do góry

                Static Class.io.MethodType

                Określa wartości właściwości RequestParameters.Method.

                Podsumowanie pola

                <static> object DELETE
                Obsługa kontenerów na tym typie metody jest OPTIONAL.
                <static> object GET
                Domyślny typ.
                <static> object HEAD
                Obsługa kontenerów na tym typie metody jest OPTIONAL.
                <static> object POST
                Obsługa kontenerów na tym typie metody jest OPTIONAL.
                <static> object PUT
                Obsługa kontenerów na tym typie metody jest OPTIONAL.
                 

                Szczegóły pola

                USUŃ

                <static> object DELETE
                  Obsługa kontenerów w przypadku tego typu metody wynosi OPTIONAL.

                POBIERZ

                <static> object GET
                  Typ domyślny.
                <static> object HEAD
                  Obsługa kontenerów w przypadku tego typu metody wynosi OPTIONAL.

                POST

                <static> object POST
                  Obsługa kontenerów w przypadku tego typu metody wynosi OPTIONAL.

                PUT

                <static> object PUT
                  Obsługa kontenerów w przypadku tego typu metody wynosi OPTIONAL.

                Powrót do góry

                Static Class.io.ProxyUrlRequestParameters

                Używana przez metodę gadgets.io.getProxyUrl().

                Podsumowanie pola

                <static> object REFRESH_INTERVAL
                Próbuj użyć pamięci podręcznej treści.
                 

                Szczegóły pola

                ODŚWIEŻ_INTERWAŁ

                <static> object REFRESH_INTERVAL
                  Próbuj użyć pamięci podręcznej treści. Okres odświeżania to liczba sekund, które mają być buforowane w odpowiedzi. Domyślnie nagłówki HTTP będą przestrzegane. Jeśli żaden nagłówek HTTP nie zawiera żadnych wartości, domyślna wartość to 3600 (godzina). Pamiętaj, że podpisane żądania i obiekty zawierające dane POST_DATA zwykle nie są przechowywane w pamięci podręcznej.

                Powrót do góry

                Static Class.io.RequestParameters

                Używana przez metodę gadgets.io.makeRequest().

                Podsumowanie pola

                <static> object AUTHORIZATION
                Typ uwierzytelniania używany podczas pobierania treści. Ustawienie domyślne to AuthorizationType.NONE.
                <static> object CONTENT_TYPE
                Typ treści znajdujących się pod adresem URL; domyślnie ContentType.TEXT.
                <static> object GET_SUMMARIES
                Jeśli zawartość jest plikiem danych, określa, czy pobrać podsumowania dla tego kanału. Wartość domyślna to false.
                <static> object HEADERS
                Nagłówki HTTP wysyłane na adres URL; domyślnie ma wartość NULL.
                <static> object METHOD
                Metoda używana do pobierania treści z adresu URL. Domyślnie stosowana jest zasada MethodType.GET.
                <static> object NUM_ENTRIES
                Jeśli zawartość jest plikiem danych, liczba wpisów do pobrania; domyślna wartość to 3.
                <static> object POST_DATA
                Dane wysłane do adresu URL za pomocą metody POST. Domyślnie są puste.
                 

                Szczegóły pola

                AUTORYZACJA

                <static> object AUTHORIZATION
                  Typ uwierzytelniania, który ma być używany podczas pobierania treści. Domyślnym typem jest AuthorizationType.NONE. Określana jako AuthorizationType.

                CONTENT_TYPE

                <static> object CONTENT_TYPE
                  Typ treści znajdujący się pod adresem URL. Domyślnie jest to ContentType.TEXT. Określana jako ContentType.

                GET_SUMMARIES

                <static> object GET_SUMMARIES
                  Jeśli treści są plikiem danych, określ, czy chcesz pobierać z nim podsumowania. Wartość domyślna to fałsz. Określana jako Boolean.

                NAGŁÓWKI

                <static> object HEADERS
                  Nagłówki HTTP wysyłane do adresu URL; wartość domyślna to null. Określana jako Map.<String,String>.

                METODA

                <static> object METHOD
                  Metoda używana do pobierania treści z adresu URL. Domyślnie stosowana jest wartość MethodType.GET. Prawidłowe wartości określa się za pomocą MethodType.

                NUM_ENTRIES

                <static> object NUM_ENTRIES
                  Jeśli zawartość jest plikiem danych, liczba wpisów do pobrania; domyślna wartość 3. Określana jako Number.

                POST_DANE

                <static> object POST_DATA
                  Dane, które mają zostać wysłane do adresu URL za pomocą metody POST, są domyślnie puste. Określana jako String.

                Powrót do góry

                Static Class json.json

                Udostępnia operacje na przekształcanie obiektów do i z JSON.

                Podsumowanie metod

                <static>  Object parse(text)
                Pasuje ciąg JSON i generuje wartość JavaScript.
                <static>  String stringify(v)
                Konwertuje wartość JavaScript na ciąg JSON.
                 

                Szczegóły metody

                analizowa

                <static> Object parse(text)
                  Analizuje ciąg znaków JSON i generuje wartość JavaScript.
                  Parametry:
                    String text – ciąg, który ma zostać przekształcony w obiekt. Zazwyczaj jest to wynik poprzedniego wywołania ciągu TXT.
                  Zwraca:
                    Object Obiekt przeanalizowany z przekazanego tekstu;
                  fałsz, jeśli wystąpił błąd

              ciąg

              <static> String stringify(v)
                Konwertuje wartość JavaScriptu na ciąg JSON.
                Parametry:
                  Object v – obiekt do przekonwertowania
                Zwraca:
                  String  Odpowiednik JSON

              Powrót do góry

              Static Class Gadżet.pubsub

              Zapewnia operacje publikowania i subskrybowania kanałów wiadomości.

              Podsumowanie metod

              <static> publish(channelName, message)
              Publikuje wiadomość w postaci ciągu znaków na kanale.
              <static> subscribe(channelName, callback)
              Subskrybuje widżet kanału wiadomości.
              <static> unsubscribe(channelName)
              Anuluje subskrypcję gadżetu w kanale wiadomości.
               

              Szczegóły metody

              publish

              <static> publish(channelName, message)
                Publikowanie wiadomości typu ciąg znaków w kanale.
                Parametry:
                  String channelName – nazwa kanału
                  String message – wiadomość do opublikowania

              subskrybować

              <static> subscribe(channelName, callback)
                Subskrybuje widżet na kanale wiadomości.
                Parametry:
                  String channelName – nazwa kanału
                  Function callback – funkcja, która zostanie wywołana z wiadomościami

              anulować subskrypcję

              <static> unsubscribe(channelName)
                Rezygnuje z subskrypcji gadżetu z kanału wiadomości.
                Parametry:
                  String channelName – nazwa kanału

              Powrót do góry

              Static Class Gadżet.rpc,

              Zapewnia operacje wykonywania zdalnych wywołań procedur związanych z komunikacją między gadżetumi, kontenerem, kontenerem i gadżetem-gadżetu.

              Podsumowanie metod

              <static> call(targetId, serviceName, callback, var_args)
              Wywołuje usługę RPC.
              <static> register(serviceName, handler)
              Rejestruje usługę RPC.
              <static> registerDefault(handler)
              Rejestrowanie domyślnego modułu obsługi w celu przetwarzania wszystkich nieznanych zdalnych wywołań procedury, które domyślnie się nie odbywają.
              <static> unregister(serviceName)
              Wyrejestrowuje usługę RPC.
              <static> unregisterDefault()
              Wyrejestrowuje domyślny moduł obsługi usługi.
               

              Szczegóły metody

              dzwoń

              <static> call(targetId, serviceName, callback, var_args)
                Wywołuje usługę RPC.
                Parametry:
                  String targetId – identyfikator dostawcy usługi RPC; puste, jeśli wywoływany kontener nadrzędny
                  String serviceName – nazwa usługi do wywołania
                  Function, null callback – funkcja wywołania zwrotnego (jeśli istnieje)
                  * var_args – parametry dla żądania RPC

              zarejestrować się

              <static> register(serviceName, handler)
                Rejestruje usługę RPC.
                Parametry:
                  String serviceName – nazwa usługi do zarejestrowania
                  Function handler – moduł obsługi usługi

              defaultDefault,

              <static> registerDefault(handler)
                Rejestruje domyślny moduł obsługi usługi, który przetwarza wszystkie nieznane wywołania zdalnych procedur, które domyślnie się nie wyświetlają.
                Parametry:
                  Function handler – moduł obsługi usługi

              zrezygnować

              <static> unregister(serviceName)
                Wyrejestrowuje usługę RPC.
                Parametry:
                  String serviceName – nazwa usługi do wyrejestrowania

              unregisterDefault

              <static> unregisterDefault()
                Wyrejestrowuje domyślny moduł obsługi usługi. Kolejne nieznane wywołania procedur zdalnych zakończą się niepowodzeniem.

              Powrót do góry

              Static Class.skins (klasa statyczna)

              Udostępnia operacje wyświetlania informacji o obecnie wyświetlanej skórze.

              Podsumowanie metod

              <static>  String getProperty(propertyKey)
              Pobiera właściwość displayową zmapowaną na określony klucz.
               

              Szczegóły metody

              getProperty

              <static> String getProperty(propertyKey)
                Pobiera właściwość wyświetlaną zmapowaną na określony klucz.
                Parametry:
                  String propertyKey – klucz, dla którego chcesz uzyskać informacje; klucze są zdefiniowane w gadgets.skins.Property
                Zwraca:
                  String 

              Powrót do góry

              Static Class Gadżet.skins.Property

              Wszystkie wyświetlane wartości, które można pobrać i wykorzystać w interfejsie gadżetów. Oto obsługiwane klucze metody widget.skins.getProperty().

              Podsumowanie pola

              <static> object ANCHOR_COLOR
              Kolor, którego powinny używać tagi kotwicy.
              <static> object BG_COLOR
              Kolor tła gadżetu.
              <static> object BG_IMAGE
              Obraz, który ma być używany w tle.
              <static> object FONT_COLOR
              Kolor, w którym powinna zostać wyrenderowana główna czcionka.
               

              Szczegóły pola

              KOLORY

              <static> object ANCHOR_COLOR
                Kolor, którego powinny używać tagi kotwicy.

              Kolor_BG

              <static> object BG_COLOR
                Kolor tła gadżetu.

              BG_IMAGE

              <static> object BG_IMAGE
                Obraz, który ma być używany w tle.

              KOLORY

              <static> object FONT_COLOR
                Kolor, w którym powinna zostać wyrenderowana główna czcionka.

              Powrót do góry

              Static Class.util,

              Zapewnia ogólnofunkcyjne funkcje administracyjne.

              Podsumowanie metod

              <static>  String escapeString(str)
              Zmienia znaczenie danych wejściowych, wykorzystując encje HTML, aby zwiększyć ich bezpieczeństwo.
              <static>  Object getFeatureParameters(feature)
              Zwraca wartość parametrów dla tej funkcji.
              <static>  Boolean hasFeature(feature)
              Zwraca informacje o tym, czy określona funkcja jest obsługiwana.
              <static> registerOnLoadHandler(callback)
              Rejestrowanie modułu obsługi ładowania – funkcji wykonywanej podczas ładowania gadżetu.
              <static>  String unescapeString(str)
              Odwraca EscapeString

              Szczegóły metody

              ciąg znaków zmiany znaczenia

              <static> String escapeString(str)
                Zmienia znaczenie danych wejściowych, wykorzystując encje HTML, aby zwiększyć ich bezpieczeństwo. Dotyczy to tych znaków:
                • nowy wiersz (\n, punkt kodowy Unicode 10)
                • Zwrot do nowej linii ( Buzz, Unicode 13)
                • podwójny cudzysłów (" Unicode 34)
                • ampersand (&, Unicode 38)
                • pojedynczy cudzysłów (' Unicode 39)
                • lewy nawias kątowy (< Unicode 60)
                • nawias kątowy (> Unicode 62)
                • ukośnik lewy (\, Unicode 92)
                • separator wiersza (Unicode 8232)
                • separator akapitu (Unicode 8233)
                Parametry:
                  String str – ciąg znaków zmiany znaczenia
                Zwraca:
                  String  Ciąg zmiany znaczenia

              getFeatureParameters

              <static> Object getFeatureParameters(feature)
                Zwraca wartość parametrów tej funkcji. Parametry określają parametry za pomocą podelementu <Param> elementu <Requires> lub <Optional>.
                Parametry:
                  String feature – funkcja, która pobiera parametry dla
                Zwraca:
                  Object  Parametry danej funkcji lub jej wartość null

              zawiera funkcję

              <static> Boolean hasFeature(feature)
                Zwraca, czy określona funkcja jest obsługiwana.
                Parametry:
                  String feature – funkcja do przetestowania
                Zwraca:
                  Boolean  Prawda, jeśli funkcja jest obsługiwana

              signOnLoadHandler,

              <static> registerOnLoadHandler(callback)
                Rejestruje moduł obsługi obciążenia, który jest wykonywany podczas ładowania gadżetu.
                Parametry:
                  Function callback – moduł do uruchamiania

              ciąg znaków zmiany znaczenia

              <static> String unescapeString(str)
                Odwraca znaczenie zmiany znaczenia
                Parametry:
                  String str – ciąg do cofnięcia zmiany.
                Zwraca:
                  String  ciąg znaków bez zmiany znaczenia

              Powrót do góry

              Static Class.views

              Obsługiwane operacje na widokach.

              Zobacz też: gadgets.views.View

              Podsumowanie metod

              <static>  String bind(urlTemplate, environment)
              Przypisuje szablon URL ze zmiennymi w przekazanym środowisku w celu utworzenia ciągu adresów URL.
              <static>  gadgets.views.View getCurrentView()
              Zwraca bieżący widok.
              <static>  Map.<String, String> getParams()
              Zwraca parametry przekazane do tego gadżetu w tym widoku.
              <static>  Map<gadgets.views.ViewType, String, gadgets.views.View> getSupportedViews()
              Zwraca mapę wszystkich obsługiwanych widoków.
              <static> requestNavigateTo(view, opt_params, opt_ownerId)
              Próbuje otworzyć ten widżet w innym widoku.
               

              Szczegóły metody

              powiązanie

              <static> String bind(urlTemplate, environment)
                Wiąże szablon adresu URL ze zmiennymi w przekazanym środowisku w celu utworzenia ciągu adresów URL.

                Zobacz też: View.getUrlTemplate()

                Parametry:
                  urlTemplate – szablon URL do widoku kontenera
                  environment – zestaw nazwanych zmiennych (np. [WŁAŚCICIEL | Ścieżka | PARAMETRY | NAZWA]) ciągu typu.
                Zwraca:
                  String  Ciąg adresu URL

              GetCurrentView

              <static> gadgets.views.View getCurrentView()
                Zwraca bieżący widok.
                Zwraca:
                  gadgets.views.View  Bieżący widok

              getParams

              <static> Map.<String, String> getParams()
                Zwraca parametry przekazane do tego gadżetu w tym widoku. Nie obejmuje to wszystkich parametrów adresu URL, tylko tych, które są przekazywane do gadżetu.views.requestNawigacja.
                Zwraca:
                  Map.<String, String>  Mapa parametrów

              getSupportedViews

              <static> Map<gadgets.views.ViewType, String, gadgets.views.View> getSupportedViews()
                Zwraca mapę wszystkich obsługiwanych widoków. Kluczy do każdego pliku options.view.View.
                Zwraca:
                  Map<gadgets.views.ViewType, String, gadgets.views.View>  Wszystkie obsługiwane widoki danych, według klucza atrybutu.

              żądajNawigacji

              <static> requestNavigateTo(view, opt_params, opt_ownerId)
                próbuje otworzyć ten widżet w innym widoku. Jeśli kontener obsługuje parametry, przekazuje je w nowym widoku do gadżetu.
                Parametry:
                  gadgets.views.View view – widok prowadzący do
                  Map.<String, String> opt_params – parametry przekazywane do gadżetu po przejściu do platformy
                  String opt_ownerId – identyfikator właściciela strony prowadzącej do witryny;
                1 {3 1 {3 1 3

                Powrót do góry

                Klasa widget.views

                Interfejs podstawowy wszystkich obiektów widoku danych.

                Podsumowanie metod

                 String bind(environment)
                Wiąże szablon szablonu ze zmiennymi w przekazanym środowisku w celu utworzenia ciągu adresów URL.
                 gadgets.views.ViewType, String getName()
                Zwraca nazwę tego widoku.
                 String getUrlTemplate()
                Zwraca szablon URI ciągu znaków zgodny ze wersją roboczą specyfikacji IETF ze zmiennymi do zastąpienia.
                 boolean isOnlyVisibleGadget()
                Zwraca wartość „prawda”, jeśli gadżety są jedynym widocznym gadżetem w tym widoku.
                 

                Szczegóły metody

                powiązanie

                String bind(environment)
                  Wiąże szablon szablonu widoku danych ze zmiennymi w przekazanym środowisku w celu utworzenia ciągu adresów URL.

                  Zobacz też: getUrlTemplate()

                  Parametry:
                    environment – zestaw nazwanych zmiennych (np. [OWNER | PATH | PARAMS | NAME]) ciągu typu.
                  Zwraca:
                    String  Ciąg adresu URL

                getName

                gadgets.views.ViewType, String getName()
                  Zwraca nazwę tego widoku.
                  Zwraca:
                    gadgets.views.ViewType, String  Nazwa widoku danych, zwykle określana jako widget.views.ViewType

                Pobierz szablonUrl

                String getUrlTemplate()
                  Zwraca szablon URI ciągu tekstowego zgodny ze wersją roboczą specyfikacji IETF ze zamiennikami.

                  Obsługiwane są 4 zmienne:

                  name
                  Nazwa lub identyfikator aplikacji
                  owner
                  Identyfikator właściciela strony
                  ścieżka
                  Tablica kroków
                  parametry
                  Tablica pokrewna lub tablica[param1,value1,param2,value2,...]

                  Przykład

                  Oto 2 prawidłowe ciągi szablonów adresów URL:

                  http://container.com/{-list|/|name,owner,path}?{-join|&|params}
                  http://container.com/apps/{name}/{owner}{-prefix|/|path}{-opt|?os_|params}{-join|&os_|params} 
                  

                  Oto kilka parametrów:

                  { 
                    name : 'Wilma',
                    owner : 'Betty',
                    path : ['dino','car'], 
                    params = { a : 'Barney', b : 'Fred'}
                  }

                  Przy użyciu tych parametrów 2 przykładowe ciągi szablonów adresów URL prowadzą do tych adresów URL:

                  http://container.com/Wilma/Betty/dino/car?a=Barney&b=Fred
                  http://container.com/apps/Wilma/Betty/dino/car?os_a=Barney&os_b=Fred
                  

                  Zobacz też: bind()

                  Zwraca:
                    String  Szablon, którego można użyć do tworzenia adresów URL prowadzących do tego widoku

                isOnlyVisibleGadżet

                boolean isOnlyVisibleGadget()
                  Zwraca wartość „prawda”, jeśli gadżetu jest jedynym widocznym widokiem w tym widoku. Na stronie canvas lub w trybie maksymalizacji jest to najczęściej wartość prawda.
                  Zwraca:
                    boolean  Prawda, jeśli gadżetu jest jedynym widocznym gadżetem. W przeciwnym razie ma wartość Fałsz

                Powrót do góry

                Static Class stanie.views.ViewType

                Używana w widokach danych.

                Podsumowanie pola

                <static> object CANVAS
                Widok, w którym widżet jest wyświetlany w bardzo dużym trybie.
                <static> object HOME
                Widok, w którym widżet jest wyświetlany w niewielkim obszarze na stronie z innymi gadżetami.
                <static> object PREVIEW
                Wersja demonstracyjna gadżetu.
                <static> object PROFILE
                Widok, w którym widżet jest wyświetlany w niewielkim obszarze na stronie z innymi gadżetami.
                 

                Szczegóły pola

                PUNKTY

                <static> object CANVAS
                  Widok, w którym gadżet jest wyświetlany w bardzo dużym trybie. Zwykle jest to główna treść strony. Przeglądający nie zawsze są takie same jak właściciel.

                DOM

                <static> object HOME
                  Widok, w którym gadżet jest wyświetlany w małym miejscu, zwykle na stronie z innymi gadżetami. Zwykle widz jest taki sam jak właściciel.

                PODGLĄD

                <static> object PREVIEW
                  Wersja demonstracyjna gadżetu. W tym widoku właściciel i widz nie są znani.

                PROFIL

                <static> object PROFILE
                  Widok, w którym gadżet jest wyświetlany w małym miejscu, zwykle na stronie z innymi gadżetami. Użytkownik może się różnić od właściciela.

                Powrót do góry

                Static Class options.window,

                Informuje o pobieraniu i modyfikowaniu okna, w którym znajduje się gadżetu.

                Podsumowanie metod

                <static> adjustHeight(opt_height)
                Dostosowuje wysokość gadżetu.
                <static>  Object getViewportDimensions()
                Wykrywanie wewnętrznych wymiarów klatki.
                <static> setTitle(title)
                Ustawia tytuł gadżetu.
                 

                Szczegóły metody

                Dostosujwysokość

                <static> adjustHeight(opt_height)
                  Dostosowuje wysokość gadżetu.
                  Parametry:
                    Number opt_height – opcjonalna preferowana wysokość w pikselach. Jeśli nie zostaną podane, spróbuje dopasować gadżet do zawartości

                getViewportDimensions

                <static> Object getViewportDimensions()
                  Zwraca:
                    Object  Obiekt z właściwościami szerokości i wysokości

                UstawTytuł

                <static> setTitle(title)
                  Ustawia tytuł gadżetu.
                  Parametry:
                    String title – preferowany tytuł

                Powrót do góry