搜尋套件、儲存庫與 APP 分類

套件詳情v0.2.5

dragablegridview_flutter

一個可拖動的 GridView,長按觸發可拖動狀態,釋放手指後重新排列 GridView

近 30 天下載
104
喜歡數
21
Pub 分數
40

安裝套件

flutter pub add dragablegridview_flutter

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

DragableGridView Flutter 是一個套件,可實現 GridView 內項目之間的拖曳重排。當使用者長按某個項目時,該項目會進入可拖曳狀態,允許透過拖曳和放置來重新排列網格佈局。當使用者釋放手指時,重排動作即完成。此套件增強了基於網格介面的使用者互動體驗,非常適合用於可自訂佈局的場景,例如儀表板或圖片畫廊。它與 Flutter 的元件系統無縫整合,只需加入相依性即可使用,無需額外設定。

適用情境

  • 可自訂的儀表板佈局
  • 可重新排序的圖片畫廊
  • 互動式任務管理看板
  • 使用者定義的內容排列
  • 可拖動的產品網格

主要特色

  • 長按以開始拖曳
  • 釋放時平滑重新排序
  • 內建拖曳反饋
  • 與 GridView 的簡單整合
  • 無外部依賴

適合對象

  • 開發互動式網格介面的開發者
  • 需要使用者驅動內容排列的應用程式
  • 具有動態佈局的 UI 需要
  • 具有視覺組織功能的教育或生產力應用

使用建議

  • 拖曳動畫的自訂選項有限
  • 無內建拖曳預覽自定義支援
  • 處理大型數據集時可能需要性能調優
  • 未針對嵌套滾動視圖進行優化

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

DragableGridview

pub package

用GridView编写的可拖动排序View,可任意拖动位置.长按触发拖动,松开手指重新排序,为满足大家的需求,现在增加了“删除动画” ;可能有的人只需要删除动画,而有的人却需要拖动动画,还有的人2个都需要, 我们可以在代码里通过属性来控制使用哪个功能

请不要在拖动的时候更新增加或者删除的数据

A dragable gridview,Long-pressed triggers draggable state,When dragging until covere other items, other Items trigger the animation to make room for the draggable Item,GridView reordering after release your finger,Now I have added "Delete Animation"; some people may only need the delete animation, some people only need the drag animation, and some people need it all. We can control the function by properties.

Please do not update the added data or deleted data while dragging

HomePage:https://github.com/baoolong/DragableGridview

MoreWidght:https://github.com/OpenFlutter/PullToRefresh

Usage

Add this to your package's pubspec.yaml file:

dependencies:
  dragablegridview_flutter: ^0.2.5

Add it to your dart file:

import 'package:dragablegridview_flutter/dragablegridview_flutter.dart';

And GridView dataBin must extends DragAbleGridViewBin ,Add it to your dataBin file

import 'package:dragablegridview_flutter/dragablegridviewbin.dart';

Example

DataBin example (must extends DragAbleGridViewBin)
import 'package:dragablegridview_flutter/dragablegridviewbin.dart';

class ItemBin extends DragAbleGridViewBin{

  ItemBin( this.data);

  String data;

  @override
  String toString() {
    return 'ItemBin{data: $data, dragPointX: $dragPointX, dragPointY: $dragPointY, lastTimePositionX: $lastTimePositionX, lastTimePositionY: $lastTimePositionY, containerKey: $containerKey, containerKeyChild: $containerKeyChild, isLongPress: $isLongPress, dragAble: $dragAble}';
  }

}
Widget Usage Example
import 'package:dragablegridview_flutter/dragablegridview_flutter.dart';
import 'package:flutter/material.dart';

import 'gridviewitembin.dart';


class DragAbleGridViewDemo extends StatefulWidget{
  @override
  State<StatefulWidget> createState() {
    return new DragAbleGridViewDemoState();
  }
}

class DragAbleGridViewDemoState extends State<DragAbleGridViewDemo>{

