XamarinCommunityToolkit Versions Save

I don't even know where to begin with this one. Our next bigger release with so many good things. We've done many bugfixes, but on top of that cool stuff has been added. How about an Effect that gives you lifecycle events on your views? It seems small, but I think a lot of people were waiting for this one.

Or popups! A huge shoutout to @ahoefling for working closely with us on merging this one. Native popups made easy for you on iOS, Android and UWP. But we didn't stop there: shadow support, animated progress on the ProgressBar, and...

A LazyView! This view allows you to basically lazy load anything, yes, that includes tabs in the TabView.

Go check out the full list below, install the nuget and let us know your thoughts, I want to make this stable ASAP!

✨ Added

• Added new TextCaseType to TextCaseConverter (#763)
• Add LocalizedString class for automatic ViewModel string updates (#750)
• Add CommandFactory class (#797)
• ShadowEffect (#725)
• Implemented LazyView (#796)
• Adds Popup Control (#653)
• No padding around text in a Toast or Snackbar (#714) (bug, added? I'm an optimistic guy)
• Make ShieldView more customizable (#874)
• ProgressBar Attached Property to enable progress animation (#352)
• Add "Add(IEnumerable<T> collection)" to ObservableRangeCollection<T>
• LifeCycleEvents (#674)
• Add Grouping class from Refractored.MvvmHelpers (#957)

🐛 Fixes

• Changed LoadView to be Async (#828)
• Popup out of the screen horizontally in Android sample (#839)
• [Android] Converting dimensions to pixels in popup renderer (#856)
• SourceLink Support reinstated
• [iOS] Remove popup arrow if anchor isn't set (#854)
• [Breaking Change] ValidationBehavior Async checks support (#912)

💀 Deprecated

• Deprecate LocalizationResourceManager.SetCulture (#766)

🏡 Housekeeping

• Adding converter samples (#954)

We could not have done this release without you, so thank you: @JoacimWall, @maxkoshevoi, @ahoefling, @brminnick, @geskill, @Cfun1, @VladislavAntonyuk, @Depechie, @Hackavist

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @sthewissen and... me 🤓

This release has a lot of bug fixes! In addition, we're also adding meaningful comments to all public members which end up in our NuGet so you'll have a bit of guidance in your IDE on what our APIs are doing. We're also working to get these online so you'll have a reference there too.

Some minor new functionality was added too. Just check out the list below! Enjoy!

New and Shiny

• ValidationBehavior: Added IsNotValid property (#836)
• Changed TabView.SelectedIndex property to use TwoWay binding mode (#903)
• Added CommandParameter to UserStoppedTypingBehavior (#930)
• TabViewItem VisualStates (#803)

Bugfixes

• Fix AsyncCommand.CanExecute() null reference exception (#789)
• [Android] TouchEffect NativeAnimation triggered twice (#804)
• [Android] Fix Long Press blocks CollectionView selection (#764)
• [Android] Fix SideMenuView + Slider issue (#824)
• [Bug] SideMenuView does not visualize left and right menu correctly (#859)
• [Bug] SideMenuView does not open if Bind State property in XAML (#822)
• Fixes AvatarView - Valid source images dont load for the first time they are created (#849)
• Fix camera media rotation android issue (#886)
• Fix LocalizationResourceManager.Init(ResourceManager, CultureInfo) doesn't trigger property changed (#915)
• fixed a null check in the iOS FormsCameraView (#923)
• Don't throw when tap/selected is null, return null. For deselect. (#950)
• Setting TabView.SelectedIndex does not "visually" switch tabs (#738)

Housekeeping

• Sort BaseGalleryViewModel.Items by Title (#813)
• Remove Device dependency from command implementation (#830)
• Removed duplicate text in Sample App (#888)
• Add null checks to first extension method argument (#943)
• Ensured that observers are added only once for MediaElement (#928)
• Add #region to specify Linker Work-Around (#920)

A big shoutout to all of our contributors: @maxkoshevoi, @brminnick, @WebDucer, @WillAutioItrax, @Cfun1, @UKDeveloper99, @michaldivis, @jBijsterboschNL, @jamesmontemagno, @Huaba93, @Jouna77

And of course our awesome dedicated team members: @AndreiMisiukevich, @jsuarezruiz, @pictos, @sthewissen and... me 🤓

New functionality for you to enjoy:

• Add BaseCommand.ChangeCanExecute() (#736)
• Add Func canExecute parameter to AsyncCommand & AsyncValueCommand (#782)

Fixed Bugs:

• Fix culture not persisted to new pages (#749)
• Fixed naming convention of CaptureModeProperty (#775) BREAKING! Sorry!
• The UIHoverGestureRecognizer availability starts with iOS 13 (#783)

Housekeeping:

• Avoid users to create new instances of the LocalizationResourceManager (#770)

Yes! There is a breaking change in there, sorry about that. But it wasn't usable in its current form anyway. As a result of a last-minute rename of a property I (Gerald, blame it on me) forgot to rename the BindableProperty which resulted in a property that couldn't be used for binding. Since it wasn't working right now, chances are small you're actually using it so I decided to incorporate this breaking change in a minor version which normally should never happen.

Enjoy!

This version removes the (wrongly added) Xamarin.CommunityToolkit.Markup dependency from the Xamarin.CommunityToolkit package.

Users that have installed the Xamarin.CommunityToolkit package with v1.0.0 got the Xamarin.CommunityToolkit.Markup package for free because it was marked as a dependency, while there is no actual dependency. Sorry about that!

The implications shouldn't be that big. If you're not using any code from the Markup package, the compiler will strip out the dependency, so your app size was not impacted. If you're not using the Markup features, you can install this v1.0.1 version and then uninstall the Markup one.

Sorry for any inconvenience!

All the goodness in this first release:

Views

• Badge (#337)
• CameraView
• DockLayout (#432)
• Expander: ported from Xamarin.Forms
• Shield (#338)
• SideMenuView
• Snackbar (#197)
• StateLayout (previously known as StateSquid) (#450)
• TabView (#525)
• TouchEffect (#566)
• UniformGrid (#619)

Behaviors

• ImpliedOrderGridBehavior
• Masked behavior
• MaxLengthReachedBehavior
• MultiValidationBehavior
• ObservableRangeCollection: ported from MVVMHelpers
• UrlValidationBehavior
• UserStoppedTypingBehavior
• TextCharactersValidationBehavior

Converters

• DateTimeOffsetConverter (#248)
• ListToStringConverter (#304)
• StringToDoubleConverter
• StringToIntConverter
• VariableMultiConverter (#628)

Effects

• RemoveBorderEffect and SelectAllTextEffect (#492)
• Icon Tint Color effect (#516)

Other

• Added Default XmlnsDefinition (#357)
• Added C# Markup Extensions (#522) (Separate NuGet package)
• Library is linker safe 🎉 !

Added:

• TouchEffect (#566)
• UniformGrid (#619)
• DockLayout (#432)
• VariableMultiConverter (#628)

And numerous of quality enhancements and bug fixes. Notably a bug where IntelliSense would not work properly and the dependency on Xamarin.Forms is now Xamarin.Forms 5.

Added:

• Tizen sample added
• Shield (#338)
  • Extend Shield view with FontSize, FontFamily and FontAttributes (#491)
• Badge (#337)
• Added RemoveBorderEffect and SelectAllTextEffect (#492)
• Added StateLayout (previously known as StateSquid) (#450)
• Added icon tint color effect (#516)
• Added Default XmlnsDefinition (#357)
• Added TabView (#525)
• Added C# Markup Extensions (Separate NuGet package)

And numerous of quality enhancements and bug fixes

Added:

• ImpliedOrderGridBehavior
• Snackbar (#197)
• Add Commands to CameraView (#334)
• User stopped typing behavior extend with minimum text length property (#389)
• Added GTK & WPF support
• Added AvatarView.ColorTheme
• Added TextCharactersValidationBehavior
• Added MaxLengthReachedBehavior
• [AvatarView] Add the Attribute TypeConverter for NamedSize use
• Added StringToDoubleConverter and StringToIntConverter

And bugfixes across the board 🎉

Added functionality:

• MultiValidationBehavior
• ObservableRangeCollection: ported from MVVMHelpers
• CameraView
• DateTimeOffsetConverter
• UserStoppedTypingBehavior
• Expander: ported from Xamarin.Forms
• ListToStringConverter

Enhanced functionality:

• NumericValidationBehavior: Added Max/Min decimal places

And we now have an official logo!

New for pre2:

• SideMenuView
• Masked behavior
• UrlValidationBehavior
• Library is now linker safe 🎉 !