Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/microsoft/AdaptiveCards

A new way for developers to exchange card content in a common and consistent way.
https://github.com/microsoft/AdaptiveCards
adaptive adaptive-cards adaptivecards android bot-framework bots cards ios timeline uwp windows windows-uwp wpf xamarin xaml
Last synced: 3 months ago
JSON representation
A new way for developers to exchange card content in a common and consistent way.
Host: GitHub
URL: https://github.com/microsoft/AdaptiveCards
Owner: microsoft
License: mit
Created: 2016-12-08T22:00:33.000Z (almost 8 years ago)
Default Branch: main
Last Pushed: 2024-04-05T12:29:02.000Z (7 months ago)
Last Synced: 2024-04-08T00:51:03.846Z (7 months ago)
Topics: adaptive, adaptive-cards, adaptivecards, android, bot-framework, bots, cards, ios, timeline, uwp, windows, windows-uwp, wpf, xamarin, xaml
Language: C#
Homepage: https://adaptivecards.io
Size: 352 MB
Stars: 1,679
Watchers: 103
Forks: 533
Open Issues: 828
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project

awesome-adaptive-cards - Adaptive Cards - A new way for developers to exchange card content in a common and consistent way. (Uncategorized / Uncategorized)
awesome-list - AdaptiveCards
README

        # Adaptive Cards

![logo](assets/adaptive-card-200.png)

