Xamarin.CommunityToolkit by Microsoft

<PackageReference Include="Xamarin.CommunityToolkit" Version="1.0.0-pre5" />

---

API Diff between 1.0.0-pre5 and 2.0.0

110 Additions 176 Removals

Xamarin.CommunityToolkit.Behaviors

• public class AnimationBehavior : EventToCommandBehavior
  • public static readonly BindableProperty AnimateCommandProperty
  • public ICommand AnimateCommand { get; }
• public abstract class BaseBehavior<TView> : Behavior<TView> where TView : View
  • protected TView View { get; }
  • protected BaseBehavior()
  • protected bool IsBound(BindableProperty property, BindingBase defaultBinding = null)
  • protected virtual void OnViewPropertyChanged(object sender, PropertyChangedEventArgs e)
• public abstract class CompoundAnimationBase : AnimationBase
• public sealed class EventToCommandBehavior<TType> : EventToCommandBehavior
• public class MultiValidationBehavior : ValidationBehavior
  • public IList<ValidationBehavior> Children { get; }
  • public IList<ValidationBehavior> Children { get; }
• public class ProgressBarAnimationBehavior : BaseBehavior<ProgressBar>
• public class RubberBandAnimation : CompoundAnimationBase
• public class SetFocusOnEntryCompletedBehavior : BaseBehavior<VisualElement>
• public class TadaAnimation : CompoundAnimationBase
• public enum TextDecorationFlags
  • NormalizeWhiteSpace = 8
  • ReduceWhiteSpaces = 8
• public class UserStoppedTypingBehavior : BaseBehavior<InputView>
  • public static readonly BindableProperty CommandParameterProperty
  • public object CommandParameter { get; set; }
• public abstract class ValidationBehavior : BaseBehavior<View>
  • public static readonly BindableProperty FlagsProperty
  • public static readonly BindableProperty ForceValidateCommandProperty
  • public static readonly BindableProperty InvalidStyleProperty
  • public static readonly BindableProperty IsValidProperty
  • public static readonly BindableProperty ValidStyleProperty
  • public static readonly BindableProperty ValueProperty
  • public static readonly BindableProperty ValuePropertyNameProperty
  • protected virtual ICommand DefaultForceValidateCommand { get; }
  • protected virtual string DefaultValuePropertyName { get; }
  • public ValidationFlags Flags { get; set; }
  • public ICommand ForceValidateCommand { get; set; }
  • public Style InvalidStyle { get; set; }
  • public bool IsValid { get; set; }
  • public Style ValidStyle { get; set; }
  • public object Value { get; set; }
  • public string ValuePropertyName { get; set; }
  • protected ValidationBehavior()
  • protected static void OnValidationPropertyChanged(BindableObject bindable, object oldValue, object newValue)
  • protected virtual object DecorateValue()
  • public void ForceValidate()
  • protected abstract bool Validate(object value)

Xamarin.CommunityToolkit.Behaviors.Internals

• public abstract class BaseBehavior<TView> : Behavior<TView> where TView : VisualElement
• public abstract class ValidationBehavior : BaseBehavior<VisualElement>

Xamarin.CommunityToolkit.Converters

