Aracılığıyla paylaş

Girdi.SeçenekSeti

Uyarı

Uyarlamalı Kartlar ile desteklenen Copilot, Teams veya Outlook senaryoları mı oluşturuyorsunuz? Tüm Uyarlamalı Kart gereksinimleriniz için yeni tek mağaza olan Uyarlamalı Kart Belge Merkezi'ni ziyaret edin! Yanıt veren düzen, Simge, Rozet, Döngü, Grafikler ve çok daha fazlası gibi birçok yeni özelliğin tam belgeleri de dahil olmak üzere aradığınız tüm kaynaklara sahiptir!

Erişilebilirlik hakkında önemli not: Şemanın 1.3 sürümünde, erişilebilirliği geliştirmek için Girişler'de bir etiket özelliği kullanıma sunulmuştur. Hedeflediğiniz Konak uygulaması v1.3'i destekliyorsa, aşağıdaki bazı örneklerde görüldüğü gibi TextBlock yerine etiket kullanmalısınız. Çoğu Ana bilgisayar uygulaması en son sürüme güncellendikten sonra, örnekleri buna göre güncelleyeceğiz.

Girdi.SeçenekSeti

Kullanıcının Bir Seçim girişine izin verir.

Input.ChoiceSet Özellikleri

Mülkiyet Türü Gerekli Description Sürüm
type "Input.ChoiceSet" Yes olmalıdır "Input.ChoiceSet". 1.0
ID string Yes Değerin benzersiz tanımlayıcısı. Gönder eylemi gerçekleştirilirken toplanan girişi tanımlamak için kullanılır. 1.0
seçenekleri Input.Choice[] Hayı Choice Seçenekler. 1.0
choices.data Data.Query Hayı Kullanıcı giriş alanına yazarken bottan seçimlerin dinamik olarak getirilmesinin açılan listede öneri olarak görüntülenmesini sağlar. 1.6
isMultiSelect boolean Hayı Birden çok seçeneğin seçilmesine izin ver. 1.0
üslup ChoiceInputStyle Hayı 1.0
value string Hayı Seçilmesi gereken ilk seçenek (veya seçenek kümesi). Çoklu seçim için virgülle ayrılmış bir değer dizesi belirtin. 1.0
Yer tutucu string Hayı İstenen girişin açıklaması. Yalnızca hiçbir seçim yapılmadığında görünür, stylecompact ve isMultiSelectfalse şeklindedir. 1.0
sarmak boolean Hayı Eğer true ise, metnin kaydırılmasına izin verin. Aksi takdirde metin kırpılır. 1.2

Devralınan özellikler

