다음을 통해 공유

HostConfig란 무엇인가요?

  • 아티클

HostConfig는 적응형 카드 렌더러가 UI를 생성하는 방법을 지정하는 플랫폼 간 구성 개체입니다.

이를 사용하면 플랫폼에 독립적인 속성을 다양한 플랫폼 및 디바이스의 렌더러 간에 공유할 수 있습니다. 특정 환경에 대한 카드의 모양과 느낌에 대한 아이디어를 제공하는 도구를 만들 수도 있습니다.

콘텐츠에 대한 느낌을 얻으려면 샘플 HostConfig.json을 참조하세요.

카드 구성

AdaptiveCardConfig

AdaptiveCards의 최상위 옵션

속성 Type 필수 Description 버전
allowCustomStyle boolean 아니요. 기본값: true 사용자 지정 스타일이 허용되는지 여부 제어 1.0
supportsInteractivity boolean 아니요. 기본값: true 대화형 Action을 호출할 수 있는지 여부 제어 1.0
imageBaseUrl string 아니요 리소스를 로드할 때 사용되는 기준 URL 1.0
fontFamily string 아니요. 기본값: "Calibri" 텍스트를 렌더링할 때 사용할 글꼴 1.0
actions object 아니요 Action의 옵션 1.0
adaptiveCard object 아니요 AdaptiveCards의 최상위 옵션 1.0
containerStyles object 아니요 기본 및 강조 컨테이너의 스타일 지정 제어 1.0
imageSizes object 아니요 Image 크기 제어 1.0
imageSet object 아니요 ImageSet 표시 방법 제어 1.0
factSet object 아니요 FactSet의 표시 제어 1.0
fontSizes object 아니요 다양한 텍스트 스타일의 글꼴 크기 메트릭 제어 1.0
fontWeights object 아니요 글꼴 두께 메트릭 제어 1.0
spacing object 아니요 요소 배치 방법 제어 1.0
separator object 아니요 구분 기호 표시 방법 제어 1.0
media object 아니요 Media 요소의 표시 및 동작 제어 1.1

ActionsConfig

Action의 옵션

속성 Type 필수 Description 버전
actionsOrientation string 아니요. 기본값: "horizontal" 단추 배치 방법 제어 1.0
actionAlignment string 아니요. 기본값: "stretch" 단추 레이아웃 제어 1.0
buttonSpacing integer 아니요. 기본값: 10 단추 사이에 사용할 간격 크기 제어 1.0
maxActions integer 아니요. 기본값: 5 허용되는 총 작업 수 제어 1.0
spacing string 아니요. 기본값: "default" 작업 요소의 전체 간격 제어 1.0
showCard object 아니요 Action.ShowCard의 동작 및 스타일 제어 1.0
iconPlacement string 아니요. 기본값: "aboveTitle" 작업 아이콘을 배치할 위치 제어 1.0
iconSize integer 아니요. 기본값: 30 작업 아이콘의 크기 제어 1.0

ContainerStylesConfig

기본 및 강조 컨테이너의 스타일 지정 제어

속성 Type 필수 Description 버전
default object 아니요 기본 컨테이너 스타일 1.0
emphasis object 아니요 강조에 사용할 컨테이너 스타일 1.0

FactSetConfig

FactSet의 표시 제어

속성 Type 필수 Description 버전
title object 아니요. 기본값: {"weight":"bolder","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":150} 텍스트 표시를 제어하는 매개 변수 1.0
value object 아니요. 기본값: {"weight":"default","size":"default","color":"default","isSubtle":false,"wrap":true,"maxWidth":0} 텍스트 표시를 제어하는 매개 변수 1.0
spacing integer 아니요. 기본값: 10   1.0

FontSizesConfig

다양한 텍스트 스타일의 글꼴 크기 메트릭 제어

속성 Type 필수 Description 버전
small integer 아니요. 기본값: 10 작은 글꼴 크기 1.0
default integer 아니요. 기본값: 12 기본 글꼴 크기 1.0
medium integer 아니요. 기본값: 14 중간 글꼴 크기 1.0
large integer 아니요. 기본값: 17 큰 글꼴 크기 1.0
extraLarge integer 아니요. 기본값: 20 매우 큰 글꼴 크기 1.0

FontWeightsConfig

글꼴 두께 메트릭 제어

속성 Type 필수 Description 버전
lighter integer 아니요. 기본값: 200   1.0
default integer 아니요. 기본값: 400   1.0
bolder integer 아니요. 기본값: 800   1.0

ForegroundColorsConfig

다양한 글꼴 색 제어

속성 Type 필수 Description 버전
default object 아니요. 기본값: {"default":"#FF000000","subtle":"#B2000000"}   1.0
accent object 아니요. 기본값: {"default":"#FF0000FF","subtle":"#B20000FF"}   1.0
dark object 아니요. 기본값: {"default":"#FF101010","subtle":"#B2101010"}   1.0
light object 아니요. 기본값: {"default":"#FFFFFFFF","subtle":"#B2FFFFFF"}   1.0
good object 아니요. 기본값: {"default":"#FF008000","subtle":"#B2008000"}   1.0
warning object 아니요. 기본값: {"default":"#FFFFD700","subtle":"#B2FFD700"}   1.0
attention object 아니요. 기본값: {"default":"#FF8B0000","subtle":"#B28B0000"}   1.0