• public abstract class BaseConverter<TFrom, TTo> : BaseConverterOneWay<TFrom, TTo>
• public abstract class BaseConverterOneWay<TFrom, TTo> : ValueConverterExtension, IValueConverter
• public abstract class BaseNullableConverter<TFrom, TTo> : BaseNullableConverterOneWay<TFrom, TTo>
• public abstract class BaseNullableConverterOneWay<TFrom, TTo> : ValueConverterExtension, IValueConverter
• public class ByteArrayToImageSourceConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class ColorToBlackKeyConverter : BaseConverterOneWay<Color, double>
• public class ColorToBlackOrWhiteConverter : BaseConverterOneWay<Color, Color>
• public class ColorToByteAlphaConverter : BaseConverterOneWay<Color, byte>
• public class ColorToByteBlueConverter : BaseConverterOneWay<Color, byte>
• public class ColorToByteGreenConverter : BaseConverterOneWay<Color, byte>
• public class ColorToByteRedConverter : BaseConverterOneWay<Color, byte>
• public class ColorToCmykaStringConverter : BaseConverterOneWay<Color, string>
• public class ColorToCmykStringConverter : BaseConverterOneWay<Color, string>
• public class ColorToColorForTextConverter : BaseConverterOneWay<Color, Color>
• public class ColorToDegreeHueConverter : BaseConverterOneWay<Color, double>
• public class ColorToGrayScaleColorConverter : BaseConverterOneWay<Color, Color>
• public class ColorToHexRgbaStringConverter : BaseConverter<Color, string>
• public class ColorToHexRgbStringConverter : BaseConverter<Color, string>
• public class ColorToHslaStringConverter : BaseConverterOneWay<Color, string>
• public class ColorToHslStringConverter : BaseConverterOneWay<Color, string>
• public class ColorToInverseColorConverter : BaseConverterOneWay<Color, Color>
• public class ColorToPercentCyanConverter : BaseConverterOneWay<Color, double>
• public class ColorToPercentMagentaConverter : BaseConverterOneWay<Color, double>
• public class ColorToPercentYellowConverter : BaseConverterOneWay<Color, double>
• public class ColorToRgbaStringConverter : BaseConverterOneWay<Color, string>
• public class ColorToRgbStringConverter : BaseConverterOneWay<Color, string>
• public sealed class CompareConverter : CompareConverter<object>
• public abstract class CompareConverter<TObject> : ValueConverterExtension, IValueConverter
• public class DateTimeOffsetConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class EnumToBoolConverter : ValueConverterExtension, IValueConverter
• public class EnumToIntConverter : ValueConverterExtension, IValueConverter
• public class ImageResourceConverter : BaseNullableConverterOneWay<string, ImageSource>
• public class IntToBoolConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class InvertedBoolConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class IsInRangeConverter : BaseConverterOneWay<IComparable, bool>
• public class IsNotNullOrEmptyConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class IsNullOrEmptyConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class ItemSelectedEventArgsConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class ItemTappedEventArgsConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class ListIsNotNullOrEmptyConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class ListIsNullOrEmptyConverter : ValueConverterExtension, IValueConverter
  • public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
  • public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
• public class MathExpressionConverter : ValueConverterExtension, IValueConverter
• public class MultiMathExpressionConverter : MultiValueConverterExtension, IMultiValueConverter
• public class StringToListConverter : ValueConverterExtension, IValueConverter
• public enum TextCaseType
  • FirstUpperRestLower = 3
• public class UtcDateTimeToLocalStringConverter : ValueConverterExtension, IValueConverter
• public class VariableMultiValueConverter : MultiValueConverterExtension, IMultiValueConverter

Xamarin.CommunityToolkit.Core

• public abstract class MediaSource : Element
  • public static MediaSource FromUri(string uri)

Xamarin.CommunityToolkit.Effects

• public class CornerRadiusEffect
• public enum HoverState
• public class HoverStateChangedEventArgs : EventArgs
• public enum HoverStatus
• public class HoverStatusChangedEventArgs : EventArgs
• public class LifecycleEffect : RoutingEffect
• public class LongPressCompletedEventArgs : EventArgs
• public static class SemanticEffect
• public class SemanticEffectRouter : RoutingEffect
• public class ShadowEffect : RoutingEffect
• public class StatusBarEffect : RoutingEffect
• public enum StatusBarStyle
• public class TouchCompletedEventArgs : EventArgs
• public class TouchEffect : RoutingEffect
• public enum TouchInteractionStatus
• public class TouchInteractionStatusChangedEventArgs : EventArgs
• public enum TouchState
• public class TouchStateChangedEventArgs : EventArgs
• public enum TouchStatus
• public class TouchStatusChangedEventArgs : EventArgs

Xamarin.CommunityToolkit.Effects.Semantic

