Skip to content

Xamarin Forms GridView developed on the basis of the adapter pattern so easily we can bind custom grid view with data it also behave data grid for same check examples.

License

Notifications You must be signed in to change notification settings

kishandonga/Xamarin-GridView

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Xamarin Forms GridView


Xamarin Forms GridView No Longer Maintain anyone can fork and publish as NuGet Package


More screenshots:
GridView with images
GridView with alphabet characters
GridView as DataGrid - 1
GridView as DataGrid - 2

This is Android Adapter Pattern GridView in the Xamarin Forms, which simply takes your list of the data and convert into the grid pattern as like in android. you just need to pass the item count and root view of your cell.

Installation

This GridView code added into your xamarin form project and rebuild project. For, the more information refer this XamGridView sample project.

Usage

Here's an example of code to write custom adapter class of the GridView and how to use adapter pattern in the xamarin forms. You can see the complete code sample here:

Custom adapter class of the GridView which is extende the abstract class GridAdapter and need to implements this three methods. You can see the code of this file here:

public class ImagesGridAdapter : GridAdapter	
{    
    private List<string> lstImages;    

    public ImagesGridAdapter(List<string> lstImages)    
    {    
        this.lstImages = lstImages;    
    }    

    public override int GetCount()    
    {    
        return lstImages.Count;    
    }    

    public override object GetItem(int position)    
    {    
        return lstImages[position];    
    }    

    public override View GetView(int position, View convertView, View parentView)    
    {    
        ImagesGridViewHolder holder;    

        if (convertView == null)    
        {    
            holder = new ImagesGridViewHolder();    
            convertView = holder.getRootView();    
            convertView.BindingContext = holder;    
        }    
        else    
        {    
            holder = (ImagesGridViewHolder)convertView.BindingContext;    
        }    

        //.....    

        return convertView;    
    }    
}    

Xamarin does not have layout inflater facility so, need to manually write grid cell code which is our view holder class. You can see the code of this file here:

public class ImagesGridViewHolder
{
    public Image img;

    public ImagesGridViewHolder()
    {
        img = new Image();
        img.Aspect = Aspect.Fill;
    }

    // To get the root view of the your cell
    public View getRootView()
    {
        return img;
    }
}

XAML:

First add the xmlns namespace:

xmlns:grid="clr-namespace:DLab.Views;assembly=DLab.GridView"

Then add this sample xaml code:

<StackLayout>
    <grid:GridView x:Name="gridLayout" 
          NumColumns="3" 
          ScrollToEnd="False" 
          Padding="5,5,5,5" />
</StackLayout>
ImagesGridAdapter adapter = new ImagesGridAdapter(lstImages);
// always first initialize tap event then after pass the item source
gridLayout.ItemTapped += Handle_TapEvent;
gridLayout.ItemSource = adapter;

Event:

private void Handle_TapEvent(object s, GridEventArgs arg)
{
    Device.BeginInvokeOnMainThread(() =>
    {
        // get the selected view holder from the Event arguments
        // arg.view.BindingContext => to get the ViewHolder
        // arg.position
    });
}

Bindable Properties

Properties Version Description
NumColumns 1.0 How many columns are required, minimum 1 and default 3
ScrollToEnd 1.0 If true then automatically scrolling view else not, default false
ColumnSpacing 1.0 To give the space between two column, default 6.0
RowSpacing 1.0 To give the space between two row, default 6.0

Update GridView

It does not follow the observing pattern so when you do change in your list, you need to notify view using this methods NotifyDataSetChanged() or NotifyDataSetChanged(int position). For, more information refer this code sample here:

Small Print

Current issues

  • GridView cell not support animations when initialize
  • If TapEvent initialize after ItemSource then it is consider as null so, event not detects

Contributing

Contributions are welcome! If you find a bug please report it and if you want add new feature then please suggest to me. If you want to contribute code please file an issue and create a branch off of the current dev branch and file a pull request.

About me

I'm Kishan Donga and you can connect with me via below links, I am a developer and I love to create innovations.

LinkedIn @ikd96 Email kishandonga.92@gmail.com Twitter @ikishan96 Instagram @ikishan96

License

Xamarin-GridView is released under the GPU license.

About

Xamarin Forms GridView developed on the basis of the adapter pattern so easily we can bind custom grid view with data it also behave data grid for same check examples.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages