Columns widget'ı, bir kartta veya iletişim kutusunda en fazla 2 sütun gösterir. Her bir Column öğesine widget ekleyebilirsiniz. Widget'lar, belirtildikleri sırayla gösterilir. Google Chat uygulamalarındaki bir örnek için Sütunlar başlıklı makaleyi inceleyin.
Her sütunun yüksekliği, daha uzun olan sütun tarafından belirlenir. Örneğin, ilk sütun ikinci sütundan daha uzunsa her iki sütunun yüksekliği ilk sütunun yüksekliğiyle aynı olur. Her sütun farklı sayıda widget içerebileceğinden satır tanımlayamaz veya sütunlar arasında widget'ları hizalayamazsınız.
Sütunlar yan yana gösterilir. Horizontal alanını kullanarak her sütunun genişliğini özelleştirebilirsiniz. Kullanıcının ekran genişliği çok darsa ikinci sütun, birinci sütunun altına kaydırılır:
- Web'de, ekran genişliği 480 pikselden az veya bu değere eşitse ikinci sütun kaydırılır.
- iOS cihazlarda, ekran genişliği 300 pt'ye eşit veya daha azsa ikinci sütun kaydırılır.
- Android cihazlarda, ekran genişliği 320 dp'den az veya bu değere eşitse ikinci sütun kaydırılır.
Google Chat uygulamaları ve Google Workspace eklentileri için kullanılabilir. Sütunları destekleyen eklenti kullanıcı arayüzleri şunlardır:
- Kullanıcılar eklentiyi bir e-posta taslağından açtığında gösterilen iletişim kutusu.
- Kullanıcılar bir Google Takvim etkinliğinde eklentiyi Ek ekle menüsünden açtığında gösterilen iletişim kutusu.
// 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);
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
add | Columns | Sütunlar widget'ına Column ekler. |
add | Widget | Widget'ta gerçekleştirilebilecek etkinlik işlemini ekler. |
set | Widget | Değiştirilecek widget'ı tanımlamak için kullanılan benzersiz kimliği ayarlar. |
set | Widget | Widget'ın görünürlüğünü ayarlar. |
set | Columns | Sütunların sarmalama stilini ayarlar, sütunun ekran genişliğine göre nasıl yeniden boyutlandırılacağını kontrol eder. |
Ayrıntılı belgeler
add
Sütunlar widget'ına Column ekler. Sütunlar, eklendikleri sırayla gösterilir. En fazla iki sütun ekleyebilirsiniz.
const columns = CardService.newColumns().addColumn(CardService.newColumn());
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
column | Column | Sütunlar widget'ına eklenecek bir alt sütun. |
Return
Columns: Zincirleme için kullanılan bu nesne.
add
Widget'ta gerçekleştirilebilecek etkinlik işlemini ekler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
event | Event | Eklenecek Event. |
Return
Widget: Zincirleme için kullanılan Nesne.
set
Değiştirilecek widget'ı tanımlamak için kullanılan benzersiz kimliği ayarlar. Widget mutasyonu yalnızca eklentilerde desteklenir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
id | String | 64 karakterle sınırlı ve `[a-zA-Z0-9-]+` biçiminde olan widget'ın kimliği. |
Return
Widget: Zincirleme için kullanılan bu nesne.
set
Widget'ın görünürlüğünü ayarlar. Varsayılan değer "VISIBLE"dır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
visibility | Visibility | Widget'ın Visibility. |
Return
Widget: Zincirleme için kullanılan Nesne.
set
Sütunların sarmalama stilini ayarlar, sütunun ekran genişliğine göre nasıl yeniden boyutlandırılacağını kontrol eder.
const columns = CardService.newColumns() .addColumn(CardService.newColumn()) .setWrapStyle(CardService.WrapStyle.WRAP);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
wrap | Wrap | Sütunlar için ayarlanacak sarmalama stili. |
Return
Columns: Zincirleme için kullanılan bu nesne.