O que é o HostConfig?

  • Artigo

HostConfig é um objeto de configuração multiplataforma que especifica como um renderizador de cartão adaptável gera a interface do usuário.

Isso permite que as propriedades independentes de plataforma sejam compartilhadas entre os renderizadores em diferentes plataformas e dispositivos. Isso também permite que as ferramentas sejam criadas, o que lhe dá uma ideia da aparência que o cartão teria em um determinado ambiente.

Veja um exemplo de HostConfig.json para ter uma noção de seu conteúdo.

Configuração do cartão

AdaptiveCardConfig

Opções TopLevel para AdaptiveCards

Propriedade Type Obrigatório Descrição Versão
allowCustomStyle boolean Não, padrão: true Controla se estilo personalizado é permitido 1.0
supportsInteractivity boolean Não, padrão: true Controla se os Actions interativos podem ou não ser invocados 1.0
imageBaseUrl string Não URL base a ser usada ao carregar recursos 1.0
fontFamily string Não, padrão: "Calibri" Face da fonte a ser usada ao renderizar o texto 1.0
actions object Não Opções para Actions 1.0
adaptiveCard object Não Opções TopLevel para AdaptiveCards 1.0
containerStyles object Não Controla o estilo de contêineres padrão e de ênfase 1.0
imageSizes object Não Controla os tamanhos de Image 1.0
imageSet object Não Controla como os ImageSets são exibidos 1.0
factSet object Não Controla a exibição de FactSets 1.0
fontSizes object Não Controla as métricas de tamanho da fonte para diferentes estilos de texto 1.0
fontWeights object Não Controla as métricas de espessura da fonte 1.0
spacing object Não Controla como os elementos devem ser dispostos 1.0
separator object Não Controla como os separadores são exibidos 1.0
media object Não Controla a exibição e o comportamento de elementos Media 1,1

ActionsConfig

Opções para Actions

Propriedade Type Obrigatório Descrição Versão
actionsOrientation string Não, padrão: "horizontal" Controla como os botões são dispostos 1.0
actionAlignment string Não, padrão: "stretch" Controla o layout dos botões 1.0
buttonSpacing integer Não, padrão: 10 Controla quanto espaçamento deve ser usado entre os botões 1.0
maxActions integer Não, padrão: 5 Controla quantas ações são permitidas no total 1.0
spacing string Não, padrão: "default" Controla o espaçamento geral do elemento de ação 1.0
showCard object Não Controla o comportamento e o estilo de Action.ShowCard 1.0
iconPlacement string Não, padrão: "aboveTitle" Controla onde posicionar o ícone de ação 1.0
iconSize integer Não, padrão: 30 Controla o tamanho do ícone de ação 1.0

ContainerStylesConfig

Controla o estilo de contêineres padrão e de ênfase

Propriedade Type Obrigatório Descrição Versão
default object Não Estilo de contêiner padrão 1.0
emphasis object Não Estilo de contêiner a ser usado para ênfase 1.0

FactSetConfig

Controla a exibição de FactSets

Propriedade Type Obrigatório Descrição Versão
title object Não, padrão: {"weight":"bolder","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":150} Parâmetros que controlam a exibição do texto 1.0
value object Não, padrão: {"weight":"default","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":0} Parâmetros que controlam a exibição do texto 1.0
spacing integer Não, padrão: 10   1.0

FontSizesConfig

Controla as métricas de tamanho da fonte para diferentes estilos de texto

Propriedade Type Obrigatório Descrição Versão
small integer Não, padrão: 10 Tamanho pequeno da fonte 1.0
default integer Não, padrão: 12 Tamanho da fonte padrão 1.0
medium integer Não, padrão: 14 Tamanho médio da fonte 1.0
large integer Não, padrão: 17 Tamanho grande da fonte 1.0
extraLarge integer Não, padrão: 20 Tamanho extragrande da fonte 1.0

FontWeightsConfig

Controla as métricas de espessura da fonte

Propriedade Type Obrigatório Descrição Versão
lighter integer Não, padrão: 200   1.0
default integer Não, padrão: 400   1.0
bolder integer Não, padrão: 800   1.0

ForegroundColorsConfig

Controla várias cores de fonte

Propriedade Type Obrigatório Descrição Versão
default object Não, padrão: {"default":"#FF000000","subtle":"#B2000000"}   1.0
accent object Não, padrão: {"default":"#FF0000FF","subtle":"#B20000FF"}   1.0
dark object Não, padrão: {"default":"#FF101010","subtle":"#B2101010"}   1.0
light object Não, padrão: {"default":"#FFFFFFFF","subtle":"#B2FFFFFF"}   1.0
good object Não, padrão: {"default":"#FF008000","subtle":"#B2008000"}   1.0
warning object Não, padrão: {"default":"#FFFFD700","subtle":"#B2FFD700"}   1.0
attention object Não, padrão: {"default":"#FF8B0000","subtle":"#B28B0000"}   1.0

ImageSetConfig

Controla como os ImageSets são exibidos

