概览

团队为何搜索这个库

当你需要可配合数组、响应式表单、Signals 和复杂界面构建器的拖放排序时，请选择这个 Angular 可排序库。

安装

npm install ng-hub-ui-sortable

跳转到

适用于

任务排序
FormArray 编辑器
布局构建器
优先级管理

关于 sortable

ng-hub-ui-sortable 帮助 Angular 团队在顺序至关重要的产品中自然地重排数据：任务、优先级、布局构建器或动态表单块。当你需要拖放又不想失去对状态更新的控制时，它尤其有用。

功能指南

核心用法

sortable 列表的基本使用场景。

示例:

简单数组

重新排序普通数组。

Angular Drag and Drop with Simple Arrays

View code

Learn how to implement drag and drop functionality with simple arrays in Angular using SortableJS. The examples below show several Bootstrap elements that can be made sortable.

They share the same data model, so any drag/drop interaction updates all the blocks in real-time. In practice, any HTML element can be made sortable with Angular.

Sortable Button Groups Example

Cards

Ankara

Ankara description

Moscow

Moscow description

Munich

Munich description

Paris

Paris description

Washington

Washington description

Navigation

The actual model

> [ "Ankara", "Moscow", "Munich", "Paris", "Washington" ]

Signals

将 sortable 数据绑定到 Angular 的可写 signals。

Angular Signals Drag and Drop - Reactive Sortable Lists

View code

Implement reactive drag and drop with Angular Signals (Angular 18+). This example uses an Angular writable signal as the sortable model, demonstrating automatic reactivity. Drag to reorder and watch the signal-backed array update instantly.

Angularv18
Reactv19
Vuev3
Sveltev5

Current signal value:

[
  "Angular",
  "React",
  "Vue",
  "Svelte"
]

表单集成

将 sortable 与 Angular 响应式表单结合使用。

示例:

FormArray 集成

通过拖放重新排序 FormArray 控件。

Angular FormArray Drag and Drop with Reactive Forms

View code

Integrate drag and drop functionality with Angular Reactive Forms. Complex forms with FormArray controls are fully supported with automatic synchronization.

Try editing the text values and reordering the form inputs by dragging them.

The actual value of the array

	 [
  "Ankara",
  "Moscow",
  "Munich",
  "Paris",
  "Washington"
]

高级配置

自定义 SortableJS 的行为和交互。

示例:

自定义选项

配置 handles、过滤器、动画和事件。

Advanced SortableJS Configuration Options for Angular

View code

Explore advanced customization options for Angular drag and drop. This example shows how to configure animation speed, handles, filters, and other SortableJS options to create the perfect user experience.

Disabled Sortable Elements Example

Element 1
Element 2
Element 3
Element 4
Element 5

and the actual model is

[
  "1",
  "2",
  "3",
  "4",
  "5"
]

Events

Binding to the events is easy. Any even could be attached as a property of Sortablejs. The example below binds to the onUpdate event. Drag the items and track the amount of updates.

Updated 0 times

Element 1
Element 2
Element 3
Element 4
Element 5

Hint: for the FormArray using onUpdate is kinda overhead because the FormArray.valueChanges provides an event on every change.

Autoscroll with fixed navbar

Normally the scrolling that is performed by Sortablejs is working fine. However with a fixed navbar it may cause problems.

Setting the scrollSensitivity to the proper value will solve the problem. Try it on the long list below

Element 1
Element 2
Element 3
Element 4
Element 5
Element 6
Element 7
Element 8
Element 9
Element 10
Element 11
Element 12
Element 13
Element 14
Element 15
Element 16
Element 17
Element 18
Element 19
Element 20
Element 21
Element 22
Element 23
Element 24
Element 25
Element 26
Element 27
Element 28
Element 29
Element 30

多个列表

连接列表、克隆项目并控制转移规则。

Angular Drag and Drop Between Multiple Connected Lists

View code

Learn how to implement drag and drop between multiple lists in Angular. This example demonstrates how sortable lists can be connected to each other, allowing seamless item transfer across different containers.

Note the sortable CSS class (provides min-height) so the lists never collapse when empty, maintaining a consistent drag-and-drop experience.

Transfer Items Between Lists Example

These lists are connected using the group option. You can drag and drop elements across different lists, making it perfect for kanban boards, task managers, and categorization interfaces.

Element 1
Element 2
Element 3
Element 4
Element 5

Element 6
Element 7
Element 8
Element 9
Element 10

and the actual state is

 [
  "1",
  "2",
  "3",
  "4",
  "5"
]

 [
  "6",
  "7",
  "8",
  "9",
  "10"
]

Clone items

The list 1 is a clone factory and list 2 can be its target.

Element 1
Element 2
Element 3
Element 4
Element 5

Element 6
Element 7
Element 8
Element 9
Element 10

and the actual state is

 [
  "1",
  "2",
  "3",
  "4",
  "5"
]

 [
  "6",
  "7",
  "8",
  "9",
  "10"
]

Super complicated example

These lists are connected together. You can drag / drop elements across the lists. Pay attention to the sortable CSS class (gives a min-height) that does not allow list to become invisible when all items are gone

1. This list cannot accept items

Element 1
Element 2
Element 3
Element 4
Element 5

