Elemen ImageSet

Nota

Apakah Anda membuat skenario Copilot, Teams, atau Outlook yang didukung oleh Kartu Adaptif? Kunjungi Hub Dokumentasi Kartu Adaptif, toko serba ada baru untuk semua kebutuhan Kartu Adaptif Anda! Ini memiliki semua sumber daya yang Anda cari, termasuk dokumentasi lengkap untuk banyak fitur baru, seperti tata letak Responsif, Ikon, Lencana, Korsel, Bagan, dan banyak lagi!

Halaman ini mendikumentasikan elemen ImageSet , yang menampilkan kumpulan Gambar yang mirip dengan galeri. Format yang dapat diterima adalah PNG, JPEG, dan GIF.

Catatan penting tentang aksesibilitas: Dalam skema versi 1.3, kami memperkenalkan properti label pada Input untuk meningkatkan aksesibilitas. Jika aplikasi Host yang Anda targetkan mendukung v1.3, Anda harus menggunakan label alih-alih TextBlock seperti yang terlihat pada beberapa sampel di bawah ini. Setelah sebagian besar aplikasi Host diperbarui ke versi terbaru, kami akan memperbarui sampel yang sesuai.

Set Gambar

ImageSet menampilkan koleksi Gambar yang mirip dengan galeri. Format yang dapat diterima adalah PNG, JPEG, dan GIF.

Sifat KumpulanGambar

Harta benda Tipe Diperlukan Description Versi
type "ImageSet" Yes Harus berupa "ImageSet" . 1.0
images Image[] Yes Array Image elemen yang akan ditampilkan. 1.0
imageSize ImageSize Tidak, default: "medium" Mengontrol perkiraan ukuran setiap gambar. Dimensi fisik akan bervariasi per host. Auto dan stretch tidak didukung untuk ImageSet. Ukuran akan default ke sedang jika nilai tersebut diatur. 1.0
gaya ImageSetStyle Tidak. Mengontrol bagaimana gambar dalam ImageSet ditampilkan. 1.6

Properti yang diwariskan

Harta benda Tipe Diperlukan Description Versi
Fallback Element, FallbackOption Tidak. Menjelaskan apa yang harus dilakukan ketika elemen yang tidak diketahui ditemui atau kebutuhan ini atau anak-anak apa pun tidak dapat dipenuhi. 1.2
Tinggi BlockElementHeight Tidak. Menentukan tinggi elemen. 1.1
separator boolean Tidak. Ketika true, gambar garis pemisah di bagian atas elemen. 1.0
Jarak Spacing Tidak. Mengontrol jumlah penspasian antara elemen ini dan elemen sebelumnya. 1.0
Id string Tidak. Pengidentifikasi unik yang terkait dengan barang. 1.0
isVisible boolean Tidak, default: true Jika false, item ini akan dihapus dari pohon visual. 1.2
Memerlukan Dictionary<string> Tidak. Serangkaian pasangan kunci/nilai yang menunjukkan fitur yang diperlukan item dengan versi minimum yang sesuai. Saat fitur tidak tersedia atau versinya tidak mencukupi, fallback diaktifkan. 1.2

Example

Contoh Set Gambar Dasar (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "ImageSet",
			"images": [
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				}
			]
		}
	]
}

Karakteristik

images

Array Image elemen yang akan ditampilkan.

  • Jenis: Image[]
  • Diperlukan: Ya
  • Nilai yang diizinkan:
    • Image

ukuran gambar