ImageSetConfig

ImageSet 표시 방법 제어

속성 Type 필수 Description 버전
imageSize string 아니요. 기본값: "auto" 개별 이미지 크기 제어 1.0
maxImageHeight integer 아니요. 기본값: 100 이미지 높이를 이 값으로 제한 1.0

ImageSizesConfig

Image 크기 제어

속성 Type 필수 Description 버전
small integer 아니요. 기본값: 80 작은 이미지 크기 값 1.0
medium integer 아니요. 기본값: 120 중간 이미지 크기 값 1.0
large integer 아니요. 기본값: 180 큰 이미지 크기 값 1.0

InputsConfig

레이블 및 오류 메시지 표시 방법 제어

속성 Type 필수 Description 버전
label LabelConfig 아니요 레이블 표시 방법 제어 1.3
errorMessage ErrorMessageConfig 아니요 오류 메시지 표시 방법 제어 1.3

LabelConfig

레이블 표시 방법 제어

속성 Type 필수 Description 버전
requiredInputs InputLabelConfig 아니요 필수 입력의 레이블 표시 방법 제어 1.3
optionalInputs InputLabelConfig 아니요 옵션 입력의 레이블 표시 방법 제어 1.3
spacing string 아니요. 기본값: "default" 레이블과 입력 사이의 간격 1.3

InputLabelConfig

필수 또는 옵션 레이블 표시 방법 제어

속성 Type 필수 Description 버전
color string 아니요. 기본값: "default" 레이블의 글꼴 색상(접미사는 항상 attention 색상으로 렌더링됨) 1.3
isSubtle bool 아니요. 기본값: false subtle 전경색 사용 여부 정의 1.3
size string 아니요. 기본값: "default" 표시할 레이블의 글꼴 크기 1.3
접미사 string 아니요. 기본값: "*" 필수 입력의 레이블 끝에 표시되는 접미사입니다. 정의된 항목이 없으면 레이블에 별표(*)가 추가됩니다. 1.3
weight string 아니요. 기본값: "default" 레이블의 글꼴 두께 1.3

ErrorMessageConfig

오류 메시지 표시 방법 제어. 오류 메시지는 항상 attention 색상으로 표시됩니다.

속성 Type 필수 Description 버전
spacing string 아니요. 기본값: "default" 입력과 오류 메시지 사이의 간격 1.3
size string 아니요. 기본값: "default" 오류 메시지의 글꼴 크기 1.3
weight string 아니요. 기본값: "default" 오류 메시지의 글꼴 두께 1.3

MediaConfig

Media 요소의 표시 및 동작 제어

버전 1.1에서 도입됨

속성 Type 필수 Description 버전
defaultPoster string 아니요 재생 단추가 호출되지 않았을 때 표시할 이미지의 URI 1.1
playButton string 아니요 재생 단추로 표시할 이미지 1.1
allowInlinePlayback boolean 아니요. 기본값: true 미디어를 인라인으로 표시하거나 외부에서 호출할지 여부 1.1

SeparatorConfig

구분 기호 표시 방법 제어

속성 Type 필수 Description 버전
lineThickness integer 아니요. 기본값: 1 구분선 두께 1.0
lineColor string,null 아니요. 기본값: #B2000000 구분선을 그릴 때 사용할 색 1.0

ShowCardConfig

Action.ShowCard의 동작 및 스타일 제어

속성 Type 필수 Description 버전
actionMode string 아니요. 기본값: "inline" 카드 표시 방법 제어 1.0
style object 아니요. 기본값: emphasis 컨테이너의 스타일 제어 1.0
inlineTopMargin integer 아니요. 기본값: 16 카드를 표시할 때 사용할 여백 크기 1.0

SpacingsConfig

요소 배치 방법 제어

속성 Type 필수 Description 버전
small integer 아니요. 기본값: 3 작은 간격 값 1.0
default integer 아니요. 기본값: 8 기본 간격 값 1.0
medium integer 아니요. 기본값: 20 중간 간격 값 1.0
large integer 아니요. 기본값: 30 큰 간격 값 1.0
extraLarge integer 아니요. 기본값: 40 매우 큰 간격 값 1.0
padding integer 아니요. 기본값: 20 안쪽 여백 값 1.0

TextBlockConfig

텍스트 표시를 제어하는 매개 변수

속성 Type 필수 Description 버전
size string 아니요. 기본값: "default" 카드에서 지정하지 않을 때 사용할 글꼴 크기 1.0
weight string 아니요. 기본값: "normal" 카드에서 지정하지 않을 때 사용할 글꼴 두께 1.0
color string 아니요. 기본값: "default" 카드에서 지정하지 않을 때 사용할 글꼴 색 1.0
isSubtle boolean 아니요. 기본값: false 카드에서 지정하지 않는 경우 텍스트가 흐리게 표시됨 1.0
wrap boolean 아니요. 기본값: true 카드에서 지정하지 않는 경우 텍스트를 줄 바꿈함 1.0
maxWidth integer 아니요. 기본값: 0 카드에서 지정되지 않는 경우 사용할 최대 너비 1.0