# DragBoardView Android 可拖拽的看板视图, 支持项拖拽、列拖拽，支持自动居中。简单易用，和 `RecyclerView` 用法完全一样！ ## 像 `RecyclerView` 一样使用 `DragBoardView` ! [中文文档](https://github.com/LinXueyuanStdio/DragBoardView/blob/master/README_zh.md) `Recyclerview` 的用法:

1. 添加 recyclerview 的依赖

``` compile 'com.android.support:recyclerview-v7:23.1.0' ``` 在 xml 布局文件中声明: ```xml ```

2. 写 item 的布局

```xml ```

3. 写 item 对应的数据类.

什么类都行 ```java public class Item { private String name; public Item(String n) { name = n; } public String getName() { return name; } public void setName(String name) { this.name = name; } } ```

4. 写适配器 adapter

```java public class ItemArrayAdapter extends RecyclerView.Adapter { //All methods in this adapter are required for a bare minimum recyclerview adapter private int listItemLayout; private ArrayList itemList; // Constructor of the class public ItemArrayAdapter(int layoutId, ArrayList itemList) { listItemLayout = layoutId; this.itemList = itemList; } // get the size of the list @Override public int getItemCount() { return itemList == null ? 0 : itemList.size(); } // specify the row layout file and click for each row @Override public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { View view = LayoutInflater.from(parent.getContext()).inflate(listItemLayout, parent, false); ViewHolder myViewHolder = new ViewHolder(view); return myViewHolder; } // load data in each row element @Override public void onBindViewHolder(final ViewHolder holder, final int listPosition) { TextView item = holder.item; item.setText(itemList.get(listPosition).getName()); } // Static inner class to initialize the views of rows static class ViewHolder extends RecyclerView.ViewHolder implements View.OnClickListener { public TextView item; public ViewHolder(View itemView) { super(itemView); itemView.setOnClickListener(this); item = (TextView) itemView.findViewById(R.id.txtChords); } @Override public void onClick(View view) { Log.d("onclick", "onClick " + getLayoutPosition() + " " + item.getText()); } } ```

5. 将适配器 adapter 和 recyclerview 绑定

```java public class MainActivity extends AppCompatActivity { RecyclerView recyclerView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Initializing list view with the custom adapter ArrayList itemList = new ArrayList(); ItemArrayAdapter itemArrayAdapter = new ItemArrayAdapter(R.layout.list_item, itemList); recyclerView = (RecyclerView) findViewById(R.id.item_list); recyclerView.setLayoutManager(new LinearLayoutManager(this)); recyclerView.setItemAnimator(new DefaultItemAnimator()); recyclerView.setAdapter(itemArrayAdapter); // Populating list items for(int i=0; i<100; i++) { itemList.add(new Item("Item " + i)); } } } ```

`DragBoardView` 的用法和 `RecyclerView` 一样。 `DragBoardView` 的用法:

1. 添加 DragBoardView 的依赖

在项目根目录的 `build.gradle` 添加: ```gradle allprojects { repositories { ... maven { url 'https://jitpack.io' } } } ``` 添加依赖 ```gradle dependencies { compile 'com.github.LinXueyuanStdio:DragBoardView:v1.0.0' } ``` 在 `xml` 中声明使用 ```xml ```

2. 写 column 和 item 的布局文件.

column 是列，它必须包含一个 `RecyclerView` ```xml ``` item 是列中的项，它的布局请随便写 ```xml ```

3. 写 column 和 item 对应的数据类

column 类必须实现 `DragColumn` 接口. ```java public class Entry implements DragColumn { private final String name; private int columnIndex; private final List itemList; public Entry(String name, int columnIndex, List items) { this.name = name; this.columnIndex = columnIndex; this.itemList = items; } public String getName() { return name; } public List getItemList() { return itemList; } @Override public int getColumnIndex() { return columnIndex; } @Override public void setColumnIndex(int columnIndexInHorizontalRecycleView) { //save to database here } } ``` item 类必须实现 `DragItem` 接口. ```java public class Item implements DragItem { private final String itemName; private int colIndex; private int itemIndex public Item(String itemName, int colIndex, int itemIndex) { this.itemName = itemName; this.colIndex = colIndex; this.itemIndex = itemIndex; } public String getItemName() { return itemName; } @Override public int getColumnIndex() { return colIndex; } @Override public int getItemIndex() { return itemIndex; } @Override public void setColumnIndex(int columnIndexInHorizontalRecycleView) { //save to database here } @Override public void setItemIndex(int itemIndexInVerticalRecycleView) { //save to database here } } ```

4. 写适配器 adapter

有两个适配器，一个是列适配器，一个是列中包含的 `RecyclerView` 所需的适配器 ```java public class ColumnAdapter extends HorizontalAdapter {...} public class ItemAdapter extends VerticalAdapter {...} ```

5. 将适配器 adapter 和 DragBoardView 绑定

```java public class MainActivity extends AppCompatActivity { DragBoardView dragBoardView; List mData = new ArrayList<>(); @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); dragBoardView = findViewById(R.id.layout_main); mAdapter = new ColumnAdapter(this); mAdapter.setData(mData); dragBoardView.setHorizontalAdapter(mAdapter); } } ```

## gif