ENH MutliLinkField sorting

client/lang/en.js

@@ -21,6 +21,8 @@ if (typeof(ss) === 'undefined' || typeof(ss.i18n) === 'undefined') {
     "LinkField.CANNOT_CREATE_LINK": "Cannot create link",
     "LinkField.FAILED_TO_LOAD_LINKS": "Failed to load links",
     "LinkField.FAILED_TO_SAVE_LINK": "Failed to save link",
-    "LinkField.SAVE_RECORD_FIRST": "Cannot add links until the record has been saved"
+    "LinkField.SAVE_RECORD_FIRST": "Cannot add links until the record has been saved",
+    "LinkField.SORT_SUCCESS": "Updated link sort order",
+    "LinkField.SORT_ERROR": "Unable to sort links"
   });
 }

client/lang/src/en.json

@@ -14,5 +14,7 @@
     "LinkField.CANNOT_CREATE_LINK": "Cannot create link",
     "LinkField.FAILED_TO_LOAD_LINKS": "Failed to load links",
     "LinkField.FAILED_TO_SAVE_LINK": "Failed to save link",
-    "LinkField.SAVE_RECORD_FIRST": "Cannot add links until the record has been saved"
+    "LinkField.SAVE_RECORD_FIRST": "Cannot add links until the record has been saved",
+    "LinkField.SORT_SUCCESS": "Updated link sort order",
+    "LinkField.SORT_ERROR": "Unable to sort links"
 }

client/src/components/LinkField/LinkField.js

@@ -2,6 +2,9 @@
 import React, { useState, useEffect, createContext } from 'react';
 import { bindActionCreators, compose } from 'redux';
 import { connect } from 'react-redux';
+import { DndContext, closestCenter, PointerSensor, useSensor, useSensors } from '@dnd-kit/core';
+import { arrayMove, SortableContext, verticalListSortingStrategy } from '@dnd-kit/sortable';
+import { restrictToVerticalAxis, restrictToParentElement } from '@dnd-kit/modifiers';
 import { injectGraphql } from 'lib/Injector';
 import fieldHolder from 'components/FieldHolder/FieldHolder';
 import LinkPicker from 'components/LinkPicker/LinkPicker';
@@ -16,6 +19,7 @@ import PropTypes from 'prop-types';
 import i18n from 'i18n';
 import url from 'url';
 import qs from 'qs';
+import classnames from 'classnames';
 
 export const LinkFieldContext = createContext(null);
 
