angular-sortablejs

This package is an Angular 2+ binding for Sortable.js. Supports standard arrays and Angular FormArray.

Demo

See the library in action in a demo project (based on the Angular CLI). The source code for all the examples could be found here.

Installation

Angular >= 4.x (angular-sortablejs@2.x.x; sortablejs must be installed separately)

``sh
npm install --save sortablejs && npm install --save angular-sortablejs
`

Angular 2.x (angular-sortablejs@1.x.x; sortablejs is included)

`sh
npm install --save angular-sortablejs@1.3.1
`

You are configured now. If you use Webpack or Angular CLI go to the usage. If you have SystemJS, that's sad, but you can go to the end of the document to find configuration steps there.

Usage

First, import SortablejsModule.forRoot({ / and here some global settings if needed / }) into the root module of your application:

`typescript
imports: [
// ...
SortablejsModule.forRoot({ animation: 150 }),
// ...
]
`

Then import SortablejsModule into the other angular modules where you want to use it:

`typescript
imports: [
// ...
SortablejsModule,
// ...
]
`

Then use sortablejs property on a container HTML element to tell Angular that this is a sortable container; also pass the items array to both *ngFor and [sortablejs] to register the changes automatically.

Simple sortable list

`typescript
import { Component } from '@angular/core';

@Component({
selector: 'my-app',
template:

Drag / drop the item


})
export class AppComponent {
items = [1, 2, 3, 4, 5];
}
`

$3

Pass the options with sortablejsOptions property.

`typescript
import { Component } from '@angular/core';

@Component({
selector: 'my-app',
template:

Drag / drop the item


})
export class AppComponent {
items = [1, 2, 3, 4, 5];
}
`

$3

You can use the options' onUpdate method to track the changes (see also Passing the options section):

`ts
constructor() {
this.options = {
onUpdate: (event: any) => {
this.postChangesToServer();
}
};
}
`

If you use FormArray you are able to choose a more elegant solution:

`ts
public items = new FormArray([
new FormControl(1),
new FormControl(2),
new FormControl(3),
]);

constructor() {
this.items.valueChanges.subscribe(() => {
this.postChangesToServer(this.items.value);
});
}
`

but note, that here you will be able to take the whole changed array only (no oldIndex / newIndex).

$3

You can pass a new options object at anytime via the [sortablejsOptions] binding and the Angular's change detection will check for the changes from the previous options and will call the low level option setter from Sortable.js to set the new option values.
> Note: It will only detect changes when a brand new options object is passed, not deep changes.

$3

The only thing which should be done is assigning the group option to the both list. Everything else is handled automatically.

`typescript
import { Component } from '@angular/core';
import { SortablejsOptions } from 'angular-sortablejs';

@Component({
selector: 'my-app',
template:

Drag / drop the item

list 1

list 2

})
export class AppComponent {
items1 = [1, 2, 3, 4, 5];
items2 = ['a', 'b', 'c', 'd', 'e'];

options: SortablejsOptions = {
group: 'test'
};
}
`

$3

The clone mode is similar to the one above (of course the proper Sortablejs settings should be used; see demo). The only important thing is that the angular-sortablejs does clone the HTML element but does not clone the variable (or FormControl in case of FormArray input). By default the variable will be taken as is: a primitive will be copied, an object will be referenced.

If you want to clone the item being sorted in a different manner, you can provide sortablejsCloneFunction as a parameter. This function receives an item and should return a clone of that item.

`typescript
import { Component } from '@angular/core';
import { SortablejsOptions } from 'angular-sortablejs';

@Component({
selector: 'my-app',
template:

Drag / drop the item

list 1

list 2

})
export class AppComponent {

myCloneImplementation(item) {
return item; // this is what happens if sortablejsCloneFunction is not provided. Add your stuff here
}

}
`

$3

By default, the boolean parameter runInsideAngular is set to false.
This means that the initial binding of all mouse events of the component will be set so that they will not trigger Angular's change detection.

If this parameter is set to true, then for large components - with a lot of data bindings - the UI will function in a staggered and lagging way (mainly when dragging items), while every event will trigger the change detection (which might be needed in some special edge cases).

$3

If you want to use the same sortable options across different places of your application you might want to set up global configuration. Add the following to your main module to enable e.g. animation: 150 everywhere:

`typescript
imports: [
// ...
// any properties and events available on original library work here as well
SortablejsModule.forRoot({
animation: 150
}),
// ...
]
`

This value will be used as a default one, but it can be overwritten by a local sortablejsOptions property.

How it works

The model is automatically updated because you pass the items as