• public enum HeadingLevel
• public enum SemanticInclusion

Xamarin.CommunityToolkit.Extensions

• public static class ColorExtension
• public static class NavigableElementExtensions
• public static class NavigationExtensions
• public static class SemanticExtensions
• public static class PageExtension
  • public static Task<bool> DisplaySnackBarAsync(this Page page, string message, string actionButtonText, Func<Task> action, int durationMilliseconds = 3000)
  • public static Task<bool> DisplaySnackBarAsync(this Page page, SnackBarOptions snackBarOptions)
  • public static Task DisplayToastAsync(this Page page, string message, int durationMilliseconds = 3000)
  • public static Task DisplayToastAsync(this Page page, ToastOptions toastOptions)
• public static class VisualElementExtension
• public abstract class ValueConverterExtension : IMarkupExtension<IValueConverter>, IMarkupExtension
  • protected ValueConverterExtension()
  • public IValueConverter ProvideValue(IServiceProvider serviceProvider)

Xamarin.CommunityToolkit.Extensions.Internals

• public class MultiValueConverterExtension : IMarkupExtension<IMultiValueConverter>, IMarkupExtension
• public abstract class ValueConverterExtension : BindableObject, IMarkupExtension<IValueConverter>, IMarkupExtension

Xamarin.CommunityToolkit.Helpers

• public class DelegateWeakEventManager
• public class LocalizationResourceManager : INotifyPropertyChanged
  • public event PropertyChangedEventHandler PropertyChanged
  • public LocalizationResourceManager()
  • public void Init(ResourceManager resource, CultureInfo initialCulture)
• public class LocalizedString : ObservableObject
• public enum MultiBindingCondition
• public class WeakEventManager
  • public WeakEventManager()
  • public void AddEventHandler(Delegate handler, string eventName = "")
  • public void RaiseEvent(object sender, object eventArgs, string eventName)
  • public void RaiseEvent(string eventName)
  • public void RemoveEventHandler(Delegate handler, string eventName = "")
• public class WeakEventManager<TEventArgs>
  • public void HandleEvent(object sender, TEventArgs eventArgs, string eventName)
  • public void HandleEvent(TEventArgs eventArgs, string eventName)
• public static class WeakEventManagerExtensions
• public static class XCT

Xamarin.CommunityToolkit.ObjectModel

• public class AsyncCommand : BaseAsyncCommand<object, object>, IAsyncCommand, ICommand
  • public AsyncCommand(Func<Task> execute, Func<bool> canExecute, Action<Exception> onException = null, bool continueOnCapturedContext = false, bool allowsMultipleExecutions = true)
• public class AsyncCommand<T> : BaseAsyncCommand<T, object>, IAsyncCommand<T>, ICommand
  • public AsyncCommand(Func<T, Task> execute, Func<bool> canExecute, Action<Exception> onException = null, bool continueOnCapturedContext = false, bool allowsMultipleExecutions = true)
• public class AsyncValueCommand : BaseAsyncValueCommand<object, object>, IAsyncValueCommand, ICommand
  • public AsyncValueCommand(Func<ValueTask> execute, Func<bool> canExecute, Action<Exception> onException = null, bool continueOnCapturedContext = false, bool allowsMultipleExecutions = true)
• public class AsyncValueCommand<T> : BaseAsyncValueCommand<T, object>, IAsyncValueCommand<T>, ICommand
  • public AsyncValueCommand(Func<T, ValueTask> execute, Func<bool> canExecute, Action<Exception> onException = null, bool continueOnCapturedContext = false, bool allowsMultipleExecutions = true)
• public static class CommandFactory
• public class Grouping<TKey, TItem> : ObservableRangeCollection<TItem>
• public class Grouping<TKey, TSubKey, TItem> : ObservableRangeCollection<TItem>
• public class BaseAsyncCommand<TExecute, TCanExecute> : BaseCommand<TCanExecute>, ICommand
  • public BaseAsyncCommand(Func<TExecute, Task> execute, Func<TCanExecute, bool> canExecute, Action<Exception> onException, bool continueOnCapturedContext, bool allowsMultipleExecutions)