@@ -47,6 +51,16 @@ const LinkField = ({
   const [data, setData] = useState({});
   const [editingID, setEditingID] = useState(0);
   const [loading, setLoading] = useState(false);
+  const [forceFetch, setForceFetch] = useState(0);
+  const [linksClassName, setLinksClassName] = useState(classnames({'link-picker-links': true}));
+
+  const sensors = useSensors(
+    useSensor(PointerSensor, {
+      activationConstraint: {
+        distance: 10
+      }
+    })
+  );
 
   // Ensure we have a valid array
   let linkIDs = value;
@@ -61,6 +75,7 @@ const LinkField = ({
 
   // Read data from endpoint and update component state
   // This happens any time a link is added or removed and triggers a re-render
+
   useEffect(() => {
     if (!editingID && linkIDs.length > 0) {
       setLoading(true);
@@ -80,7 +95,7 @@ const LinkField = ({
           setLoading(false);
         });
     }
-  }, [editingID, value && value.length]);
+  }, [editingID, value && value.length, forceFetch]);
 
   /**
    * Unset the editing ID when the editing modal is closed
@@ -167,15 +182,53 @@ const LinkField = ({
         onDelete={onDelete}
         onClick={() => { setEditingID(linkID); }}
         canDelete={data[linkID]?.canDelete ? true : false}
+        isMulti={isMulti}
       />);
     }
     return links;
   };
 
+  const handleDragStart = (event) => {
+    setLinksClassName(classnames({
+      'link-picker__links': true,
+      'link-picker__links--dragging': true,
+    }));
+  }
+
+  /**
+   * Drag and drop handler for MultiLinkField's
+   */
+  const handleDragEnd = (event) => {
+    const {active, over} = event;
+    setLinksClassName(classnames({
+      'link-picker__links': true,
+      'link-picker__links--dragging': false,
+    }));
+    if (active.id === over.id) {
+      return;
+    }
+    const fromIndex = linkIDs.indexOf(active.id);
+    const toIndex = linkIDs.indexOf(over.id);
+    const newLinkIDs = arrayMove(linkIDs, fromIndex, toIndex);
+    let endpoint = `${Config.getSection(section).form.linkForm.sortUrl}`;
+    // CSRF token 'X-SecurityID' headers needs to be present
+    backend.post(endpoint, { newLinkIDs }, { 'X-SecurityID': Config.get('SecurityID') })
+      .then(() => {
+        onChange(newLinkIDs);
+        actions.toasts.success(i18n._t('LinkField.SORT_SUCCESS', 'Updated link sort order'));
+        // Force a rerender so that links are retched so that versionState badges are up to date
+        setForceFetch(forceFetch + 1);
+      })
+      .catch(() => {
+        actions.toasts.error(i18n._t('LinkField.SORT_ERROR', 'Failed to sort links'));
+      });
+  }
+
   const saveRecordFirst = ownerID === 0;
   const renderPicker = !saveRecordFirst && (isMulti || Object.keys(data).length === 0);
   const renderModal = !saveRecordFirst && Boolean(editingID);
   const saveRecordFirstText = i18n._t('LinkField.SAVE_RECORD_FIRST', 'Cannot add links until the record has been saved');
+  const links = renderLinks();
 
   if (loading && !saveRecordFirst) {
     return <div className="link-field__loading"><Loading/></div>;
@@ -189,7 +242,22 @@ const LinkField = ({
         types={types}
         canCreate={canCreate}
       /> }
-        <div> { renderLinks() } </div>
+    { isMulti && <div className={linksClassName}>
+      <DndContext modifiers={[restrictToVerticalAxis, restrictToParentElement]}
+        sensors={sensors}
+        collisionDetection={closestCenter}
+        onDragStart={handleDragStart}
+        onDragEnd={handleDragEnd}
+      >
+        <SortableContext 
+          items={linkIDs}
+          strategy={verticalListSortingStrategy}
+        >
+          {links}
+        </SortableContext>
+      </DndContext>
+    </div> }
+    { !isMulti && <div>{ renderLinks() }</div>}
     { renderModal && <LinkModalContainer
         types={types}
         typeKey={data[editingID]?.typeKey}

client/src/components/LinkPicker/LinkPicker.scss

@@ -66,7 +66,6 @@
   }
 
   &:hover, &:focus {
-    background: $gray-100;
     text-decoration: none;
     color: inherit;
   }
@@ -121,6 +120,28 @@
   }
 }
 
+.link-picker__drag-handle {
+  display: none;
+  left: 5px;
+  position: absolute;
+  z-index: 100;
+
+  &:hover {
+    cursor: grab;
+  }
+}
+
+.link-picker__link:hover {
+  .link-picker__drag-handle {
+    display: block;
+  }
+}
+
+// This selector ensures the cursor does not flicker between grabbing and pointer when sorting
+.link-picker__links--dragging * {
+  cursor: grabbing !important;
+}
+
 .link-picker__link-detail {
   flex-grow: 1;
   width: 100%;

client/src/components/LinkPicker/LinkPickerTitle.js

@@ -3,7 +3,9 @@ import classnames from 'classnames';
 import i18n from 'i18n';
 import React from 'react';
 import PropTypes from 'prop-types';
-import {Button} from 'reactstrap';
+import { Button } from 'reactstrap';
+import { useSortable } from '@dnd-kit/sortable';
+import { CSS } from '@dnd-kit/utilities';
 
 const stopPropagation = (fn) => (e) => {
   e.nativeEvent.stopImmediatePropagation();
@@ -37,30 +39,48 @@ const LinkPickerTitle = ({
   typeTitle,
   onDelete,
   onClick,
-  canDelete
+  canDelete,
+  isMulti,
 }) => {
+  const {
+    attributes,
+    listeners,
+    setNodeRef,
+    transform,
+    transition,
+  } = useSortable({id});
+  const style = {
+    transform: CSS.Transform.toString(transform),
+    transition,
+  };
   const classes = {
     'link-picker__link': true,
     'form-control': true,
   };
   if (versionState) {
-    classes[` link-picker__link--${versionState}`] = true;
+    classes[`link-picker__link--${versionState}`] = true;
   }
   const className = classnames(classes);
   const deleteText = ['unversioned', 'unsaved'].includes(versionState)
     ? i18n._t('LinkField.DELETE', 'Delete')
     : i18n._t('LinkField.ARCHIVE', 'Archive');
-  return <div className={className}>
-    <Button className="link-picker__button font-icon-link"  color="secondary" onClick={stopPropagation(onClick)}>
+  return <div
+    className={className}
+    ref={setNodeRef}
+    style={style} {...attributes}
+    {...listeners}
+  >
+    { isMulti && <div className="link-picker__drag-handle"><i className="font-icon-drag-handle"></i></div> }
+    <Button className="link-picker__button font-icon-link" color="secondary" onClick={stopPropagation(onClick)}>
       <div className="link-picker__link-detail">
-      <div className="link-picker__title">
-        <span className="link-picker__title-text">{title}</span>
-        {getVersionedBadge(versionState)}
-      </div>
-      <small className="link-picker__type">
-        {typeTitle}:&nbsp;
-        <span className="link-picker__url">{description}</span>
-      </small>
+        <div className="link-picker__title">
+          <span className="link-picker__title-text">{title}</span>
+          {getVersionedBadge(versionState)}
+        </div>
+        <small className="link-picker__type">
+          {typeTitle}:&nbsp;
+          <span className="link-picker__url">{description}</span>
+        </small>
       </div>
     </Button>
     {canDelete &&
@@ -78,6 +98,7 @@ LinkPickerTitle.propTypes = {
   onDelete: PropTypes.func.isRequired,
   onClick: PropTypes.func.isRequired,
   canDelete: PropTypes.bool.isRequired,
+  isMulti: PropTypes.bool.isRequired,
 };
 
 export default LinkPickerTitle;

client/src/components/LinkPicker/tests/LinkPickerTitle-test.js

@@ -13,6 +13,7 @@ function makeProps(obj = {}) {
     typeTitle: 'Phone',
     onDelete: () => {},
     onClick: () => {},
+    isMulti: false,
     ...obj
   };
 }

package.json

@@ -1,16 +1,16 @@
 {
-  "name": "silverstripe-link",
+  "name": "silverstripe-linkfield",
   "version": "0.0.0",
   "description": "Link management for the SilverStripe CMS",
   "main": "./client/src/boot/index.js",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/silverstripe/silverstripe-link.git"
+    "url": "git+https://github.com/silverstripe/silverstripe-linkfield.git"
   },
-  "homepage": "https://github.com/silverstripe/silverstripNe-link",
+  "homepage": "https://github.com/silverstripe/silverstripNe-linkfield",
   "bugs": {
-    "url": "https://github.com/silverstripe/silverstripe-link/issues"
+    "url": "https://github.com/silverstripe/silverstripe-linkfield/issues"
   },
   "author": "SilverStripe Ltd",
   "engines": {
@@ -61,14 +61,15 @@
   },
   "dependencies": {
     "@apollo/client": "^3.7.1",
+    "@dnd-kit/core": "^6.1.0",
+    "@dnd-kit/modifiers": "^7.0.0",
+    "@dnd-kit/sortable": "^8.0.0",
     "bootstrap": "^4.6.2",
     "classnames": "^2.2.5",
     "core-js": "^3.26.0",
     "prop-types": "^15.8.1",
     "qs": "^6.11.0",
     "react": "^18.2.0",
-    "react-dnd": "^5.0.0",
-    "react-dnd-html5-backend": "^5.0.1",
     "react-dom": "^18.2.0",
     "react-redux": "^8.0.4",
     "react-router": "^6.4.2",