  List<ItemBin> itemBins=new List();
  String actionTxtEdit="编辑";
  String actionTxtComplete="完成";
  String actionTxt;
  var editSwitchController=EditSwitchController();
  final List<String> heroes=["鲁班","虞姬","甄姬","黄盖","张飞","关羽","刘备","曹操","赵云","孙策","庄周","廉颇","后裔","妲己","荆轲",];

  @override
  void initState() {
    super.initState();
    actionTxt=actionTxtEdit;
    heroes.forEach((heroName) {
        itemBins.add(new ItemBin(heroName));
      }
    );
  }

  @override
  Widget build(BuildContext context) {
    return new Scaffold(
      appBar: new AppBar(
        title: new Text("可拖拽GridView"),
        actions: <Widget>[
          new Center(
              child: new GestureDetector(
                child: new Container(
                  child: new Text(actionTxt,style: TextStyle(fontSize: 19.0),),
                  margin: EdgeInsets.only(right: 12),
                ),
                onTap: (){
                  changeActionState();
                  editSwitchController.editStateChanged();
                },
              )
          )
        ],
      ),
      body: new DragAbleGridView(
        mainAxisSpacing:10.0,
        crossAxisSpacing:10.0,
        childAspectRatio:1.8,
        crossAxisCount: 4,
        itemBins:itemBins,
        editSwitchController:editSwitchController,
        /******************************new parameter*********************************/
        isOpenDragAble: true,
        animationDuration: 300, //milliseconds
        longPressDuration: 800, //milliseconds
        /******************************new parameter*********************************/
        deleteIcon: new Image.asset("images/close.png",width: 15.0 ,height: 15.0 ),
        child: (int position){
          return new Container(
            padding: EdgeInsets.fromLTRB(8.0, 5.0, 8.0, 5.0),
            decoration: new BoxDecoration(
              borderRadius: BorderRadius.all(new Radius.circular(3.0)),
              border: new Border.all(color: Colors.blue),
            ),
            //因为本布局和删除图标同处于一个Stack内,设置marginTop和marginRight能让图标处于合适的位置
            //Because this layout and the delete_Icon are in the same Stack, setting marginTop and marginRight will make the icon in the proper position.
            margin: EdgeInsets.only(top: 6.0,right: 6.0),
            child: new Text(
              itemBins[position].data,
              style: new TextStyle(fontSize: 16.0,color: Colors.blue),),
          );
        },
        editChangeListener: (){
          changeActionState();
        },
      ),
    );
  }

  void changeActionState(){
    if(actionTxt==actionTxtEdit){
      setState(() {
        actionTxt=actionTxtComplete;
      });
    }else{
      setState(() {
        actionTxt=actionTxtEdit;
      });
    }
  }
}

Properties

properties type defaults description
child typedef @required gridview's child at each position
itemBins List @required the data to be show by gridview's children
crossAxisCount int 4 how many children to be show in a row ; 一行显示几个child
crossAxisSpacing double 1.0 cross axis spacing ; 和滑动方向垂直的那个方向上 child之间的空隙
mainAxisSpacing double 0.0 main axis spacing ; 滑动方向child之间的空隙
childAspectRatio double 0.0 child aspect ratio ; child的纵横比
editSwitchController class null the switch controller that to trigger editing by clicking the button ; 编辑开关控制器,可通过点击按钮触发编辑
editChangeListener typedef null when you long press to trigger the edit state, you can listener this state to change the state of the edit button ; 长按触发编辑状态,可监听状态来改变编辑按钮(编辑开关 ,通过按钮触发编辑)的状态
isOpenDragAble bool false whether to enable the dragable function;是否启用拖动功能
animationDuration int 300 animation duration;动画持续的时长
longPressDuration int 800 long press duration;长按触发拖动的时长
deleteIcon Image null Delete button icon,Do not set this property if you do not use the delete function;删除按钮的图标,如果不使用删除功能,不要设置此属性

LICENSE

MIT License

Copyright (c) 2018

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

所屬分類

原始碼儲存庫

使用此套件的專案

暫無相關資料。