• public class BaseAsyncValueCommand<TExecute, TCanExecute> : BaseCommand<TCanExecute>, ICommand
  • public BaseAsyncValueCommand(Func<TExecute, ValueTask> execute, Func<TCanExecute, bool> canExecute, Action<Exception> onException, bool continueOnCapturedContext, bool allowsMultipleExecutions)
• public abstract class BaseCommand<TCanExecute>
  • public bool AllowsMultipleExecutions { get; }
  • protected int ExecutionCount { get; protected set; }
  • public bool IsExecuting { get; }
  • public event EventHandler CanExecuteChanged
  • public BaseCommand(Func<TCanExecute, bool> canExecute, bool allowsMultipleExecutions)
  • public bool CanExecute(TCanExecute parameter)
  • public void RaiseCanExecuteChanged()
• public static class ObservableRangeCollectionExtension

Xamarin.CommunityToolkit.ObjectModel.Extensions

• public static class INotifyPropertyChangedExtension

Xamarin.CommunityToolkit.ObjectModel.Internals

• public class BaseAsyncCommand<TExecute, TCanExecute> : BaseCommand<TCanExecute>, ICommand
• public abstract class BaseAsyncValueCommand<TExecute, TCanExecute> : BaseCommand<TCanExecute>, ICommand
• public abstract class BaseCommand<TCanExecute>

Xamarin.CommunityToolkit.PlatformConfiguration.AndroidSpecific

• public static class NavigationBarEffect
• public enum NavigationBarStyle

Xamarin.CommunityToolkit.PlatformConfiguration.WindowsSpecific

• public static class PopUp

Xamarin.CommunityToolkit.PlatformConfiguration.iOSSpecific

• public enum PopoverArrowDirection
• public static class PopUp

Xamarin.CommunityToolkit.UI.Views

• public class BadgeView : BaseTemplatedView<Grid>
  • public static readonly BindableProperty CornerRadiusProperty
  • public float CornerRadius { get; set; }
• public abstract class BaseLazyView : ContentView, IDisposable
• public abstract class BasePopup : VisualElement, IElementConfiguration<BasePopup>
• public enum CameraCaptureMode
• public abstract class BaseTemplatedView<TControl> : TemplatedView where TControl : View
  • protected TControl Control { get; }
  • public BaseTemplatedView()
  • protected abstract void OnControlInitialized(TControl control)
• public enum CameraCaptureOptions
  • Default = 0
  • Photo = 1
  • Video = 2
• public class CameraView : View
  • public static readonly BindableProperty CaptureModeProperty
  • public static readonly BindableProperty CaptureOptionsProperty
  • public static readonly BindableProperty SavePhotoToFileProperty
  • public CameraCaptureMode CaptureMode { get; set; }
  • public CameraCaptureOptions CaptureOptions { get; set; }
  • public bool SavePhotoToFile { get; set; }
• public class CupertinoTabViewItemTemplate : Grid
  • public CupertinoTabViewItemTemplate()
• public enum Dock
• public class DockLayout : Layout<View>
• public class DrawingLineCompletedEventArgs : EventArgs
• public class DrawingView : View
• public class Expander : BaseTemplatedView<StackLayout>
  • public static readonly BindableProperty AnimationEasingProperty
  • public static readonly BindableProperty AnimationLengthProperty
  • public static readonly BindableProperty TouchCaptureViewProperty
  • public Easing AnimationEasing { get; set; }
  • public uint AnimationLength { get; set; }
  • public View TouchCaptureView { get; set; }
• public class HexLayout : Layout<View>
• public enum HexOrientation
• public class LazyView<TView> : BaseLazyView where TView : View
• public class Line : BindableObject
• public class MaterialTabViewItemTemplate : Grid
  • public MaterialTabViewItemTemplate()
• public class MediaCapturedEventArgs : EventArgs
  • public double Rotation { get; }
  • public FileMediaSource Video { get; }
  • public string Path { get; }
  • public MediaSource Video { get; }
