HostConfig란 무엇인가요?What is HostConfig?

HostConfig는 적응형 카드 렌더러가 UI를 생성하는 방법을 지정하는 플랫폼 간 구성 개체입니다.HostConfig is a cross-platform configuration object that specifies how an Adaptive Card Renderer generates UI.

이를 사용하면 플랫폼에 독립적인 속성을 다양한 플랫폼 및 디바이스의 렌더러 간에 공유할 수 있습니다.This allows properties which are platform agnostic to be shared among renderers on different platforms and devices. 특정 환경에 대한 카드의 모양과 느낌에 대한 아이디어를 제공하는 도구를 만들 수도 있습니다.It also allows tooling to be created which gives you an idea of the look and feel that card would have for a given environment.

콘텐츠에 대한 느낌을 얻으려면 샘플 HostConfig.json을 참조하세요.See a sample HostConfig.json to get a feeling for its contents.


카드 구성Card Configuration

AdaptiveCardConfigAdaptiveCardConfig

AdaptiveCards의 최상위 옵션Toplevel options for AdaptiveCards

속성Property 형식Type 필수Required 설명Description 버전Version
allowCustomStyleallowCustomStyle boolean 아니요. 기본값: trueNo, default: true 사용자 지정 스타일이 허용되는지 여부 제어Controls whether custom styling is allowed 1.01.0
supportsInteractivitysupportsInteractivity boolean 아니요. 기본값: trueNo, default: true 대화형 Action을 호출할 수 있는지 여부 제어Control whether interactive Actions are allowed to be invoke 1.01.0
imageBaseUrlimageBaseUrl string 아니요No 리소스를 로드할 때 사용되는 기준 URLBase URL to be used when loading resources 1.01.0
fontFamilyfontFamily string 아니요. 기본값: "Calibri"No, default: "Calibri" 텍스트를 렌더링할 때 사용할 글꼴Font face to use when rendering text 1.01.0
actionsactions object 아니요No Action의 옵션Options for Actions 1.01.0
adaptiveCardadaptiveCard object 아니요No AdaptiveCards의 최상위 옵션Toplevel options for AdaptiveCards 1.01.0
containerStylescontainerStyles object 아니요No 기본 및 강조 컨테이너의 스타일 지정 제어Controls styling for default and emphasis containers 1.01.0
imageSizesimageSizes object 아니요No Image 크기 제어Controls Image sizes 1.01.0
imageSetimageSet object 아니요No ImageSet 표시 방법 제어Controls how ImageSets are displayed 1.01.0
factSetfactSet object 아니요No FactSet의 표시 제어Controls the display of FactSets 1.01.0
fontSizesfontSizes object 아니요No 다양한 텍스트 스타일의 글꼴 크기 메트릭 제어Controls font size metrics for different text styles 1.01.0
fontWeightsfontWeights object 아니요No 글꼴 두께 메트릭 제어Controls font weight metrics 1.01.0
spacingspacing object 아니요No 요소 배치 방법 제어Controls how elements are to be laid out 1.01.0
separatorseparator object 아니요No 구분 기호 표시 방법 제어Controls how separators are displayed 1.01.0
mediamedia object 아니요No Media 요소의 표시 및 동작 제어Controls the display and behavior of Media elements 1.11.1

ActionsConfigActionsConfig

Action의 옵션Options for Actions

속성Property 형식Type 필수Required 설명Description 버전Version
actionsOrientationactionsOrientation string 아니요. 기본값: "horizontal"No, default: "horizontal" 단추 배치 방법 제어Controls how buttons are laid out 1.01.0
actionAlignmentactionAlignment string 아니요. 기본값: "stretch"No, default: "stretch" 단추 레이아웃 제어Control layout of buttons 1.01.0
buttonSpacingbuttonSpacing integer 아니요. 기본값: 10No, default: 10 단추 사이에 사용할 간격 크기 제어Controls how much spacing to use between buttons 1.01.0
maxActionsmaxActions integer 아니요. 기본값: 5No, default: 5 허용되는 총 작업 수 제어Controls how many actions are allowed in total 1.01.0
spacingspacing string 아니요. 기본값: "default"No, default: "default" 작업 요소의 전체 간격 제어Controls overall spacing of action element 1.01.0
showCardshowCard object 아니요No Action.ShowCard의 동작 및 스타일 제어Controls behavior and styling of Action.ShowCard 1.01.0
iconPlacementiconPlacement string 아니요. 기본값: "aboveTitle"No, default: "aboveTitle" 작업 아이콘을 배치할 위치 제어Controls where to place the action icon 1.01.0
iconSizeiconSize integer 아니요. 기본값: 30No, default: 30 작업 아이콘의 크기 제어Controls size of action icon 1.01.0

