다음을 통해 공유


애플리케이션 내에서 카드 렌더링

애플리케이션 내에서 적응형 카드를 쉽게 렌더링할 수 있습니다. 모든 공통 플랫폼에 대한 SDK를 제공하고 고유한 적응형 카드 렌더러를 만들기 위한 자세한 사양 을 제공합니다.

  1. 대상 플랫폼용 렌더러 SDK를 설치합니다.
  2. 앱의 스타일, 규칙 및 작업 이벤트 처리기로 구성된 렌더러 인스턴스를 만듭니다.
  3. 카드를 네이티브 UI에 렌더링하여 앱에 맞게 자동으로 스타일링합니다.

적응형 카드 SDK

플랫폼 설치하다 빌드 문서들 상태
자바스크립트 npm install 출처 문서 빌드 상태
.NET WPF Nuget 설치 출처 문서 빌드 상태Build statusBuild status
.NET HTML Nuget 설치 출처 문서 빌드 상태Build statusBuild status
Windows UWP Nuget 설치 출처 문서 빌드 상태
WinUI 3 Nuget 설치 출처 문서 빌드 상태
안드로이드 Maven Central 출처 문서 빌드 상태Build statusBuild status
아이폰 OS CocoaPods 출처 문서 빌드 상태Build statusBuild status

렌더러의 인스턴스 만들기

다음 단계는 인스턴스를 만드는 것입니다 AdaptiveCardRenderer.

액션 이벤트 연결

기본적으로 작업은 카드에서 단추로 렌더링되지만 앱이 예상대로 동작하도록 하는 것은 앱에 달려 있습니다. 각 SDK에는 처리해야 하는 OnAction 이벤트에 상응하는 것이 있습니다.

  • Action.OpenUrl - 지정된 url을(를) 연다.
  • Action.Submit - 제출 결과를 가져와서 원본으로 보냅니다. 카드 원본으로 보내는 방법은 전적으로 사용자에게 달려 있습니다.
  • Action.ShowCard - 대화 상자를 호출하고 해당 대화 상자에 하위 카드를 렌더링합니다. ShowCardActionModepopup 로 설정된 경우에만 이 작업을 처리해야 합니다.

카드 렌더링

카드 페이로드를 획득한 후 렌더러를 호출하고 카드를 전달하기만 하면 됩니다. 카드 콘텐츠로 구성된 네이티브 UI 개체를 다시 가져옵니다. 이제 앱의 어딘가에 이 UI를 배치합니다.

사용자화

렌더링되는 항목을 사용자 지정할 수 있는 여러 가지 방법이 있습니다.

HostConfig

HostConfig는 앱 내 카드의 기본 스타일 및 동작을 제어하는 공유 플랫폼 간 구성 개체입니다. 글꼴 크기, 요소 사이의 간격, 색, 지원되는 작업 수 등과 같은 항목을 정의합니다.

네이티브 플랫폼 스타일링

대부분의 UI 프레임워크를 사용하면 네이티브 UI 프레임워크 스타일을 사용하여 렌더링된 카드의 스타일을 지정할 수 있습니다. 예를 들어 HTML에서 HTML에 대한 CSS 클래스를 지정하거나 XAML에서 출력의 세분화된 제어를 위해 사용자 지정 ResourceDictionary를 전달할 수 있습니다.

요소별 렌더링 사용자 지정

각 SDK를 사용하면 모든 요소의 렌더링을 재정의하거나 정의한 완전히 새로운 요소에 대한 지원을 추가할 수 있습니다. 예를 들어 렌더러의 Input.Date 나머지 출력을 유지하면서 사용자 지정 컨트롤을 내보내도록 렌더러를 변경할 수 있습니다. 또는 정의한 사용자 지정 Rating 요소에 대한 지원을 추가할 수 있습니다.