• public class MediaElement : View, IMediaElementController
  • public static readonly BindableProperty SpeedProperty
  • public double Speed { get; set; }
• public class Popup : Popup<object>
• public abstract class Popup<T> : BasePopup
• public class PopupDismissedEventArgs : PopupDismissedEventArgs<object>
• public class PopupDismissedEventArgs<T> : EventArgs
• public class PopupOpenedEventArgs : EventArgs
• public class SemanticOrderView : ContentView
• public class Shield : BaseTemplatedView<Frame>
  • public static readonly BindableProperty StatusBackgroundColorProperty
  • public static readonly BindableProperty StatusTextColorProperty
  • public static readonly BindableProperty SubjectBackgroundColorProperty
  • public static readonly BindableProperty SubjectTextColorProperty
  • public Color StatusBackgroundColor { get; set; }
  • public Color StatusTextColor { get; set; }
  • public Color SubjectBackgroundColor { get; set; }
  • public Color SubjectTextColor { get; set; }
• public enum SideMenuAppearanceType
• public class SideMenuView : BaseTemplatedView<AbsoluteLayout>
  • public static readonly BindableProperty AllowInterceptGestureProperty
  • public static readonly BindableProperty MainViewOpacityFactorProperty
  • public static readonly BindableProperty MainViewScaleFactorProperty
  • public static readonly BindableProperty MenuAppearanceTypeProperty
  • public static readonly BindableProperty ParallaxValueProperty
  • public bool AllowInterceptGesture { get; set; }
  • public static double GetMainViewOpacityFactor(BindableObject bindable)
  • public static double GetMainViewScaleFactor(BindableObject bindable)
  • public static SideMenuAppearanceType GetMenuAppearanceType(BindableObject bindable)
  • public static double GetParallaxValue(BindableObject bindable)
  • public static void SetMainViewOpacityFactor(BindableObject bindable, double value)
  • public static void SetMainViewScaleFactor(BindableObject bindable, double value)
  • public static void SetMenuAppearanceType(BindableObject bindable, SideMenuAppearanceType value)
  • public static void SetParallaxValue(BindableObject bindable, double value)
• public class StateView : ContentView
  • public static readonly BindableProperty RepeatTemplateProperty
  • public static readonly BindableProperty TemplateProperty
  • public DataTemplate RepeatTemplate { get; set; }
  • public DataTemplate Template { get; set; }
• public class TabViewItem : TemplatedView
  • public const string SelectedVisualState = "Selected"
  • public const string UnselectedVisualState = "Unselected"
• public class TextSwitcher : Label, IViewSwitcher
• public enum TransitionType
• public class UniformGrid : Layout<View>
• public class WindowsTabViewItemTemplate : Grid
  • public WindowsTabViewItemTemplate()

Xamarin.CommunityToolkit.UI.Views.Internals

• public abstract class BaseTemplatedView<TControl> : TemplatedView where TControl : View

Xamarin.CommunityToolkit.UI.Views.Options

• public class MessageOptions
  • public static Font DefaultFont { get; set; }
  • public static string DefaultFontFamily { get; set; }
  • public static double DefaultFontSize { get; set; }
  • public static Thickness DefaultPadding { get; set; }
  • public Font Font { get; set; }
  • public string FontFamily { get; set; }
  • public double FontSize { get; set; }
  • public Thickness Padding { get; set; }
• public class SnackBarActionOptions
  • public static Font DefaultFont { get; set; }
  • public static string DefaultFontFamily { get; set; }
  • public static double DefaultFontSize { get; set; }
  • public static Thickness DefaultPadding { get; set; }
  • public Font Font { get; set; }
  • public string FontFamily { get; set; }
  • public double FontSize { get; set; }
  • public Thickness Padding { get; set; }
• public class ToastOptions
  • public static Thickness DefaultCornerRadius { get; set; }
  • public Thickness CornerRadius { get; set; }
  • public void SetResult(bool result)