ContainerStylesConfigContainerStylesConfig

기본 및 강조 컨테이너의 스타일 지정 제어Controls styling for default and emphasis containers

속성Property 형식Type 필수Required 설명Description 버전Version
defaultdefault object 아니요No 기본 컨테이너 스타일Default container style 1.01.0
emphasisemphasis object 아니요No 강조에 사용할 컨테이너 스타일Container style to use for emphasis 1.01.0

FactSetConfigFactSetConfig

FactSet의 표시 제어Controls the display of FactSets

속성Property 형식Type 필수Required 설명Description 버전Version
titletitle object 아니요. 기본값: {"weight":"bolder","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":150}No, default: {"weight":"bolder","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":150} 텍스트 표시를 제어하는 매개 변수Parameters controlling the display of text 1.01.0
valuevalue object 아니요. 기본값: {"weight":"default","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":0}No, default: {"weight":"default","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":0} 텍스트 표시를 제어하는 매개 변수Parameters controlling the display of text 1.01.0
spacingspacing integer 아니요. 기본값: 10No, default: 10   1.01.0

FontSizesConfigFontSizesConfig

다양한 텍스트 스타일의 글꼴 크기 메트릭 제어Controls font size metrics for different text styles

속성Property 형식Type 필수Required 설명Description 버전Version
smallsmall integer 아니요. 기본값: 10No, default: 10 작은 글꼴 크기Small font size 1.01.0
defaultdefault integer 아니요. 기본값: 12No, default: 12 기본 글꼴 크기Default font size 1.01.0
mediummedium integer 아니요. 기본값: 14No, default: 14 중간 글꼴 크기Medium font size 1.01.0
largelarge integer 아니요. 기본값: 17No, default: 17 큰 글꼴 크기Large font size 1.01.0
extraLargeextraLarge integer 아니요. 기본값: 20No, default: 20 매우 큰 글꼴 크기Extra large font size 1.01.0

FontWeightsConfigFontWeightsConfig

글꼴 두께 메트릭 제어Controls font weight metrics

속성Property 형식Type 필수Required 설명Description 버전Version
lighterlighter integer 아니요. 기본값: 200No, default: 200   1.01.0
defaultdefault integer 아니요. 기본값: 400No, default: 400   1.01.0
bolderbolder integer 아니요. 기본값: 800No, default: 800   1.01.0

ForegroundColorsConfigForegroundColorsConfig

다양한 글꼴 색 제어Controls various font colors

속성Property 형식Type 필수Required 설명Description 버전Version
defaultdefault object 아니요. 기본값: {"default":"#FF000000","subtle":"#B2000000"}No, default: {"default":"#FF000000","subtle":"#B2000000"}   1.01.0
accentaccent object 아니요. 기본값: {"default":"#FF0000FF","subtle":"#B20000FF"}No, default: {"default":"#FF0000FF","subtle":"#B20000FF"}   1.01.0
darkdark object 아니요. 기본값: {"default":"#FF101010","subtle":"#B2101010"}No, default: {"default":"#FF101010","subtle":"#B2101010"}   1.01.0
lightlight object 아니요. 기본값: {"default":"#FFFFFFFF","subtle":"#B2FFFFFF"}No, default: {"default":"#FFFFFFFF","subtle":"#B2FFFFFF"}   1.01.0
goodgood object 아니요. 기본값: {"default":"#FF008000","subtle":"#B2008000"}No, default: {"default":"#FF008000","subtle":"#B2008000"}   1.01.0
warningwarning object 아니요. 기본값: {"default":"#FFFFD700","subtle":"#B2FFD700"}No, default: {"default":"#FFFFD700","subtle":"#B2FFD700"}   1.01.0
attentionattention object 아니요. 기본값: {"default":"#FF8B0000","subtle":"#B28B0000"}No, default: {"default":"#FF8B0000","subtle":"#B28B0000"}   1.01.0

ImageSetConfigImageSetConfig

ImageSet 표시 방법 제어Controls how ImageSets are displayed

속성Property 형식Type 필수Required 설명Description 버전Version
imageSizeimageSize string 아니요. 기본값: "auto"No, default: "auto" 개별 이미지 크기 제어Controls individual image sizing 1.01.0
maxImageHeightmaxImageHeight integer 아니요. 기본값: 100No, default: 100 이미지 높이를 이 값으로 제한Constrain image height to this value 1.01.0

ImageSizesConfigImageSizesConfig

Image 크기 제어Controls Image sizes

속성Property 형식Type 필수Required 설명Description 버전Version
smallsmall integer 아니요. 기본값: 80No, default: 80 작은 이미지 크기 값Small image size value 1.01.0
mediummedium integer 아니요. 기본값: 120No, default: 120 중간 이미지 크기 값Medium image size value 1.01.0
largelarge integer 아니요. 기본값: 180No, default: 180 큰 이미지 크기 값Large image size value 1.01.0

InputsConfigInputsConfig

레이블 및 오류 메시지 표시 방법 제어Controls how labels and error messages are displayed

속성Property 형식Type 필수Required 설명Description 버전Version
labellabel LabelConfig 아니요No 레이블 표시 방법 제어Controls how labels are displayed 1.31.3
errorMessageerrorMessage ErrorMessageConfig 아니요No 오류 메시지 표시 방법 제어Controls how error messages are displayed 1.31.3

LabelConfigLabelConfig

레이블 표시 방법 제어Controls how labels are displayed

속성Property 형식Type 필수Required 설명Description 버전Version
requiredInputsrequiredInputs InputLabelConfig 아니요No 필수 입력의 레이블 표시 방법 제어Controls how labels for required inputs are displayed 1.31.3
optionalInputsoptionalInputs InputLabelConfig 아니요No 옵션 입력의 레이블 표시 방법 제어Controls how labels for optional inputs are displayed 1.31.3
spacingspacing string 아니요. 기본값: "default"No, default: "default" 레이블과 입력 사이의 간격Spacing between the label and the input 1.31.3

InputLabelConfigInputLabelConfig

필수 또는 옵션 레이블 표시 방법 제어Controls how required or optional labels are displayed

속성Property 형식Type 필수Required 설명Description 버전Version
colorcolor string 아니요. 기본값: "default"No, default: "default" 레이블의 글꼴 색상(접미사는 항상 attention 색상으로 렌더링됨)Font color of the label (the suffix is always rendered in attention color) 1.31.3
isSubtleisSubtle bool 아니요. 기본값: falseNo, default: false subtle 전경색 사용 여부 정의Defines whether to use the subtle foreground color 1.31.3
sizesize string 아니요. 기본값: "default"No, default: "default" 표시할 레이블의 글꼴 크기Font size of the label to be displayed 1.31.3
접미사suffix string 아니요. 기본값: "*"No, default: "*" 필수 입력의 레이블 끝에 표시되는 접미사입니다.Suffix to be displayed at the end of the label for required inputs. 정의된 항목이 없으면 레이블에 별표(*)가 추가됩니다.If none is defined, an asterisk * is appended to the label 1.31.3
weightweight string 아니요. 기본값: "default"No, default: "default" 레이블의 글꼴 두께Font weight of the label 1.31.3

ErrorMessageConfigErrorMessageConfig

오류 메시지 표시 방법 제어.Controls how error messages are displayed. 오류 메시지는 항상 attention 색상으로 표시됩니다.Error messages are always displayed with the attention color.

속성Property 형식Type 필수Required 설명Description 버전Version
spacingspacing string 아니요. 기본값: "default"No, default: "default" 입력과 오류 메시지 사이의 간격Spacing between the input and the error message 1.31.3
sizesize string 아니요. 기본값: "default"No, default: "default" 오류 메시지의 글꼴 크기Font size of the error message 1.31.3
weightweight string 아니요. 기본값: "default"No, default: "default" 오류 메시지의 글꼴 두께Font weight of the error message 1.31.3