Mülkiyet Türü Gerekli Description Sürüm
errorMessage string Hayı Girilen giriş geçersiz olduğunda görüntülenecek hata iletisi 1.3
isRequired boolean Hayı Bu girişin gerekli olup olmadığı 1.3
etiket string Hayı Bu girişin etiketi 1.3
labelPosition InputLabelPosition Hayı [YALNıZCA JAVASCRIPT SDK'SıNDA DESTEKLENIR] Etiketin konumunu belirler. 'satır içi' ve 'yukarıdaki' değerleri alabilir. Varsayılan olarak, etiket konumu belirtilmediğinde etiket 'yukarıya' yerleştirilir. 1.6
labelWidth string, number Hayı [YALNıZCA JAVASCRIPT SDK'SıNDA DESTEKLENIR] Etiket girişle satır içine yerleştirildiğinde etiketin genişliğini yüzde 40 veya '40px' gibi belirli bir piksel genişliği olarak belirler. Etiket bilgisi girişin üzerinde görüntülendiğinde, labelWidth parametresi yoksayılır. 1.6
inputStyle InputStyle Hayı [YALNıZCA JAVASCRIPT SDK'SıNDA DESTEKLENIR] Giriş alanları için stil önerisi. Giriş alanlarının salt okunur olarak görünmesine izin verir, ancak kullanıcı alana tıkladığında/odaklandığında bu alanları güncelleştirmelerine olanak tanır. 1.6
Geri dönüş Element, FallbackOption Hayı Bilinmeyen bir öğeyle karşılaşıldığında veya bunun veya herhangi bir alt öğenin gereksinimi karşılanmadığında ne yapılması gerektiğini açıklar. 1.2
yükseklik BlockElementHeight Hayı öğesinin yüksekliğini belirtir. 1.1
separator boolean Hayı olduğunda true, öğesinin en üstüne bir ayırma çizgisi çizin. 1.0
Aralığı Spacing Hayı Bu öğe ile önceki öğe arasındaki aralık miktarını denetler. 1.0
isVisible boolean Hayır, varsayılan: true ise false, bu öğe görsel ağaçtan kaldırılır. 1.2
Gerektirir Dictionary<string> Hayı Öğenin ilgili en düşük sürümle gerektirdiği özellikleri gösteren bir dizi anahtar/değer çifti. Bir özellik eksik veya yetersiz sürüm olduğunda geri dönüş tetikleniyor. 1.2

Example

Örnek 1: ChoiceSet Stillerini Sergileme ve Çoklu Seçim

JSON Uyarlamalı Kart
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.3", "body": [ { "type": "Input.ChoiceSet", "id": "myColor", "style": "compact", "label": "What color do you want? (isMultiSelect:false, style:compact)", "isMultiSelect": false, "value": "1", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "Input.ChoiceSet", "id": "myColor2", "style": "expanded", "label": "What color do you want? (isMultiSelect:false, style:expanded)", "isMultiSelect": false, "value": "1", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "Input.ChoiceSet", "id": "myColor3", "isMultiSelect": true, "value": "1,3", "style": "compact", "label": "What colors do you want? (isMultiSelect:true, style:compact)", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "Input.ChoiceSet", "id": "myColor4", "isMultiSelect": true, "value": "1", "style": "expanded", "label": "What colors do you want? (isMultiSelect:true, style:expanded)", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] }

Özellikler

choices (Sürüm 1.0)

Choice Seçenekler.

  • Tür: Input.Choice[]
  • Gerekli: Hayır
  • İzin verilen değerler:
    • Input.Choice

choices.data (Sürüm 1.6)

Kullanıcı giriş alanına yazarken bottan seçimlerin dinamik olarak getirilmesinin açılan listede öneri olarak görüntülenmesini sağlar.

  • Tür: Data.Query
  • Sürüm : 1.6
  • Gerekli: Hayır
  • İzin verilen değerler:
    • Data.Query

isMultiSelect (Sürüm 1.0)

Birden çok seçeneğin seçilmesine izin ver.

  • Tür: boolean
  • Gerekli: Hayır

style (Sürüm 1.0)

  • Tür: ChoiceInputStyle
  • Gerekli: Hayır
  • İzin verilen değerler:
    • "compact"
    • "expanded"
    • "filtered": Sürüm 1.5'e eklendi. Kullanıcıların bir seçim kümesindeki seçimleri filtrelemesine izin verir.

değer (Sürüm 1.0)

Seçilmesi gereken ilk seçenek (veya seçenek kümesi). Çoklu seçim için virgülle ayrılmış bir değer dizesi belirtin.

  • Tür: string
  • Gerekli: Hayır

yer tutucu (Sürüm 1.0)

İstenen girişin açıklaması. Yalnızca hiçbir seçim yapılmadığında görünür, stylecompact ve isMultiSelectfalse şeklindedir.

  • Tür: string
  • Gerekli: Hayır
JSON Uyarlamalı Kart
json { "type": "AdaptiveCard", "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "version": "1.3", "body": [ { "type": "Input.ChoiceSet", "id": "CompactSelectVal", "label": "What color do you want? (compact)", "style": "compact", "isRequired": true, "errorMessage": "This is a required input", "placeholder": "Please choose", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] }

wrap (Sürüm 1.2)

Eğer true ise, metnin kaydırılmasına izin verin. Aksi takdirde metin kırpılır.

  • Tür: boolean
  • Sürüm : 1.2
  • Gerekli: Hayır

id (Sürüm 1.0)

Değerin benzersiz tanımlayıcısı. Gönder eylemi gerçekleştirilirken toplanan girişi tanımlamak için kullanılır.

  • Tür: string
  • Gerekli: Evet

errorMessage (Sürüm 1.3)

Girilen giriş geçersiz olduğunda görüntülenecek hata iletisi

  • Tür: string
  • Sürüm : 1.3
  • Gerekli: Hayır

isRequired (Sürüm 1.3)

Bu girişin gerekli olup olmadığı

  • Tür: boolean
  • Sürüm : 1.3
  • Gerekli: Hayır

label (Sürüm 1.3)

Bu girişin etiketi

  • Tür: string
  • Sürüm : 1.3
  • Gerekli: Hayır

labelPosition (Sürüm 1.6)

[YALNıZCA JAVASCRIPT SDK'SıNDA DESTEKLENIR] Etiketin konumunu belirler. 'satır içi' ve 'yukarıdaki' değerleri alabilir. Varsayılan olarak, etiket konumu belirtilmediğinde etiket 'yukarıya' yerleştirilir.

  • Tür: InputLabelPosition
  • Sürüm : 1.6
  • Gerekli: Hayır
  • İzin verilen değerler:
    • "inline"
    • "above"

labelWidth (Sürüm 1.6)

[YALNIZCA JAVASCRIPT SDK'SİNDE DESTEKLENİR] Etiket girişle satır içine yerleştirildiğinde, etiketin genişliğini yüzde olarak (örneğin yüzde 40) veya belirli bir piksel genişliği olarak ('40px' gibi) belirler. labelWidth etiketi girişin üzerinde görüntülendiğinde yoksayılır.

  • Tür: string, number
  • Sürüm : 1.6
  • Gerekli: Hayır

inputStyle (Sürüm 1.6)

[YALNıZCA JAVASCRIPT SDK'SıNDA DESTEKLENIR] Giriş alanları için stil önerisi. Giriş alanlarının salt okunur olarak görünmesine izin verir, ancak kullanıcı alana tıkladığında/odaklandığında bu alanları güncelleştirmelerine olanak tanır.

  • Tür: InputStyle
  • Sürüm : 1.6
  • Gerekli: Hayır
  • İzin verilen değerler:
    • "revealOnHover"
    • "default"

geri dönüş (Sürüm 1.2)

Bilinmeyen bir öğeyle karşılaşıldığında veya bunun veya herhangi bir alt öğenin gereksinimi karşılanmadığında ne yapılması gerektiğini açıklar.

  • Tür: Element, FallbackOption
  • Sürüm : 1.2
  • Gerekli: Hayır
  • İzin verilen değerler:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": Bilinmeyen öğelerle karşılaşıldığında bu öğenin hemen bırakılmasına neden olur. Bilinmeyen öğe daha üst seviyeye yayılmaz.

yükseklik (Sürüm 1.1)

öğesinin yüksekliğini belirtir.

  • Tür: BlockElementHeight
  • Sürüm : 1.1
  • Gerekli: Hayır
  • İzin verilen değerler:
    • "auto": Kapsayıcının yüksekliği, içindekilerin yüksekliğine göre belirlenir.
    • "stretch": Kapsayıcı, yüksekliğini üst kapsayıcının kullanılabilir kalan yüksekliğine kadar uzatır.

ayırıcı (Sürüm 1.0)

olduğunda true, öğesinin en üstüne bir ayırma çizgisi çizin.

  • Tür: boolean
  • Gerekli: Hayır

aralık (Sürüm 1.0)

Bu öğe ile önceki öğe arasındaki aralık miktarını denetler.

  • Tür: Spacing
  • Gerekli: Hayır
  • İzin verilen değerler:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (Sürüm 1.2)

ise false, bu öğe görsel ağaçtan kaldırılır.

  • Tür: boolean
  • Sürüm : 1.2
  • Gerekli: Hayır, varsayılan: true

gerektirir (Sürüm 1.2)

Öğenin ilgili en düşük sürümle gerektirdiği özellikleri gösteren bir dizi anahtar/değer çifti. Bir özellik eksik veya yetersiz sürüm olduğunda geri dönüş tetikleniyor.

  • Tür: Dictionary<string>
  • Sürüm : 1.2
  • Gerekli: Hayır
  • Last updated on