2. This is a normal list

Element 6
Element 7
Element 8
Element 9
Element 10

3. This list clones its children

Element 11
Element 12

4. Only #1 can put here

Element 13

and the actual state is

 [
  "1",
  "2",
  "3",
  "4",
  "5"
]

 [
  "6",
  "7",
  "8",
  "9",
  "10"
]

 [
  "11",
  "12"
]

 [
  "13"
]

布局构建器

带有 tabs 和 widgets 的嵌套 sortable 容器。

Angular Layout Builder with Nested Drag and Drop Lists

View code

Build advanced visual layout builders with nested drag and drop in Angular. This powerful example demonstrates nested sortable lists with drag handles and component slots, perfect for creating page builders and dashboard designers.

Create hierarchical structures with drag-and-drop functionality—ideal for layout builders, dashboard organizers, and visual editors. Supports multi-level nesting with full control over handles and constraints.

Demo: Generic, Tabs & Widgets

Generic A

Widget 1

Widget 2

Tabs Container

Tab 1

Tab 2

Generic B

Widget 3

Generic C

Generic D

Widget 4

Generic E

Move log

No events yet.

手动模式

使用 `autoUpdateArray=false` 禁用自动更新，并通过 `moveItemInArray`、`transferArrayItem` 和 `copyArrayItem` 辅助函数自行应用更改。

Manual Array Control Mode

View code

Manual Control Mode

This example demonstrates manual array control by setting [autoUpdateArray]="false". This gives you complete control over when and how arrays are updated, similar to Angular CDK's approach.

Benefits: Perform validation, make API calls, implement undo/redo, or use immutable patterns before updating your data.

Single List - Manual Reordering

Drag and drop tasks to reorder them. Notice how we manually update the array using the moveItemInArray helper function.

Task List

Design UI mockups
Implement authentication
Write unit tests
Deploy to production

Current State:

[
  {
    "id": 1,
    "title": "Design UI mockups",
    "completed": false
  },
  {
    "id": 2,
    "title": "Implement authentication",
    "completed": false
  },
  {
    "id": 3,
    "title": "Write unit tests",
    "completed": false
  },
  {
    "id": 4,
    "title": "Deploy to production",
    "completed": false
  }
]

Multiple Lists - Kanban Board Style

Drag tasks between different status columns. The transferArrayItem helper makes it easy to move items between arrays while maintaining full control.

To Do 3

Review pull requests
Priority: high
Update documentation
Priority: medium
Refactor legacy code
Priority: low

In Progress 2

Fix bug #123
Priority: high
Add new feature
Priority: medium

Done 1

Initial setup
Priority: high

Operations Log

No operations yet. Start dragging items to see the log!

Code Example

Component Handler

import { moveItemInArray, transferArrayItem } from 'ng-hub-ui-sortable';

onTasksUpdate(event: SortableEvent): void {
  // Manually update the array with full control
  moveItemInArray(this.tasks, event.oldIndex, event.newIndex);
  
  // You can add validation, API calls, etc. here
  console.log('Task reordered!');
}

onListAdd(event: SortableEvent, targetList: any[], listName: string): void {
  const sourceList = this.getListByElement(event.from);
  
  // Transfer item between arrays
  transferArrayItem(sourceList, targetList, event.oldIndex, event.newIndex);
  
  // Perfect place for API calls to persist the change
  this.apiService.updateTaskStatus(item.id, listName);
}

Why Use Manual Control?

Validation

Validate changes before updating your data model. Prevent invalid operations or apply business rules.

API Integration

Make API calls to persist changes immediately. Handle success/error responses appropriately.

Undo/Redo

Implement undo/redo functionality by maintaining operation history before committing changes.

Immutability

Use immutable data patterns with OnPush change detection for optimal performance.

概览

团队为何搜索这个库

安装

跳转到

适用于

关于 sortable

功能指南

核心用法

示例:

简单数组

Angular Drag and Drop with Simple Arrays

Sortable Button Groups Example

Cards

Navigation

The actual model

Signals

Angular Signals Drag and Drop - Reactive Sortable Lists

表单集成

示例:

FormArray 集成

Angular FormArray Drag and Drop with Reactive Forms

高级配置

示例:

自定义选项

Advanced SortableJS Configuration Options for Angular

Disabled Sortable Elements Example

Events

Autoscroll with fixed navbar

多个列表

Angular Drag and Drop Between Multiple Connected Lists

Transfer Items Between Lists Example

Clone items

Super complicated example

布局构建器

Angular Layout Builder with Nested Drag and Drop Lists

Demo: Generic, Tabs & Widgets

手动模式

Manual Array Control Mode

Manual Control Mode

Single List - Manual Reordering

Current State:

Multiple Lists - Kanban Board Style

Operations Log

Code Example

Why Use Manual Control?

Validation

API Integration

Undo/Redo

Immutability

核心特性

数组与列表排序

配合 FormArray

互联的拖放流程

最近更改

Version 21.2.0 - 2/10/26, 12:00 AM

Version 21.0.1 - 12/10/25, 12:00 AM

相关库

Version 21.2.0 - 2/10/26, 12:00 AM

Version 21.0.1 - 12/10/25, 12:00 AM