XBottomSheet 1.0.4-beta

This is a prerelease version of XBottomSheet.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package XBottomSheet --version 1.0.4-beta                
NuGet\Install-Package XBottomSheet -Version 1.0.4-beta                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="XBottomSheet" Version="1.0.4-beta" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add XBottomSheet --version 1.0.4-beta                
#r "nuget: XBottomSheet, 1.0.4-beta"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install XBottomSheet as a Cake Addin
#addin nuget:?package=XBottomSheet&version=1.0.4-beta&prerelease

// Install XBottomSheet as a Cake Tool
#tool nuget:?package=XBottomSheet&version=1.0.4-beta&prerelease                

XBottomSheet

Build Status

XBottomSheet.Touch XBottomSheet.Droid .Touch.Sample .Droid.Sample
Build status Build status Build status Build status

Preview

alternate text is missing from this package README image

Blogs

https://butonium.com/custom-bottomsheet-xamarin/

Setup

On client projects install the nuget XBottomSheet (NuGet) and then follow the steps based on platform:

iOS

Standard
  1. Create a new ViewController of type BottomSheetViewController within the ViewController that you want to add it to:
public override void ViewDidLoad()
{
    base.ViewDidLoad();
    var bottomSheetViewController = new BottomSheetViewController(100, 300, 500, true, BottomSheetState.Bottom);
}

For more details on options for the constructors or their parameters, please check the implementation.

  1. Add the newly created ViewController as a child to the current one:
    AddChildViewController(bottomSheetViewController);
    View.AddSubview(bottomSheetViewController.View);
    bottomSheetViewController.DidMoveToParentViewController(this);
  1. Define the Frame for the View of the BottomSheet control:
    bottomSheetViewController.View.Frame = new CGRect(0, View.Frame.GetMaxY(), View.Frame.Width, View.Frame.Height);
  1. Add your custom view within as until now it would be only a blue view that can be dragged around:
    customView = CustomView.Create();
    customView.Frame = View.Frame;
    bottomSheetViewController.SetCustomView(customView);
MvvmCross

After following the steps from previous way, continue with following:

  1. As you can add any control within that custom view, in order to make it available for binding, you have to create a public geter/setter for it, similar to this:
    public UILabel CustomValue
    {
        get
        {
            return lbCustomValue;
        }
        set
        {
            lbCustomValue = value;
        }
    }
  1. Within the MainViewController (or parent view controller) create a binding set between the controls that you have in the custom view and the view model associated with the parent view controller:
    var set = this.CreateBindingSet<MainViewController, MainViewModel>();
    set.Bind(customView.CustomValue).For(t => t.Text).To(vm => vm.CustomValue);
    set.Apply();

Check the Touch.MSample for actual sample on how a value is passed in between.

Android

Standard
  1. You can use this view by adding it within your layout:
   <XBottomSheet.Droid.Views.XBottomSheetView
	android:id="@+id/BottomSheet"
	app:anchorOffset="320dp"
	app:peekHeight="192dp"
	app:defaultState="collapsed"
	android:layout_width="match_parent"
	android:layout_height="match_parent">
   </XBottomSheet.Droid.Views.XBottomSheetView>
  1. In order to use a custom view you will need to inflate a desired Android layout file (ex. CustomView.axml) and assign it to the ContentView property of XBottomSheetView:
    var bottomSheetView = FindViewById<XBottomSheetView>(Resource.Id.BottomSheet);
    var customView = LayoutInflater.Inflate(Resource.Layout.CustomView, null);
    
    bottomSheetView.ContentView = customView;
    bottomSheetView.BackgroundColor = Color.Transparent;
MvvmCross

After following previous steps, in order to bind the ViewModel with your CustomView you'll need to replace LayoutInflater.Inflate with BindingInflate

   var customView = this.BindingInflate(Resource.Layout.CustomView, null);

Android

Known issues/difficulties

  • If you add this controll with GMSMapView or other similar feature that has its own gesture management it is possible to prevent XBottomSheet to trigger the PanGesture method, even if it registers it. For GMSMapView, the fix is to have "mapView.Settings.ConsumesGesturesInView = false;", where mapView is your GMSMapView object.

Conclusion

If you have a question or a suggestion, please add an issue and we'll discuss over it. We're open to respond, add new features, fine tune our solutions or, last, but most important, to fix bugs/problems that you encounter.

As you've got this far and our code might helped you, support us to build more content like this through:

<a href="https://www.buymeacoffee.com/grendio" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: auto !important;width: auto !important;" ></a>

Product Compatible and additional computed target framework versions.
MonoAndroid monoandroid10 is compatible. 
Xamarin.iOS xamarinios10 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.5-beta6 442 5/15/2021
1.0.5-beta5 272 5/15/2021
1.0.5-beta4 272 5/15/2021
1.0.5-beta3 261 5/15/2021
1.0.5-beta2 229 5/15/2021
1.0.5-beta 232 5/15/2021
1.0.4-preview 526 3/17/2020
1.0.4-beta 464 2/3/2020
1.0.3 3,914 1/30/2019
1.0.2-beta 499 1/29/2019
1.0.0 989 1/14/2019
0.0.2-beta 752 12/25/2018
0.0.1 700 12/23/2018