Mengontrol perkiraan ukuran setiap gambar. Dimensi fisik akan bervariasi per host. Auto dan stretch tidak didukung untuk ImageSet. Ukuran akan default ke sedang jika nilai tersebut diatur.

  • Jenis: ImageSize
  • Diperlukan: Tidak, default: "medium"
  • Nilai yang diizinkan:
    • "auto": Gambar akan menurunkan skala agar pas jika diperlukan, tetapi tidak akan meningkatkan skala untuk mengisi area.
    • "stretch": Gambar dengan skala turun dan naik agar sesuai kebutuhan.
    • "small": Gambar ditampilkan dengan lebar kecil tetap, di mana lebar ditentukan oleh host.
    • "medium": Gambar ditampilkan dengan lebar sedang tetap, dengan ukuran lebar yang ditentukan oleh host.
    • "large": Gambar ditampilkan dengan lebar besar tetap, di mana lebar ditentukan oleh host.

Contoh Ukuran Gambar (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "ImageSet",
			"imageSize": "small",
			"images": [
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/2.png",
					"altText": "Cat with red bandana"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/3.png",
					"altText": "Cat with shades"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/1.png",
					"altText": "Cat"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/2.png",
					"altText": "Cat with red bandana"
				},
				{
					"type": "Image",
					"url": "https://adaptivecards.io/content/cats/3.png",
					"altText": "Cat with shades"
				}
			]
		}
	]
}

gaya

Mengontrol bagaimana gambar dalam ImageSet ditampilkan.

  • Jenis: ImageSetStyle
  • Versi: 1.6
  • Diperlukan: Tidak
  • Nilai yang diizinkan:
    • "default": Ini adalah gaya default untuk ImageSet. Gambar ditampilkan dalam rasio aspek aslinya.
    • "stacked": Tampilkan gambar dalam tumpukan ini ImageSet di atas satu sama lain (mirip dengan tumpukan foto).
    • "grid": Tampilkan gambar dalam bentuk kisi. Semuanya ditampilkan pada ukuran yang sama. Gambar diklip sesuai kebutuhan agar pas di ruang yang tersedia.

Fallback

Menjelaskan apa yang harus dilakukan ketika elemen yang tidak diketahui ditemui atau kebutuhan ini atau anak-anak apa pun tidak dapat dipenuhi.

  • Jenis: Element, FallbackOption
  • Versi: 1.2
  • Diperlukan: Tidak
  • Nilai yang diizinkan:
    • ActionSet, , ColumnSet, ContainerFactSet, Image, ImageSetInput.ChoiceSet, , Input.Date, Input.Number, Input.Text, Input.Time, Input.Toggle, , Media, RichTextBlock, , Table,TextBlock
    • "drop": Menyebabkan elemen ini segera dihilangkan ketika elemen yang tidak diketahui ditemui. Elemen yang tidak diketahui tidak menggelegak lebih tinggi.

height

Menentukan tinggi elemen.

  • Jenis: BlockElementHeight
  • Versi: 1.1
  • Diperlukan: Tidak
  • Nilai yang diizinkan:
    • "auto": Tinggi kontainer akan ditentukan oleh tinggi isinya.
    • "stretch": Kontainer akan membentangkan tingginya ke sisa tinggi yang tersisa dari kontainer induk.

pemisah

Ketika true, gambar garis pemisah di bagian atas elemen.

  • Jenis: boolean
  • Diperlukan: Tidak

Jarak

Mengontrol jumlah penspasian antara elemen ini dan elemen sebelumnya.

  • Jenis: Spacing
  • Diperlukan: Tidak
  • Nilai yang diizinkan:
    • "default", "none""small", "medium", "large", "extraLarge", "padding"

id

Pengidentifikasi unik yang terkait dengan barang.

  • Jenis: string
  • Diperlukan: Tidak

isVisible

Jika false, item ini akan dihapus dari pohon visual.

  • Jenis: boolean
  • Versi: 1.2
  • Diperlukan: Tidak, default: true

Memerlukan

Serangkaian pasangan kunci/nilai yang menunjukkan fitur yang diperlukan item dengan versi minimum yang sesuai. Saat fitur tidak tersedia atau versinya tidak mencukupi, fallback diaktifkan.

  • Jenis: Dictionary<string>
  • Versi: 1.2
  • Diperlukan: Tidak
  • Last updated on