Che cos'è HostConfig?
HostConfig è un oggetto di configurazione tra piattaforme che specifica il modo in cui un renderer di schede adattive genera l'interfaccia utente.
Ciò consente di condividere le proprietà indipendenti dalla piattaforma tra i renderer in piattaforme e dispositivi diversi. Consente inoltre di creare strumenti che danno un'idea dell'aspetto che avrebbe la scheda per un determinato ambiente.
Vedi un file HostConfig.json di esempio per comprenderne a grandi linee il contenuto.
AdaptiveCardConfig- Opzioni di livello principale perAdaptiveCardsActionsConfig- Opzioni per elementiActionContainerStylesConfig- Controlla l'applicazione dello stile per i contenitori predefiniti e di enfasiFactSetConfig- Controlla la visualizzazione degli elementiFactSetFontSizesConfig- Controlla la metrica relativa alle dimensioni del carattere per i diversi stili di testoFontWeightsConfig- Controlla la metrica relativa allo spessore del carattereForegroundColorsConfig- Controlla i vari colori del carattereImageSetConfig- Controlla la modalità di visualizzazione degli elementiImageSetImageSizesConfig- Controlla le dimensioni degli elementiImageInputsConfig- Controlla la modalità di visualizzazione di etichette e messaggi di erroreLabelConfig- Controlla la modalità di visualizzazione delle etichetteInputLabelConfig- Controlla la modalità di visualizzazione delle etichette obbligatorie o facoltative
ErrorMessageConfig- Controlla la modalità di visualizzazione dei messaggi di errore
MediaConfig- Controlla la visualizzazione e il comportamento degli elementiMediaSeparatorConfig- Controlla la modalità di visualizzazione dei separatoriShowCardConfig- Controlla il comportamento e lo stile diAction.ShowCardSpacingsConfig- Controlla la disposizione degli elementiTextBlockConfig- Parametri che controllano la visualizzazione del testo
Configurazione delle schede
AdaptiveCardConfig
Opzioni di livello principale per AdaptiveCards
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| allowCustomStyle | boolean |
No, impostazione predefinita: true |
Controlla se è consentito lo stile personalizzato | 1.0 |
| supportsInteractivity | boolean |
No, impostazione predefinita: true |
Controlla se è consentito richiamare gli elementi Action interattivi |
1.0 |
| imageBaseUrl | string |
No | URL di base da usare durante il caricamento delle risorse | 1.0 |
| fontFamily | string |
No, impostazione predefinita: "Calibri" |
Tipo di carattere da usare per il rendering del testo | 1.0 |
| actions | object |
No | Opzioni per gli elementi Action |
1.0 |
| adaptiveCard | object |
No | Opzioni di livello principale per AdaptiveCards |
1.0 |
| containerStyles | object |
No | Controlla l'applicazione dello stile per i contenitori predefiniti e di enfasi | 1.0 |
| imageSizes | object |
No | Controlla le dimensioni degli elementi Image |
1.0 |
| imageSet | object |
No | Controlla la modalità di visualizzazione degli elementi ImageSet |
1.0 |
| factSet | object |
No | Controlla la visualizzazione degli elementi FactSet |
1.0 |
| fontSizes | object |
No | Controlla la metrica relativa alle dimensioni del carattere per i diversi stili di testo | 1.0 |
| fontWeights | object |
No | Controlla la metrica relativa allo spessore del carattere | 1.0 |
| spacing | object |
No | Controlla la disposizione degli elementi | 1.0 |
| separator | object |
No | Controlla la modalità di visualizzazione dei separatori | 1.0 |
| media | object |
No | Controlla la visualizzazione e il comportamento degli elementi Media |
1.1 |
ActionsConfig
Opzioni per gli elementi Action
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| actionsOrientation | string |
No, impostazione predefinita: "horizontal" |
Controlla la disposizione dei pulsanti | 1.0 |
| actionAlignment | string |
No, impostazione predefinita: "stretch" |
Controlla il layout dei pulsanti | 1.0 |
| buttonSpacing | integer |
No, impostazione predefinita: 10 |
Controlla la quantità di spaziatura da usare tra i pulsanti | 1.0 |
| maxActions | integer |
No, impostazione predefinita: 5 |
Controlla il numero di azioni consentite in totale | 1.0 |
| spacing | string |
No, impostazione predefinita: "default" |
Controlla la spaziatura complessiva dell'elemento action | 1.0 |
| showCard | object |
No | Controlla il comportamento e lo stile di Action.ShowCard |
1.0 |
| iconPlacement | string |
No, impostazione predefinita: "aboveTitle" |
Controlla dove posizionare l'icona dell'azione | 1.0 |
| iconSize | integer |
No, impostazione predefinita: 30 |
Controlla le dimensioni dell'icona dell'azione | 1.0 |
ContainerStylesConfig
Controlla l'applicazione dello stile per i contenitori predefiniti e di enfasi
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| default | object |
No | Stile contenitore predefinito | 1.0 |
| emphasis | object |
No | Stile contenitore da usare per l'enfasi | 1.0 |
FactSetConfig
Controlla la visualizzazione degli elementi FactSet
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| title | object |
No, impostazione predefinita: {"weight":"bolder","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":150} |
Parametri che controllano la visualizzazione del testo | 1.0 |
| value | object |
No, impostazione predefinita: {"weight":"default","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":0} |
Parametri che controllano la visualizzazione del testo | 1.0 |
| spacing | integer |
No, impostazione predefinita: 10 |
1.0 |
FontSizesConfig
Controlla la metrica relativa alle dimensioni del carattere per i diversi stili di testo
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| small | integer |
No, impostazione predefinita: 10 |
Dimensione piccola dei caratteri | 1.0 |
| default | integer |
No, impostazione predefinita: 12 |
Dimensioni del carattere predefinite | 1.0 |
| medium | integer |
No, impostazione predefinita: 14 |
Dimensione media dei caratteri | 1.0 |
| large | integer |
No, impostazione predefinita: 17 |
Dimensione grande dei caratteri | 1.0 |
| extraLarge | integer |
No, impostazione predefinita: 20 |
Dimensione molto grande dei caratteri | 1.0 |
FontWeightsConfig
Controlla la metrica relativa allo spessore del carattere
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| lighter | integer |
No, impostazione predefinita: 200 |
1.0 | |
| default | integer |
No, impostazione predefinita: 400 |
1.0 | |
| bolder | integer |
No, impostazione predefinita: 800 |
1.0 |
ForegroundColorsConfig
Controlla i vari colori del carattere
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| default | object |
No, impostazione predefinita: {"default":"#FF000000","subtle":"#B2000000"} |
1.0 | |
| accent | object |
No, impostazione predefinita: {"default":"#FF0000FF","subtle":"#B20000FF"} |
1.0 | |
| dark | object |
No, impostazione predefinita: {"default":"#FF101010","subtle":"#B2101010"} |
1.0 | |
| light | object |
No, impostazione predefinita: {"default":"#FFFFFFFF","subtle":"#B2FFFFFF"} |
1.0 | |
| good | object |
No, impostazione predefinita: {"default":"#FF008000","subtle":"#B2008000"} |
1.0 | |
| warning | object |
No, impostazione predefinita: {"default":"#FFFFD700","subtle":"#B2FFD700"} |
1.0 | |
| attention | object |
No, impostazione predefinita: {"default":"#FF8B0000","subtle":"#B28B0000"} |
1.0 |
ImageSetConfig
Controlla la modalità di visualizzazione degli elementi ImageSet
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| imageSize | string |
No, impostazione predefinita: "auto" |
Controlla le dimensioni delle singole immagini | 1.0 |
| maxImageHeight | integer |
No, impostazione predefinita: 100 |
Vincola l'altezza dell'immagine a questo valore | 1.0 |
ImageSizesConfig
Controlla le dimensioni degli elementi Image
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| small | integer |
No, impostazione predefinita: 80 |
Valore relativo alle dimensioni immagine piccole | 1.0 |
| medium | integer |
No, impostazione predefinita: 120 |
Valore relativo alle dimensioni immagine medie | 1.0 |
| large | integer |
No, impostazione predefinita: 180 |
Valore relativo alle dimensioni immagine grandi | 1.0 |
InputsConfig
Controlla la modalità di visualizzazione di etichette e messaggi di errore
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| label | LabelConfig |
No | Controlla la modalità di visualizzazione delle etichette | 1.3 |
| errorMessage | ErrorMessageConfig |
No | Controlla la modalità di visualizzazione dei messaggi di errore | 1.3 |
LabelConfig
Controlla la modalità di visualizzazione delle etichette
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| requiredInputs | InputLabelConfig |
No | Controlla la modalità di visualizzazione delle etichette per gli input obbligatori | 1.3 |
| optionalInputs | InputLabelConfig |
No | Controlla la modalità di visualizzazione delle etichette per gli input facoltativi | 1.3 |
| spacing | string |
No, impostazione predefinita: "default" |
Spaziatura tra l'etichetta e l'input | 1.3 |
InputLabelConfig
Controlla la modalità di visualizzazione delle etichette obbligatorie o facoltative
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| color | string |
No, impostazione predefinita: "default" |
Colore del carattere dell'etichetta (il rendering del suffisso ha sempre il colore attention) |
1.3 |
| isSubtle | bool |
No, impostazione predefinita: false |
Definisce se usare il colore di primo piano subtle |
1.3 |
| size | string |
No, impostazione predefinita: "default" |
Dimensione del carattere dell'etichetta da visualizzare | 1.3 |
| suffix | string |
No, impostazione predefinita: "*" |
Suffisso da visualizzare alla fine dell'etichetta per gli input obbligatori. Se non è definito alcun valore, viene aggiunto un asterisco * all'etichetta |
1.3 |
| weight | string |
No, impostazione predefinita: "default" |
Spessore del carattere dell'etichetta | 1.3 |
ErrorMessageConfig
Controlla la modalità di visualizzazione dei messaggi di errore. I messaggi di errore vengono sempre visualizzati con il colore attention.
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| spacing | string |
No, impostazione predefinita: "default" |
Spaziatura tra l'input e il messaggio di errore | 1.3 |
| size | string |
No, impostazione predefinita: "default" |
Dimensione del carattere del messaggio di errore | 1.3 |
| weight | string |
No, impostazione predefinita: "default" |
Spessore del carattere del messaggio di errore | 1.3 |
MediaConfig
Controlla la visualizzazione e il comportamento degli elementi Media
Introdotta nella versione 1.1
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| defaultPoster | string |
No | URI dell'immagine da visualizzare quando il pulsante Riproduci non è stato richiamato | 1.1 |
| playButton | string |
No | Immagine da visualizzare come pulsante Riproduci | 1.1 |
| allowInlinePlayback | boolean |
No, impostazione predefinita: true |
Indica se visualizzare gli elementi multimediali inline o se richiamarli esternamente | 1.1 |
SeparatorConfig
Controlla la modalità di visualizzazione dei separatori
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| lineThickness | integer |
No, impostazione predefinita: 1 |
Spessore della linea di separazione | 1.0 |
| lineColor | string,null |
No, impostazione predefinita: #B2000000 |
Colore da usare per tracciare la linea di separazione | 1.0 |
ShowCardConfig
Controlla il comportamento e lo stile di Action.ShowCard
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| actionMode | string |
No, impostazione predefinita: "inline" |
Controlla la modalità di visualizzazione della scheda | 1.0 |
| style | object |
No, impostazione predefinita: emphasis |
Controlla lo stile di un contenitore | 1.0 |
| inlineTopMargin | integer |
No, impostazione predefinita: 16 |
Quantità di margine da usare per la visualizzazione della scheda | 1.0 |
SpacingsConfig
Controlla la disposizione degli elementi
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| small | integer |
No, impostazione predefinita: 3 |
Valore relativo alla spaziatura piccola | 1.0 |
| default | integer |
No, impostazione predefinita: 8 |
Valore relativo alla spaziatura predefinita | 1.0 |
| medium | integer |
No, impostazione predefinita: 20 |
Valore relativo alla spaziatura media | 1.0 |
| large | integer |
No, impostazione predefinita: 30 |
Valore relativo alla spaziatura grande | 1.0 |
| extraLarge | integer |
No, impostazione predefinita: 40 |
Valore relativo alla spaziatura molto grande | 1.0 |
| padding | integer |
No, impostazione predefinita: 20 |
Valore relativo alla spaziatura interna | 1.0 |
TextBlockConfig
Parametri che controllano la visualizzazione del testo
| Proprietà | Type | Obbligatorio | Descrizione | Versione |
|---|---|---|---|---|
| size | string |
No, impostazione predefinita: "default" |
Dimensioni del carattere da usare quando non è presente la specifica di una scheda | 1.0 |
| weight | string |
No, impostazione predefinita: "normal" |
Spessore del carattere da usare quando non è presente la specifica di una scheda | 1.0 |
| color | string |
No, impostazione predefinita: "default" |
Colore del carattere da usare quando non è presente la specifica di una scheda | 1.0 |
| isSubtle | boolean |
No, impostazione predefinita: false |
Indica se il testo deve essere impercettibile se non è presente la specifica di una scheda | 1.0 |
| wrap | boolean |
No, impostazione predefinita: true |
Indica se il testo deve andare a capo se non è presente la specifica di una scheda | 1.0 |
| maxWidth | integer |
No, impostazione predefinita: 0 |
Larghezza massima da usare se non è presente la specifica di una scheda | 1.0 |