CardFactory class

Elenca lo schema del tipo di contenuto per ogni stile di scheda.

static contentTypes: any

Valore della proprietà

Restituisce una matrice formattata correttamente delle azioni.

static function actions(actions: string | CardAction[] | undefined): CardAction[]

Parametri

Restituisce

Matrice formattata correttamente delle azioni.

Restituisce un allegato per una scheda adattiva.

static function adaptiveCard(card: any): Attachment

Parametri

Restituisce

Allegato.

Commenti

Le schede adattive sono un formato aperto per lo scambio di schede che consente agli sviluppatori di scambiare contenuti dell'interfaccia utente in un modo coerente e comune. Per i canali che non supportano ancora le schede adattive in modo nativo, Bot Framework eseguirà il rendering della scheda a un'immagine con stile per essere ottimale nel canale di destinazione. Per i canali che supportano le schede hero, è possibile continuare a includere le azioni della scheda adattiva e verranno inviate come pulsanti insieme alla versione di cui è stato eseguito il rendering della scheda.

Per altre informazioni sulle schede adattive e per scaricare l'SDK più recente, visitare adaptivecards.io.

Ad esempio:

const card = CardFactory.adaptiveCard({
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [
      {
         "type": "TextBlock",
         "text": "Default text input"
      }
  ],
  "actions": [
      {
         "type": "Action.Submit",
         "title": "OK"
      }
  ]
});

Restituisce un allegato per una scheda di animazione.

static function animationCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<AnimationCard>): Attachment

Parametri

Restituisce

Allegato.

Restituisce un allegato per una scheda audio.

static function audioCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<AudioCard>): Attachment

Parametri

Restituisce

Allegato.

Restituisce un allegato per una scheda hero.

static function heroCard(title: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<HeroCard>): Attachment

Parametri

Restituisce

Allegato.

Commenti

Le carte eroe tendono ad avere un'immagine dominante e a larghezza intera. I canali in genere eseguono il rendering del testo e dei pulsanti della scheda sotto l'immagine.

Ad esempio:

const card = CardFactory.heroCard(
     'White T-Shirt',
     ['https://example.com/whiteShirt.jpg'],
     ['buy']
);

Restituisce un allegato per una scheda hero.

static function heroCard(title: string, text: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<HeroCard>): Attachment

Parametri

Restituisce

Allegato.

Commenti

Le carte eroe tendono ad avere un'immagine dominante e a larghezza intera. I canali in genere eseguono il rendering del testo e dei pulsanti della scheda sotto l'immagine. Ad esempio:

const card = CardFactory.heroCard(
     'White T-Shirt',
     ['https://example.com/whiteShirt.jpg'],
     ['buy']
);

Restituisce una matrice formattata correttamente delle immagini della scheda.

static function images(images: string | CardImage[] | undefined): CardImage[]

Parametri

Restituisce

Matrice formattata correttamente delle immagini della scheda.

Restituisce una matrice formattata correttamente degli oggetti URL multimediali.

static function media(links: string | MediaUrl[] | undefined): MediaUrl[]

Parametri

Restituisce

Matrice formattata correttamente di oggetti URL multimediali.

Restituisce un allegato per una scheda connettore Office 365.

static function o365ConnectorCard(card: O365ConnectorCard): Attachment

Parametri

Restituisce

Allegato.

Commenti

Ad esempio:

const card = CardFactory.o365ConnectorCard({
  "title": "card title",
  "text": "card text",
  "summary": "O365 card summary",
  "themeColor": "#E67A9E",
  "sections": [
      {
          "title": "**section title**",
          "text": "section text",
          "activityTitle": "activity title",
      }
  ]
});

Restituisce un allegato per una scheda OAuth.

static function oauthCard(connectionName: string, title: string, text?: string, link?: string, tokenExchangeResource?: TokenExchangeResource): Attachment

Parametri

Restituisce

Allegato.

Commenti

Le schede OAuth supportano il servizio Single Sign-On (SSO) di Bot Framework.

Restituisce un allegato per una scheda di ricezione.

static function receiptCard(card: ReceiptCard): Attachment

Parametri

Restituisce

Allegato.

Restituisce un allegato per una scheda di accesso.

static function signinCard(title: string, url: string, text?: string): Attachment

Parametri

Restituisce

Allegato.

Commenti

Per i canali che non supportano in modo nativo le schede di accesso, viene eseguito il rendering di un messaggio alternativo.

Restituisce un allegato per una scheda di anteprima.

static function thumbnailCard(title: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<ThumbnailCard>): Attachment

Parametri

Restituisce

Allegato.

Commenti

Le schede di anteprima sono simili alle schede hero, ma invece di un'immagine a larghezza completa, vengono in genere visualizzate con una versione di anteprima più piccola dell'immagine. I canali in genere eseguono il rendering del testo della scheda su un lato dell'immagine, con i pulsanti visualizzati sotto la scheda.

Restituisce un allegato per una scheda di anteprima.

static function thumbnailCard(title: string, text: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<ThumbnailCard>): Attachment

Parametri

Restituisce

Allegato.

Commenti

Le schede di anteprima sono simili alle schede hero, ma invece di un'immagine a larghezza completa, vengono in genere visualizzate con una versione di anteprima più piccola dell'immagine. I canali in genere eseguono il rendering del testo della scheda su un lato dell'immagine, con i pulsanti visualizzati sotto la scheda.

Restituisce un allegato per una scheda video.

static function videoCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<VideoCard>): Attachment

Parametri

Restituisce

Allegato.