Propriedade Type Obrigatório Descrição Versão
imageSize string Não, padrão: "auto" Controla o dimensionamento individual de imagens 1.0
maxImageHeight integer Não, padrão: 100 Restringe a altura da imagem a esse valor 1.0

ImageSizesConfig

Controla os tamanhos de Image

Propriedade Type Obrigatório Descrição Versão
small integer Não, padrão: 80 Valor de tamanho pequeno da imagem 1.0
medium integer Não, padrão: 120 Valor de tamanho médio da imagem 1.0
large integer Não, padrão: 180 Valor de tamanho grande da imagem 1.0

InputsConfig

Controla como os rótulos e as mensagens de erro são exibidos

Propriedade Type Obrigatório Descrição Versão
label LabelConfig Não Controla como os rótulos são exibidos 1,3
errorMessage ErrorMessageConfig Não Controla como as mensagens de erro são exibidas 1,3

LabelConfig

Controla como os rótulos são exibidos

Propriedade Type Obrigatório Descrição Versão
requiredInputs InputLabelConfig Não Controla como os rótulos das entradas obrigatórias são exibidos 1,3
optionalInputs InputLabelConfig Não Controla como os rótulos das entradas opcionais são exibidos 1,3
spacing string Não, padrão: "default" Espaçamento entre o rótulo e a entrada 1,3

InputLabelConfig

Controla como os rótulos obrigatórios ou opcionais são exibidos

Propriedade Type Obrigatório Descrição Versão
color string Não, padrão: "default" Cor da fonte do rótulo (o sufixo sempre é renderizado na cor attention) 1,3
isSubtle bool Não, padrão: false Define se a cor de primeiro plano subtle deve ser usada 1,3
size string Não, padrão: "default" Tamanho da fonte do rótulo a ser exibido 1,3
suffix string Não, padrão: "*" Sufixo a ser exibido no fim do rótulo para entradas obrigatórias. Se nenhum for definido, um asterisco * será anexado ao rótulo 1,3
weight string Não, padrão: "default" Espessura da fonte do rótulo 1,3

ErrorMessageConfig

Controla como as mensagens de erro são exibidas. As mensagens de erro sempre são exibidas com a cor attention.

Propriedade Type Obrigatório Descrição Versão
spacing string Não, padrão: "default" Espaçamento entre a entrada e a mensagem de erro 1,3
size string Não, padrão: "default" Tamanho da fonte da mensagem de erro 1,3
weight string Não, padrão: "default" Espessura da fonte da mensagem de erro 1,3

MediaConfig

Controla a exibição e o comportamento de elementos Media

Introduzido na versão 1.1

Propriedade Type Obrigatório Descrição Versão
defaultPoster string Não URI da imagem a ser exibida quando o botão de reprodução não foi invocado 1,1
playButton string Não Imagem a ser exibida como botão de reprodução 1,1
allowInlinePlayback boolean Não, padrão: true Se deseja exibir a mídia embutida ou invocar externamente 1,1

SeparatorConfig

Controla como os separadores são exibidos

Propriedade Type Obrigatório Descrição Versão
lineThickness integer Não, padrão: 1 Espessura da linha separadora 1.0
lineColor string,null Não, padrão: #B2000000 Cor a ser usada ao desenhar a linha separadora 1.0

ShowCardConfig

Controla o comportamento e o estilo de Action.ShowCard

Propriedade Type Obrigatório Descrição Versão
actionMode string Não, padrão: "inline" Controla como o cartão é exibido 1.0
style object Não, padrão: emphasis Controla o estilo de um contêiner 1.0
inlineTopMargin integer Não, padrão: 16 Quantidade de margem a ser usada ao exibir o cartão 1.0

SpacingsConfig

Controla como os elementos devem ser dispostos

Propriedade Type Obrigatório Descrição Versão
small integer Não, padrão: 3 Valor de espaçamento pequeno 1.0
default integer Não, padrão: 8 Valor de espaçamento padrão 1.0
medium integer Não, padrão: 20 Valor de espaçamento médio 1.0
large integer Não, padrão: 30 Valor de espaçamento grande 1.0
extraLarge integer Não, padrão: 40 Valor de espaçamento extragrande 1.0
padding integer Não, padrão: 20 Valor de preenchimento 1.0

TextBlockConfig

Parâmetros que controlam a exibição do texto

Propriedade Type Obrigatório Descrição Versão
size string Não, padrão: "default" Tamanho da fonte a ser usado quando um cartão não o especificar 1.0
weight string Não, padrão: "normal" Espessura da fonte a ser usada quando um cartão não a especificar 1.0
color string Não, padrão: "default" Cor da fonte a ser usada quando um cartão não a especificar 1.0
isSubtle boolean Não, padrão: false O texto deverá ser sutil se um cartão não especificar esse aspecto 1.0
wrap boolean Não, padrão: true O texto deverá ou não ter quebras automáticas de linha se um cartão não especificar esse aspecto 1.0
maxWidth integer Não, padrão: 0 Largura máxima a ser usada se um cartão não a especificar 1.0