npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

react-flex-dnd

v1.2.1

Published

react drag and drop sorting supports flex layout

Downloads

104

Readme

react-flex-dnd

React drag and drop sort support flex layout and nested.

This package using hooks, note that your React version is above 16.8 :)

Also not support mobile, but it's not time consuming, I am doing this.

demo

Playground, the demo currently is pretty simple, only show one level nested, but it can be infinite nested if you want, I will enrich it after a period of time.

Core characteristics

  • Support any layout except grid
  • High customization
  • Clean and powerful api which is simple to get started with
  • Element styles are not affected
  • Easy nested

If your demand is grid layout, I suggest react-grid-layout.

Currently supported features

  • Vertical lists
  • Horizontal lists
  • Row flex wrap
  • Column flex wrap
  • Auto scrolling
  • Nested droppables and draggables

Simple Example

<DragDropPrivider rootId="app" ghostId="myGhost" onDragEnd={(result) => {
  const {from, to, draggableId} = result;

  // update your data
}}>
  <Droppable id="custom-droppable">
    {droppableProps => <div {...droppableProps}>
      {elements.map(element => {
        const {key, content} = element;

        return <Draggable id={key} belongsTo="custom-droppable">
          {draggableProps => <div {...draggableProps}>{content}</div>}
        </Draggable>
      })}
    <div>}
  </Droppable>
  <Ghost>
    <div class="ghost">
      Dragging item
    </div>
  </Ghost>
</DragDropPrivider>

Usage

DragDropProvider

Must wrap your app with it, it provides controllers for your draggables and droppables.

rootId?: string

In React 17, it is required to identify React app root element.

ghostId?: string

Html id property for ghost element.

onDragEnd

onDragEnd: (params: {
  to: { index: number; droppableId: string };
  from: { index: number; droppableId: string };
  draggableId: string;
}) => void;

Here comes key part, onDragEnd can get sort result after interaction, from shows old place for the dragging item, but for attention, the index in the to is the new index with dragging item removed. Normally when drag end, you remove element first then insert dragging item to the new place.

Draggable

Wrap draggable element with it.

belongsTo: string

Identify your draggable element in which droppable.

threshold?: number

Default 1, it means how close when you drag an element to another element edge to sort. Especially when nested, your droppable wrapped with draggable, if you what drag an element into a draggable droppable, threshold must below 1.

<Draggable id="custom-draggable" threshold={0.3}>
  {draggableProps => <Droppable {...draggbleProps} id="custom-droppable" draggableId="custom-draggable">
    {droppableProps => <div {...droppableProps}>
      {elements.map(element => {
        const {key, content} = element;

        return <Draggable id={key} belongsTo={`custom-draggable-${key}`}>
          {draggableProps => <div {...draggableProps}>{content}</div>}
        </Draggable>
      })}
    <div>}
  </Droppable>}
</Draggable>

disabledEdges?: string[]

Draggable elements have 4 edges: top, left, bottom and right, this props is to disable some edges.

Droppable

Wrap a element that draggable can be dragged in.

direction?: "vertical" | "horizontal"

Default horizontal, hotizontal meas flex-direction: row.

draggableId?: string

When a element can be dragged in and dragged, it means this element is a draggable Droppable.

Ghost

When drag a item, ghost indicates what you are dragging.

ghost

DragDropContext

You can use useContext to convinently to get draggingId and droppableId instead of passing props from the top.