Releases: microsoft/AdaptiveCards
Adaptive Cards NodeJS Carousel Beta
AdaptiveCards Templating 2.3.0 Beta
2022.08 Release
Latest Packages
New Features
JS Templating
- #7199
Card author can now supply an additional data object,$host
, to theEvaluationContext
. - #7209
Expose the adaptivecards-templating library version by adding a variable$_acTemplateVersion
that can be accessed in the card payload. - #7437
Template.getLastTemplateExpansionWarnings() will retrieve an array of warnings that have occurred while expanding the template. Callers can use this to confirm that no warnings have been raised during expansion and investigate warnings that did occur.
Breaking Changes
JS Templating
$when
conditions default tofalse
if the given string cannot be evaluated. Errors are no longer raised in this scenario. (#7432)
AdaptiveCards 2022.06
2022.06 Release
Latest Packages
This release contains bug fixes.
New Features
.NET Templating
Bug Fixes
.NET Templating
AdaptiveCards 2022.05
2022.05 Release
Latest Packages
This release contains bug fixes.
New Features
.NET Templating
- #7433
AdaptiveCardTemplate.GetLastTemplateExpansionWarnings()
will retrieve an array of warnings that have occurred while expanding the template. Callers can use this to confirm that no warnings have been raised during expansion and investigate warnings that did occur.
Bug Fixes
.NET Templating
iOS
JS Templating
- To be published at the end of May
Breaking Changes
.NET Templating
$when
conditions default tofalse
if the given string cannot be evaluated. Errors are no longer raised in this scenario.
Adaptive Cards NodeJS Carousel Beta
Early beta release of adaptivecards
NodeJS package
New features
New Adaptive Cards element: Carousel
Early sample cards can be found here.
Breaking Changes
Consumers of this package must apply CSS from the packaged adaptivecards-carousel.css
stylesheet or ingest the adaptivecards-carousel.scss
Sass definitions.
Known Issues/upcoming changes
#6739 - keyboard navigation issue with Carousel
#6737 - Designer styles for "dark mode" hosts need to be updated for Carousel
#6700 - move to using addEventListener
for some eventing
#6699 - parse warnings should be logged via the SerializationContext
and not console.warn
#6693 - reconcile Carousel
styles with high contrast rendering
AdaptiveCards Schema 1.5
We are excited to release Adaptive Cards v1.5!
Latest Packages
- 🎉.NET Templating 1.2.2
- 🎉XAML Object Model 1.0.0
- 🎉XAML 3.0.0
- 🎉JavaScript 2.10.0
- 🎉React 1.0.0
- 🎉Android 2.8.0
- 🎉iOS 2.8.1
- 🎉iOS 2.8.1 SPM Commit Hash: 9607681
This release contains some highly requested asks from our community as well as improvements to accessibility. One of our most requested features has been support for a Table element and we are happy to support this in Adaptive Cards 1.5!
New Features
- RTL
- Input.Text Masking
- ActionSet Overflow
- Tooltip for Actions
- Tables
- Static Filtered ChoiceSet
- Action.isEnabled
Bug Fixes
Shared
JS
.NET
Android
iOS
XAML
Accessibility
Website
Breaking Changes
XAML
- The classes and interfaces under
AdaptiveCards.Rendering.Uwp
which represent the object model of the card, parsing functionality, and all related enums have been moved to theAdaptiveCards.ObjectModel.Uwp
namespace. - The following properties have been converted from value types to an
IReference
to those value types:AdaptiveCards.ObjectModel.Uwp.AdaptiveImage.HorizontalAlignment
AdaptiveCards.ObjectModel.Uwp.AdaptiveContainer.VerticalContentAlignment
AdaptiveCards.ObjectModel.Uwp.AdaptiveColumn.VerticalContentAlignment
AdaptiveCards.ObjectModel.Uwp.IAdaptiveTextElement.Size
AdaptiveCards.ObjectModel.Uwp.IAdaptiveTextElement.Weight
AdaptiveCards.ObjectModel.Uwp.IAdaptiveTextElement.Color
AdaptiveCards.ObjectModel.Uwp.IAdaptiveTextElement.IsSubtle
AdaptiveCards.ObjectModel.Uwp.IAdaptiveTextElement.FontType
AdaptiveCards.ObjectModel.Uwp.AdaptiveTextBlock.HorizontalAlignment
AdaptiveCards.ObjectModel.Uwp.AdaptiveRichTextBlock.HorizontalAlignment
AdaptiveCards.Rendering.Uwp.AdaptiveTextConfig
class used to configure fact sets in the host config has been renamed toAdaptiveCards.Rendering.Uwp.AdaptiveFactSetTextConfig
AdaptiveCards.Rendering.Uwp.AdaptiveRenderContext.AddInlineShowCard
has been removed.
iOS
ACRVerticalAlignment
enum name has changed toACRVerticalContentAlignment
- AdaptiveCards framework has a new dependency on FluentUI framework.
- Actions targets such as
ACRAggregateTarget
,ACRShowCardTarget
and etc will have a new base targetACRBaseTarget
and it will take the dependency on FluentUI. hasStretchableView
andhasPaddingView
properties
are removed fromACRColumnView
.heightType
property
is added toACRColumnView
.ACRContentHoldingUIScrollView
'sproperties
,widthConstraintForStretch
,centerXConstraintForStretch
,centerYConstraintForStretch
are consolidated tononStretchConstraints
andstretchConstraints
- (void)hideIfSubviewsAreAllHidden
is removed fromACRContentStackView
- Gesture recognizer for Action targets are changed from
LongPressureGestureRecognizer
toTapGestureRecognizer
to differentiate the gesture for tooltip feature. - min supported iOS version is bumped to iOS12.1 due to FluentUI dependency.
- Umberall header is changed from ACFramework.h to AdaptiveCards.h
- Path to C++ and ObjectiveC++ headers are changed, add the source path in
HeaderSearchPath
in Xcode with recursiontrue
. - $POD_SRC can be used for the C++ and ObjectiveC++ headers.
Android
-
CollectionTypeElement has been renamed to
StyledCollectionElement
-
The usage of android.support libraries has been removed in favor of the newer androidx libraries
- com.android.support:appcompat-v7:28.0.0 -> androidx.appcompat:appcompat:1.0.0
- com.android.support.constraint:constraint-layout:1.1.3 -> androidx.constraintlayout:constraintlayout:1.1.3
AdaptiveCards Schema 1.4
Latest Packages
- 🎉.NET Base Library 2.7.0
- 🎉WPF 2.7.0
- 🎉WPF XCeed 2.7.0
- 🎉HTML 2.7.0
- 🎉UWP 2.7.0
- 🎉JavaScript 2.9.0
- 🎉Android 2.7.0
- 🎉iOS 2.7.0
Smoke Test Notes
- Automated CI/CD on
release/schema-1.4
branch - Regression tests against:
What's new?
Samples
[Samples] Add validation + Action.Execute test card 45de88e
Schema
[Schema] Update schema with Action.Execute properties #5509
Renderers
Shared
[Shared] 1.4 - Action.Execute #5539
JavaScript
[JS] Add support for Universal Actions #5533
.NET
[.NET] Add support for parsing schema 1.4 features #5531
Android
[Android] Action.Execute support #5551
iOS
[iOS] Action.Execute changes #5549
[iOS] Updated TextView to dynamically compute the intrinsic content size #5560
UWP
[UWP] Add parsing of schema 1.4 changes and Action.Execute support #5554
Known Issues
[.NET][Input Validation] TextBlocks with regex set are treated as required. #5561
[Android][Input Validation] Error message is not cleared #5563
[iOS] [Input Validation] Sample App's content offset for the focusing after input validation failure is not correct #5559
AdaptiveCards 2021.02
Latest Packages
- .NET
- 🎉UWP 2.6.0
- 🎉JavaScript 2.8.0
- 🎉Android 2.6.0
- 🎉iOS 2.6.0
Smoke Test Notes
- Automated CI/CD on
release/21.02
branch - Regression tests against:
What's new?
Website/Samples
[Sample] Regex in InputFormWithLabels are incorrect #5333
[Samples][Accessibility] Update the templated and labelled versions of the ExpenseReport card to have more descriptive alttext #5410
[Samples] Update alttext on ExpenseReport expand collapse buttons to include more information #5387
[Site] Fix mobile tabindex #5426
[Site] Display action item text at lower screen widths #5420
[Site] Update header structure on homepage to make more sense #5418
[Site] Emit status messages on copy button invoke #5417
[Site] Make code blocks keyboard focusable #5413
[Site] Emit samples list with aria attributes #5409
[Site] Mark current header page with aria-current #5408
[Site] Fix sample selection indicator in high contrast #5393
[Site] Mark space-only items as role="presentation" #5379
[Site] Add more descriptive label to the "Read more" blog link #5377
[Site] Update role for "Try it yourself" button #5376
[Site][Accessibility] Update link indicators to underline on hover #5374
Designer
[Designer] Fix broken media query #5437
[Designer][Accessibility] Allow disabled button focus in toolbar #5425
[Designer][Accessibility] Group Card Elements sections with label for accessibility #5405
[Designer][Accessibility] Restore focus after data binding a property #5401
[Designer] [Designer] Add "Remove" accessible title to peer buttons #5375
[Accessibility] Add aria-labels to the data binding buttons in the designer #5419 #5434
Renderers
JavaScript
[JS] Column separators not rendering properly #5455
[JavaScript][Action.Submit associatedInputs property values are case sensitive] #5260
[JS] Multiline Input.Text elements should stretch when height is set to stretch #4097
[JS] Fix some accessibility issues #5394
[JS] Fix dropdown control and host container high contrast #5359
.NET
Support for Antlr4 version 4.8.0 #5225
[.NET] Support for White Space characters in Markdown #5351
[.NET][Input Validation] Input.Number floating point support #5308
[WPF] Update Xceed license Bug Platform-.NET #4339
Android
[Shared][Input Validation] Input.Number floating point support #5278
[Android] Action iconUrl sizing incorrect when using ResourceResolver #5431
iOS
[Shared][Input Validation] Input.Number floating point support #5278
[iOS] Multiline Input.Text elements should stretch when height is set to stretch CiscoWebEx-Integration #5348
[iOS][Rendering] There's no way to get additional properties from ACOAdaptiveCard #5303
[iOS][Rendering] Column width is ignored, generates auto layout errors #5269
[iOS][Framework] [Container's backgroundImage renders incorrectly on iOS with Cover fillMode] #5263
[iOS][Sample App Update] Append AdaptiveCards #3704
[iOS] Crash on iOS 13 when TextBlock includes an ampersand ("&") #5428
[iOS][Extensibility] Non-existent custom properties are sent as "null" #5244
UWP
[Shared][Input Validation] Input.Number floating point support #5278
[UWP][Input Validation] Input.Number floating point support #5309
Known Issues
[Android] Input.Time and Input.Date require double tap for system picker #5463
[.NET] Agenda card column with backgroundImage not showing #5462
[UWP] Number less than the min returned in Input.Number when user input is more than double precision #5452
AdaptiveCards 2021.01
Latest Packages
- .NET
- 🎉UWP 2.5.0
- 🎉JavaScript 2.7.0
- 🎉Android 2.5.0
- 🎉iOS 2.5.0
Smoke Test Notes
- Automated CI/CD on
release/21.01
branch - Regression tests against:
What's new?
Website/Samples
[JavsScript ] Required Input validation not working properly on "Input Form with Labels" sample #5201
[SmokeTest][Sample][Accessibility] Hard to read text in the Solitaire.json sample for BotFramework host config #5182
Pic2card on official website #4708
[Samples] Add alt text to restaurant template #5265
[Samples] Update input ids to be more descriptive to avoid dups #5246
[Site] Remove github button #5264
[Site] Fix keyboard accessibility for video modal #5255
[Site] Make Feedback button appear as link for accessibility #5254
[Site] Fix a couple typos #5318
Designer
Designer versioning tweaks + README updates #5340
[Accessibility] Set aria-labelledby for Element Properties inputs in the designer #5277
[Designer] Collapse toolbox on ESC #5256
[Accessibility][Designer] Label the TryNow button with the descriptive text #5257
[Accessibility] Increase contrast in "Try Now" and "NEW PREVIEW" buttons #5262
[Designer] Update role and aria for toolbar dropdown menus #5247
Pic2card Designer Integration #4893
Renderers
JavaScript
[Javascript][Renderer] [TextBlock not well handle maxLines that clips the text at wrong position] #5315
[Adaptive Card-UI][Text Block] Ellipses do not appear in Text Block when text length exceeds the limit set by "maxLines" and "wrap" = "true" #5302
[JavaScript][Input.ChoiceSet] [If no choices are selected on a multi-selection ChoiceSet a JavaScript error is raised when clicking on a Action.Submit button] #5249
[JS][Templating] Template engine broken after change in AEL #5100
[Javascript] Adaptive card doesn't works in IE #4855
[JS] Markdown headings clipped #4847
[JS] Focus media element after it's inserted #5258
[JS] Updated node dependencies #5245
.NET
[Accessibility] Narrator is not reading the selection action title for the Rich Text Block #4856
[.Net HTML][IgnoreDefaultStringEnumConverter] [NullReferenceException] #4831
[.NET Renderer][Performance] Calling Visit on AdaptiveVisitor and passing in an AdaptiveToggleVisibilityAction causes an infinite loop. #4164
[.NET] Add support for choiceSet placeholders to WPF Xceed renderer #5231
[NET] Consume Microsoft.MarkedNet package #5232
[NET] Fix up PackageReferences to reflect our requirements #5230
Android
[Android] Preserve host-provided Action icons #5285
[Android][Accessibility] Access Date/Time picker with Enter key #5319
iOS
[iOS][Framework] Crash when changing ACRButton.iconView.image #5280
[iOS][Build script error] [Latest release binary is incompatible with Xcode 11] #5236
[iOS][Input.Date] [Date picker is not properly visible and getting squeezed] #5235
[iOS][Package Management] XCFramework support #5171
[iOS][custom actions] [selectAction/inlineAction does not support custom actions] #5133
[iOS][Image Rendering] Few images breaks when framework is built with Optimizations #5096
[iOS][UI] [Action/Button is not visible when it's title text is long] #4739
updated width of the card for sample app #5335
[iOS][Action Rendering] Allow for text wrapping in Action buttons #4107
[iOS] size "stretch" doesn't stretch image #4353
[iOS][UI] [Image size or height setting doesn't reflect correctly as desktop view] #3677
UWP
[UWP] Toggles not working correctly in expense report card #5331
[UWP] Crash when choosing view from Activity Update card #5330
[Accessibility] Narrator is not reading the selection action title for the Rich Text Block #4856
AdaptiveCards 2020.12
Latest Packages
- Renderers
Smoke Test Notes
- Automated CI/CD on
release/20.12
branch - Regression tests against:
What's new?
Binary License Updates
With this release we've corrected a long standing error which had been us shipping binary packages under the MIT license inadvertently, which typically only governs open source code use and distribution and doesn't apply to corresponding binary distribution. We have a new EULA for our UWP/.NET/iOS/Android packages at this point linked in this note here for your easy reference. This End User License Agreement is a standard Microsoft license which shouldn't have any anticipated customer impact. Please do feel free to reach out should you observe issues or have concerns.
Website
Schema updates related to #5078
Renderers
JavaScript
- [ALL][Unable to have two SubmitAction Buttons and validation] #5078
- [JavaScript][Input.Number] [Type of value has changed with latest update] #5111
- [JavaScript/WPF/UWP][Automatic tooltip for selectAction title] #4694
- [JavaScript][Extensibility] [Rendering breaks on registering custom element for multiple/expanded choiceset] #5091
- [JavaScript][Accessibility] [ac-horizontal-separator does not set "aria-hidden" to true] #5073
- [JavaScript][Extensibility] [Min/max limit not set on number input] #5092
- [NodeJS] ActionSet.getActionById() always returns undefined #5001
WPF
- [UWP][NET] Introduce correct package EULAs #5169
- [ALL] Unable to have two SubmitAction Buttons and validation #5078
- [JavaScript/WPF/UWP][Automatic tooltip for selectAction title] #4694
Android
- [ALL] Unable to have two SubmitAction Buttons and validation #5078
- [Android][Column Rendering] Long column content shrinks auto/fixed sized columns #4988
- [Android][Inline Action] [Inline Action with image are rendered too big] #5063
- [Android][Rendering] Elements with "height: stretch" cause other elements to vertically shrink #4989
- [Android][Column/ColumnSet rendering] [The height and width allocation in columns has been changed] #5061
- [Android] Column stretch expands too much #4570
- [Android][Container rendering] [The verticalContentAlignment is not working in containers] #5062
- [Android][ColumnSet rendering] ColumnSet with minHeight is generating extra view #5052
- [Android][Column Rendering] Column Bleed crashes #5050
- [Android][Column/ColumnSet rendering] Custom Column rendering forces use of FlexBox Layout #5053
- [Android][Image rendering] Image sizes are not being respected when rendering inside a column #5054
- [Android][Image Rendering] Non-rendered images create app crashes #5048
- [Android][Accessibility] Expanded ChoiceSet elements are not reading labels #5039
- [Android][Accessibility] [Input validation errors] #4881
- [Mobile][User Experience] [Input validation errors]Compact style Input ChoiceSet Focus Style on Error #4889
- [Android][UX] [Input validation error UX does not working with inline actions] #5021
- [Android][Accessibility] [On input validation failure focus does not go to the first invalid input field when the first invalid field is date/time/compact choiceset] #5022
- [Android][Accessibility] [Successful submit action puts the focus on next card/element in chat] #5018
- [Android][Accessibility] [On multiple input validation failures the card scrolls out of viewport] #5019
- [Android] Input.Date doesn't receive focus on error #5014
- [Android][Accessibility][Input Validation] Input elements are not receiving focus after validation #5015
- [Android] Background image not filling the entire container. #4632
iOS
- [iOS][Smoke Test] [Multiline Input's boundary has disappeared] #5179
- [iOS][Packaging] [Removed Arm64 Binary for Simulator] #5170
- [iOS][TextField, checkbox, radio contrast] [Parity issue between iOS and desktop for image width in columnSet] #5151
- [iOS][Accessibilty] [Added relation information to Input.ChoiceSet compact style]#5147
- [iOS][Accessibility] [Fix VoiceOver focus loss for Input.Date]#5131
- [iOS][Accessibility] [Assigned Proper Accessibility Roles to Images with Select Action] #5070
- [iOS][Input.Date UIPickerView Presentation Style is Updated for iOS 14] #5088
- [iOS][Fixed a super view's touch handler overshadowing subview's touch handler issue] #4600
- [iOS][Input ChoiceSet] [Text is getting clipped when wrap:true is not being set] #5105
- [iOS][Accessibility][UISwitch's Offstate color contrast is adjusted] #5090
- [iOS][Accessibility][Updated Luminosity] #5089
- [iOS][Accessibility][Updated Action.OpenURL button to have Link Accessibility Role] #5071
- [iOS][Accessibility][Added Alt Text to Image & Added Accessibility Grouping to Column] #5069
- [iOS][Accessibility][Made Media Icont Accessible] #5068
- [iOS][Accessibility][Fixed the voiceover to ignore 'space' when a label has only whitespace chars] #5067
- [iOS][Custom Action] [Can not send additional properties to action delegates in case of custom action] #5025
- [iOS][ChoiceSet] [choice set not rendered properly for long text] #5023
- [iOS][Accessibility] [View is getting scrolled on submit validation for input.text and input.number when voice over is on] #5024
- [ALL] Unable to have two SubmitAction Buttons and validation #5078
UWP
- [UWP][NET] Introduce correct package EULAs #5169
- [ALL] Unable to have two SubmitAction Buttons and validation #5078
- [JavaScript/WPF/UWP][Automatic tooltip for selectAction title] #4694