Class Columns

Kolumny

Widżet Columns wyświetla maksymalnie 2 kolumny na karcie lub w oknie. Możesz dodać widżety do każdego Column. Będą one wyświetlane w określonej kolejności. Przykład w aplikacjach Google Chat znajdziesz w sekcji Kolumny.

Wysokość każdej kolumny jest określana przez wyższą kolumnę. Jeśli na przykład pierwsza kolumna jest wyższa od drugiej, obie kolumny mają wysokość pierwszej kolumny. Każda kolumna może zawierać inną liczbę widżetów, więc nie możesz definiować wierszy ani wyrównywać widżetów między kolumnami.

Kolumny są wyświetlane obok siebie. Szerokość każdej kolumny możesz dostosować za pomocą pola HorizontalSizeStyle. Jeśli szerokość ekranu użytkownika jest zbyt mała, druga kolumna zostanie przeniesiona pod pierwszą:

  • W przypadku stron internetowych druga kolumna jest zawijana, jeśli szerokość ekranu jest mniejsza lub równa 480 pikseli.
  • Na urządzeniach z iOS druga kolumna jest zawijana, jeśli szerokość ekranu jest mniejsza lub równa 300 punktów.
  • Na urządzeniach z Androidem druga kolumna jest zawijana, jeśli szerokość ekranu jest mniejsza lub równa 320 dp.

Dostępne w przypadku aplikacji Google Chat i dodatków do Google Workspace. Interfejsy dodatku, które obsługują kolumny:

  • Okno wyświetlane, gdy użytkownicy otwierają dodatek z poziomu wersji roboczej e-maila.
  • Okno wyświetlane, gdy użytkownicy otwierają dodatek z menu Dodaj załącznik w wydarzeniu w Kalendarzu Google. 
    // Build a column that is aligned in the center and fills the space:
const column =
    CardService.newColumn()
        .setHorizontalSizeStyle(
            CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE)
        .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER)
        .setVerticalAlignment(CardService.VerticalAlignment.CENTER);
const columns = CardService.newColumns().addColumn(column).setWrapStyle(
    CardService.WrapStyle.WRAP);

Metody

MetodaZwracany typKrótki opis
addColumn(column)ColumnsDodaje Column do widżetu Kolumny.
addEventAction(eventAction)WidgetDodaje działanie związane z wydarzeniem, które można wykonać w widżecie.
setId(id)WidgetUstawia unikalny identyfikator przypisany do widżetu, który ma zostać zmieniony.
setVisibility(visibility)WidgetUstawia widoczność widżetu.
setWrapStyle(wrapStyle)ColumnsUstawia styl zawijania kolumn i określa, jak kolumna zmienia rozmiar w zależności od szerokości ekranu.

Szczegółowa dokumentacja

addColumn(column)

Dodaje Column do widżetu Kolumny. Kolumny są wyświetlane w kolejności, w jakiej zostały dodane. Możesz dodać maksymalnie 2 kolumny. 

const columns = CardService.newColumns().addColumn(CardService.newColumn());

Parametry

NazwaTypOpis
columnColumnKolumna podrzędna do dodania do widżetu Kolumny.

Powrót

Columns – ten obiekt do łączenia.

addEventAction(eventAction)

Dodaje działanie związane z wydarzeniem, które można wykonać w widżecie.

Parametry

NazwaTypOpis
eventActionEventActionEventAction do dodania.

Powrót

Widget – obiekt do łączenia.

setId(id)

Ustawia unikalny identyfikator przypisany do widżetu, który ma zostać zmieniony. Modyfikacja widżetu jest obsługiwana tylko w dodatkach.

Parametry

NazwaTypOpis
idStringIdentyfikator widżetu, który może mieć maksymalnie 64 znaki i musi być zgodny z formatem `[a-zA-Z0-9-]+`.

Powrót

Widget – ten obiekt do łączenia.

setVisibility(visibility)

Ustawia widoczność widżetu. Wartością domyślną jest „VISIBLE”.

Parametry

NazwaTypOpis
visibilityVisibilityVisibility widżetu.

Powrót

Widget – obiekt do łączenia.

setWrapStyle(wrapStyle)

Ustawia styl zawijania kolumn i określa, jak kolumna zmienia rozmiar w zależności od szerokości ekranu. 

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

Parametry

NazwaTypOpis
wrapStyleWrapStyleStyl zawijania, który ma być ustawiony dla kolumn.

Powrót

Columns – ten obiekt do łączenia.