MediaConfigMediaConfig

Media 요소의 표시 및 동작 제어Controls the display and behavior of Media elements

버전 1.1에서 도입됨Introduced in version 1.1

속성Property 형식Type 필수Required 설명Description 버전Version
defaultPosterdefaultPoster string 아니요No 재생 단추가 호출되지 않았을 때 표시할 이미지의 URIURI to image to display when play button hasn't been invoked 1.11.1
playButtonplayButton string 아니요No 재생 단추로 표시할 이미지Image to display as play button 1.11.1
allowInlinePlaybackallowInlinePlayback boolean 아니요. 기본값: trueNo, default: true 미디어를 인라인으로 표시하거나 외부에서 호출할지 여부Whether to display media inline or invoke externally 1.11.1

SeparatorConfigSeparatorConfig

구분 기호 표시 방법 제어Controls how separators are displayed

속성Property 형식Type 필수Required 설명Description 버전Version
lineThicknesslineThickness integer 아니요. 기본값: 1No, default: 1 구분선 두께Thickness of separator line 1.01.0
lineColorlineColor string,null 아니요. 기본값: #B2000000No, default: #B2000000 구분선을 그릴 때 사용할 색Color to use when drawing separator line 1.01.0

ShowCardConfigShowCardConfig

Action.ShowCard의 동작 및 스타일 제어Controls behavior and styling of Action.ShowCard

속성Property 형식Type 필수Required 설명Description 버전Version
actionModeactionMode string 아니요. 기본값: "inline"No, default: "inline" 카드 표시 방법 제어Controls how the card is displayed 1.01.0
stylestyle object 아니요. 기본값: emphasisNo, default: emphasis 컨테이너의 스타일 제어Controls styling of a container 1.01.0
inlineTopMargininlineTopMargin integer 아니요. 기본값: 16No, default: 16 카드를 표시할 때 사용할 여백 크기Amount of margin to use when displaying the card 1.01.0

SpacingsConfigSpacingsConfig

요소 배치 방법 제어Controls how elements are to be laid out

속성Property 형식Type 필수Required 설명Description 버전Version
smallsmall integer 아니요. 기본값: 3No, default: 3 작은 간격 값Small spacing value 1.01.0
defaultdefault integer 아니요. 기본값: 8No, default: 8 기본 간격 값Default spacing value 1.01.0
mediummedium integer 아니요. 기본값: 20No, default: 20 중간 간격 값Medium spacing value 1.01.0
largelarge integer 아니요. 기본값: 30No, default: 30 큰 간격 값Large spacing value 1.01.0
extraLargeextraLarge integer 아니요. 기본값: 40No, default: 40 매우 큰 간격 값Extra large spacing value 1.01.0
paddingpadding integer 아니요. 기본값: 20No, default: 20 안쪽 여백 값Padding value 1.01.0

TextBlockConfigTextBlockConfig

텍스트 표시를 제어하는 매개 변수Parameters controlling the display of text

속성Property 형식Type 필수Required 설명Description 버전Version
sizesize string 아니요. 기본값: "default"No, default: "default" 카드에서 지정하지 않을 때 사용할 글꼴 크기Font size to use when a card doesn't specify 1.01.0
weightweight string 아니요. 기본값: "normal"No, default: "normal" 카드에서 지정하지 않을 때 사용할 글꼴 두께Font weight to use when a card doesn't specify 1.01.0
colorcolor string 아니요. 기본값: "default"No, default: "default" 카드에서 지정하지 않을 때 사용할 글꼴 색Font color to use when a card doesn't specify 1.01.0
isSubtleisSubtle boolean 아니요. 기본값: falseNo, default: false 카드에서 지정하지 않는 경우 텍스트가 흐리게 표시됨Should text be subtle if a card doesn't specify 1.01.0
wrapwrap boolean 아니요. 기본값: trueNo, default: true 카드에서 지정하지 않는 경우 텍스트를 줄 바꿈함Should text wrap if a card doesn't specify 1.01.0
maxWidthmaxWidth integer 아니요. 기본값: 0No, default: 0 카드에서 지정되지 않는 경우 사용할 최대 너비Maximum width to use if a card doesn't specify 1.01.0