[Adaptive Cards](https://adaptivecards.io) are a new way for developers to exchange content in a common and consistent way. Get started today by putting Adaptive Cards into Microsoft Teams, Outlook Actionable Messages, Cortana Skills, or Windows Timeline -- or render cards inside your own apps by using our SDKs.

## Dive in

* [Documentation](https://adaptivecards.io/documentation/)

* [Roadmap](https://github.com/microsoft/AdaptiveCards/projects/32)

* [Schema Explorer](https://adaptivecards.io/explorer/)

* [Sample Cards](https://adaptivecards.io/samples/)

* [Designer](https://adaptivecards.io/designer/)

## Install and Build

Adaptive Cards are designed to render anywhere that your users are. The following native platform renderers are under development right now.

PS: Latest Build Status is against `main` branch.

|Platform|Latest Release|Source|Docs|Latest Build Status|

|---|---|---|---|---|

| JavaScript | [![npm install](https://img.shields.io/npm/v/adaptivecards.svg)](https://www.npmjs.com/package/adaptivecards) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/nodejs/adaptivecards)| [Docs](https://docs.microsoft.com/en-us/adaptive-cards/display/libraries/htmlclient) | ![Build Status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/20564/main.svg) |

| .NET | [![Nuget install](https://img.shields.io/nuget/vpre/AdaptiveCards.svg)](https://www.nuget.org/packages/AdaptiveCards) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/dotnet)| [Docs](https://docs.microsoft.com/en-us/adaptive-cards/create/libraries/net) | ![Build status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/20596/main.svg) |

| .NET WPF | [![Nuget install](https://img.shields.io/nuget/vpre/AdaptiveCards.Rendering.Wpf.svg)](https://www.nuget.org/packages/AdaptiveCards.Rendering.Wpf) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/dotnet)| [Docs](https://docs.microsoft.com/en-us/adaptive-cards/display/libraries/net-wpf) | ![Build status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/20596/main.svg) |

| .NET HTML | [![Nuget install](https://img.shields.io/nuget/vpre/AdaptiveCards.Rendering.Html.svg)](https://www.nuget.org/packages/AdaptiveCards.Rendering.Html) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/dotnet) | [Docs](https://docs.microsoft.com/en-us/adaptive-cards/display/libraries/net-html) | ![Build status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/20596/main.svg) |

| Windows UWP | [![Nuget install](https://img.shields.io/nuget/vpre/AdaptiveCards.Rendering.Uwp.svg)](https://www.nuget.org/packages/AdaptiveCards.Rendering.Uwp) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/uwp) | [Docs](https://docs.microsoft.com/en-us/adaptive-cards/display/libraries/uwp) | ![Build Status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/20583/main.svg) |

| Android | [![Maven Central](https://img.shields.io/maven-central/v/io.adaptivecards/adaptivecards-android.svg)](https://search.maven.org/#search%7Cga%7C1%7Ca%3A%22adaptivecards-android%22) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/android) | [Docs](https://docs.microsoft.com/en-us/adaptive-cards/display/libraries/android) | ![Build status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/37913/main.svg)

| iOS | [![CocoaPods](https://img.shields.io/cocoapods/v/AdaptiveCards.svg)](https://cocoapods.org/pods/AdaptiveCards) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/ios) | [Docs](https://docs.microsoft.com/en-us/adaptive-cards/display/libraries/ios) |  ![Build status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/37917/main.svg) |

| Card Designer | [![npm install](https://img.shields.io/npm/v/adaptivecards-designer.svg)](https://www.npmjs.com/package/adaptivecards-designer) | [Source](https://github.com/Microsoft/AdaptiveCards/tree/main/source/nodejs/adaptivecards-designer)| [Docs](https://www.npmjs.com/package/adaptivecards-designer) | ![Build Status](https://img.shields.io/azure-devops/build/Microsoft/56cf629e-8f3a-4412-acbc-bf69366c552c/20564/main.svg) |

## Release schedule

We release the Adaptive Cards products on the third week of each month, assuming there are updates. Please see the table below for the most recent and upcoming release dates.

|Product|Last Release Date|Next Release Date|

|---|---|---|

|Website|4/4/2024|5/29/2024|

|Designer|5/1/2024|6/17/2024|

|JavaScript Renderer|5/23/2024|6/17/2024|

|JavaScript Renderer Beta|4/9/2023|-|

|JavaScript Templating|9/16/2022|6/17/2024|

|XAML Renderer|2/2/2024|3/2/2024|

|XAML Object Model|2/2/2024|3/2/2024|

|WinUI 3 Renderer|2/2/2024|3/2/2024|

|WinUI 3 Object Model|2/2/2024|3/2/2024|

|C++/WinRT Templating|2/2/2024|3/2/2024|

|C#/WinRT Templating|2/2/2024|3/2/2024|

|.NET Renderer|12/1/2022|7/17/2023|

|.NET Templating|3/7/2023|7/17/2023|

**Note:** These release dates are subject to change based on availability and active development of each product.

## Code format

We require the C++ code inside this project to follow the clang-format. If you change them, please make sure your changed files are formatted correctly.

Make sure clang-format version 12.0.0 and above version is used.

### IDE integration

ClangFormat describes a set of tools that are built on top of LibFormat. It can support your workflow in a variety of ways including a standalone tool and editor integrations. For details, refer to https://clang.llvm.org/docs/ClangFormat.html

### Format with script

Two scripts are provided to help you format files.

- Windows user only: use FormatSource.ps1. This script use clang-format.exe which is built into Visual Studio by default.

	Execute below command in the root folder of the project

	```

	PowerShell.exe -ExecutionPolicy Bypass scripts\FormatSource.ps1 -ModifiedOnly $False

	```

If it's the first time to run the script, make sure clang-format version 12.0.0 or above in the output. Otherwise you may need to upgrade Visual Studio or use your own clang-format binaries.

```

[clang-format] Version is:

clang-format version 12.0.0

```

- Both Windows and MAC users: Use clang-format npmjs package

	Execute below command in source/nodejs

	```

	npm run format

	``` 

Make sure `npm install` is run before.

### Use Git pre-commit hook

`git pre-commit hook` is an optional process. When you run `git commit`, it will automatically do the format check and auto fix the format if error detected.

First make sure clang-format binary is installed in your dev enviroment.

Then modify scripts/hooks/pre-commit to make sure clangFormat is point to the correct path.

And finally setup the git hook.

Two ways to setup the hook:

1. Copy `scripts/hooks/pre-commit` to `.git/hooks`

2. `git config --local core.hooksPath scripts/hooks`

## End User License Agreement for our binary packages

Consumption of the AdaptiveCards binary packages are subject to the Microsoft EULA (End User License Agreement). Please see the relevant terms as listed below:

- [UWP/.NET](https://github.com/microsoft/AdaptiveCards/blob/main/source/EULA-Windows.txt)

- [Android/iOS](https://github.com/microsoft/AdaptiveCards/blob/main/source/EULA-Non-Windows.txt)

NOTE: All of the source code, itself, made available in this repo as well as our NPM packages, continue to be governed by the open source [MIT license](https://github.com/microsoft/AdaptiveCards/blob/main/LICENSE).

### Community SDKs

The following SDKs are lovingly maintained by the Adaptive Cards community. Their contributions are sincerely appreciated! 🎉

|Platform|Install|Repo|Maintainer|

|---|---|---|---|

| ReactNative | [![npm install](https://img.shields.io/npm/v/adaptivecards-reactnative.svg)](https://www.npmjs.com/package/adaptivecards-reactnative) | [GitHub](https://github.com/BigThinkcode/AdaptiveCards) | [BigThinkCode](https://github.com/BigThinkcode) |

| Pic2Card | | [GitHub](https://github.com/BigThinkcode/AdaptiveCards/blob/fork-main/source/pic2card/README.md) | [BigThinkCode](https://github.com/BigThinkcode) |

| Vue.js | [![npm install](https://img.shields.io/npm/v/adaptivecards-vue.svg)](https://www.npmjs.com/package/adaptivecards-vue) | [GitHub](https://github.com/DeeJayTC/adaptivecards-vue)| [Tim Cadenbach](https://github.com/DeeJayTC)

## Contribute

There are many ways to [contribute](https://github.com/Microsoft/AdaptiveCards/blob/main/.github/CONTRIBUTING.md) to Adaptive Cards.

* [Submit bugs](https://github.com/Microsoft/AdaptiveCards/issues) and help us verify fixes as they are checked in.

* Review the [source code changes](https://github.com/Microsoft/AdaptiveCards/pulls).

* Engage with Adaptive Cards users and developers on [StackOverflow](http://stackoverflow.com/questions/tagged/adaptive-cards). 

* Join the [#adaptivecards](https://twitter.com/hashtag/adaptivecards?f=tweets&vertical=default) discussion on Twitter.

* [Contribute bug fixes](https://github.com/Microsoft/AdaptiveCards/blob/main/.github/CONTRIBUTING.md).

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see 

the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.

## Supported Features

|Feature|Schema Version|Platform|Parsing|Rendering|

|---|---|---|:---:|:---:|

|Action.OpenUrl|v1.0|All| :white_check_mark: | :white_check_mark:|

|Action.ShowCard|v1.0|All| :white_check_mark: | :white_check_mark:|

|Action.Submit|v1.0|All| :white_check_mark: | :white_check_mark:|

|Column|v1.0|All| :white_check_mark: | :white_check_mark:|

|ColumnSet|v1.0|All| :white_check_mark: | :white_check_mark:|

|Container|v1.0|All| :white_check_mark: | :white_check_mark:|

|Fact|v1.0|All| :white_check_mark: | :white_check_mark:|

|FactSet|v1.0|All| :white_check_mark: | :white_check_mark:|

|Image|v1.0|All| :white_check_mark: | :white_check_mark:|

|ImageSet|v1.0|All| :white_check_mark: | :white_check_mark:|

|Input.ChoiceSet|v1.0|All| :white_check_mark: | :white_check_mark:|

|Input.Date|v1.0|All| :white_check_mark: | :white_check_mark:|

|Input.Number|v1.0|All| :white_check_mark: | :white_check_mark:|

|Input.Text|v1.0|All| :white_check_mark: | :white_check_mark:|

|Input.Time|v1.0|All| :white_check_mark: | :white_check_mark:|

|Input.Toggle|v1.0|All| :white_check_mark: | :white_check_mark:|

|SelectAction|v1.0|All| :white_check_mark: | :white_check_mark:|

|TextBlock|v1.0|All| :white_check_mark: | :white_check_mark:|

|Explicit Image Dimension|v1.1|All| :white_check_mark: | :white_check_mark:|

|Background Color|v1.1|All| :white_check_mark: | :white_check_mark:|

|Vertical Content Alignment|v1.1|All| :white_check_mark: | :white_check_mark:|

|Action Icon|v1.1|All| :white_check_mark: | :white_check_mark:|

|Action Style|v1.2|All| :white_check_mark: | :white_check_mark:|

|Toggle Visibility|v1.2|All| :white_check_mark: | :white_check_mark:|

|ActionSet|v1.2|All| :white_check_mark: | :white_check_mark:|

|Fallback|v1.2|All| :white_check_mark: | :white_check_mark:|

|Container BackgroundImage|v1.2|All| :white_check_mark: | :white_check_mark:|

|Container MinHeight|v1.2|All| :white_check_mark: | :white_check_mark:|

|Container Bleed|v1.2|All| :white_check_mark: | :white_check_mark:|

|Container Style|v1.2|All| :white_check_mark: | :white_check_mark:|

|Image Data Uri|v1.2|All| :white_check_mark: | :white_check_mark:|

|Action Icon Data Uri|v1.2|All| :white_check_mark: | :white_check_mark:|

|Input.Text Inline Action|v1.2|All| :white_check_mark: | :white_check_mark:|

|TextBlock FontType|v1.2|All| :white_check_mark: | :white_check_mark:|

|RichTextBlock|v1.2|All| :white_check_mark: | :white_check_mark:|

|Input Label|v1.3|All| :white_check_mark: | :white_check_mark:|

|Input ErrorMessage|v1.3|All| :white_check_mark: | :white_check_mark:|

|AssociatedInputs|v1.3|All| :white_check_mark: | :white_check_mark:|

|RichTextBlock UnderLine|v1.3|All| :white_check_mark: | :white_check_mark:|

|Action.Refresh|v1.4|All| :white_check_mark: | :white_check_mark:|

|AdaptiveCard Authentication|v1.4|All| :white_check_mark: | :white_check_mark:|

|Action.Execute|v1.4|All| :white_check_mark: | :white_check_mark:|

|Action IsEnabled|v1.5|JS| :white_check_mark: | :white_check_mark:|

|Action IsEnabled|v1.5|iOS| :white_check_mark: | :white_check_mark:|

|Action IsEnabled|v1.5|Android| :white_check_mark: | :white_check_mark:|

|Action IsEnabled|v1.5|XAML| :white_check_mark: | :white_check_mark:|

|Action IsEnabled|v1.5|.NET| :white_check_mark: | :x:|

|Action Mode|v1.5|JS| :white_check_mark: | :white_check_mark:|

|Action Mode|v1.5|iOS| :white_check_mark: | :white_check_mark:|

|Action Mode|v1.5|Android| :white_check_mark: | :white_check_mark:|

|Action Mode|v1.5|XAML| :white_check_mark: | :white_check_mark:|

|Action Mode|v1.5|.NET| :white_check_mark: | :x:|

|Action/SelectAction ToolTip|v1.5|JS| :white_check_mark: | :white_check_mark:|

|Action/SelectAction ToolTip|v1.5|iOS| :white_check_mark: | :white_check_mark:|

|Action/SelectAction ToolTip|v1.5|Android| :white_check_mark: | :white_check_mark:|

|Action/SelectAction ToolTip|v1.5|XAML| :white_check_mark: | :white_check_mark:|

|Action/SelectAction ToolTip|v1.5|.NET| :white_check_mark: | :x:|

|Input.ChoiceSet Filtered Style |v1.5|JS| :white_check_mark: | :white_check_mark:|

|Input.ChoiceSet Filtered Style |v1.5|iOS| :white_check_mark: | :white_check_mark:|

|Input.ChoiceSet Filtered Style |v1.5|Android| :white_check_mark: | :white_check_mark:|

|Input.ChoiceSet Filtered Style |v1.5|XAML| :white_check_mark: | :white_check_mark:|

|Input.ChoiceSet Filtered Style |v1.5|.NET| :white_check_mark: | :x:|

|Input.Text Password Style |v1.5|JS| :white_check_mark: | :white_check_mark:|

|Input.Text Password Style |v1.5|iOS| :white_check_mark: | :white_check_mark:|

|Input.Text Password Style |v1.5|Android| :white_check_mark: | :white_check_mark:|

|Input.Text Password Style |v1.5|XAML| :white_check_mark: | :white_check_mark:|

|Input.Text Password Style |v1.5|.NET| :white_check_mark: | :x:|

|TextBlock Heading Style|v1.5|JS| :white_check_mark: | :white_check_mark:|

|TextBlock Heading Style|v1.5|iOS| :white_check_mark: | :white_check_mark:|

|TextBlock Heading Style|v1.5|Android| :white_check_mark: | :white_check_mark:|

|TextBlock Heading Style|v1.5|XAML| :white_check_mark: | :white_check_mark:|

|TextBlock Heading Style|v1.5|.NET| :white_check_mark: | :x:|

|RTL |v1.5|JS| :white_check_mark: | :white_check_mark:|

|RTL |v1.5|iOS| :white_check_mark: | :white_check_mark:|

|RTL |v1.5|Android| :white_check_mark: | :white_check_mark:|

|RTL |v1.5|XAML| :white_check_mark: | :white_check_mark:|

|RTL |v1.5|.NET| :white_check_mark: | :x:|

|Table |v1.5|JS| :white_check_mark: | :white_check_mark:|

|Table |v1.5|iOS| :white_check_mark: | :white_check_mark:|

|Table |v1.5|Android| :white_check_mark: | :white_check_mark:|

|Table |v1.5|XAML| :white_check_mark: | :white_check_mark:|

|Table |v1.5|.NET| :white_check_mark: | :x:|

|Carousel|v1.6|JS| :white_check_mark: | :white_check_mark:|

|Carousel|v1.6|iOS| :x: | :x:|

|Carousel|v1.6|Android| :x: | :x:|

|Carousel|v1.6|XAML| :x: | :x:|

|Carousel|v1.6|.NET| :x: | :x:|

|ImageSet Stacked Presentation Style|v1.6|JS| :white_check_mark: | :white_check_mark:|

|ImageSet Stacked Presentation Style|v1.6|iOS| :x: | :x:|

|ImageSet Stacked Presentation Style|v1.6|Android| :x: | :x:|

|ImageSet Stacked Presentation Style|v1.6|XAML| :x: | :x:|

|ImageSet Stacked Presentation Style|v1.6|.NET| :x: | :x:|

|Dynamic Type Ahead Search|v1.6|JS| :x: | :x:|

|Dynamic Type Ahead Search|v1.6|iOS| :white_check_mark: | :x:|

|Dynamic Type Ahead Search|v1.6|Android| :white_check_mark: | :x:|

|Dynamic Type Ahead Search|v1.6|XAML| :x: | :x:|

|Dynamic Type Ahead Search|v1.6|.NET| :x: | :x:|

|Label Position|v1.6|JS| :x: | :x:|

|Label Position|v1.6|iOS| :x: | :x:|

|Label Position|v1.6|Android| :x: | :x:|

|Label Position|v1.6|XAML| :x: | :x:|

|Label Position|v1.6|.NET| :x: | :x:|

|Inline Editable Input Style|v1.6|JS| :x: | :x:|

|Inline Editable Input Style|v1.6|iOS| :x: | :x:|

|Inline Editable Input Style|v1.6|Android| :x: | :x:|

|Inline Editable Input Style|v1.6|XAML| :x: | :x:|

|Inline Editable Input Style|v1.6|.NET| :x: | :x:|