@maxgraph/core
Version:
maxGraph is a fully client side JavaScript diagramming library that uses SVG and HTML for rendering.
175 lines (171 loc) • 5.64 kB
JavaScript
"use strict";
/*
Copyright 2021-present The maxGraph project Contributors
Copyright (c) 2006-2015, JGraph Ltd
Copyright (c) 2006-2015, Gaudenz Alder
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const InternalEvent_js_1 = __importDefault(require("../event/InternalEvent.js"));
const EventObject_js_1 = __importDefault(require("../event/EventObject.js"));
/**
* Implements a composite undoable edit. Here is an example for a custom change
* which gets executed via the model:
*
* ```javascript
* function CustomChange(model, name)
* {
* this.model = model;
* this.name = name;
* this.previous = name;
* };
*
* execute = ()=>
* {
* let tmp = this.model.name;
* this.model.name = this.previous;
* this.previous = tmp;
* };
*
* let name = prompt('Enter name');
* graph.model.execute(new CustomChange(graph.model, name));
* ```
*
* Event: mxEvent.EXECUTED
*
* Fires between START_EDIT and END_EDIT after an atomic change was executed.
* The <code>change</code> property contains the change that was executed.
*
* Event: mxEvent.START_EDIT
*
* Fires before a set of changes will be executed in <undo> or <redo>.
* This event contains no properties.
*
* Event: mxEvent.END_EDIT
*
* Fires after a set of changes was executed in <undo> or <redo>.
* This event contains no properties.
*
* Constructor: mxUndoableEdit
*
* Constructs a new undoable edit for the given source.
*/
class UndoableEdit {
constructor(source, significant = true) {
/**
* Array that contains the changes that make up this edit. The changes are
* expected to either have an undo and redo function, or an execute
* function. Default is an empty array.
*/
this.changes = [];
/**
* Specifies if the undoable change is significant.
* Default is true.
*/
this.significant = true;
/**
* Specifies if this edit has been undone. Default is false.
*/
this.undone = false;
/**
* Specifies if this edit has been redone. Default is false.
*/
this.redone = false;
this.source = source;
this.changes = [];
this.significant = significant;
}
/**
* Returns true if the this edit contains no changes.
*/
isEmpty() {
return this.changes.length === 0;
}
/**
* Returns <significant>.
*/
isSignificant() {
return this.significant;
}
/**
* Adds the specified change to this edit. The change is an object that is
* expected to either have an undo and redo, or an execute function.
*/
add(change) {
this.changes.push(change);
}
/**
* Hook to notify any listeners of the changes after an <undo> or <redo>
* has been carried out. This implementation is empty.
*/
notify() {
return;
}
/**
* Hook to free resources after the edit has been removed from the command
* history. This implementation is empty.
*/
die() {
return;
}
/**
* Undoes all changes in this edit.
*/
undo() {
if (!this.undone) {
this.source.fireEvent(new EventObject_js_1.default(InternalEvent_js_1.default.START_EDIT));
const count = this.changes.length;
for (let i = count - 1; i >= 0; i--) {
const change = this.changes[i];
if (change.execute) {
change.execute();
}
else if (change.undo) {
change.undo();
}
// New global executed event
this.source.fireEvent(new EventObject_js_1.default(InternalEvent_js_1.default.EXECUTED, { change }));
}
this.undone = true;
this.redone = false;
this.source.fireEvent(new EventObject_js_1.default(InternalEvent_js_1.default.END_EDIT));
}
this.notify();
}
/**
* Redoes all changes in this edit.
*/
redo() {
if (!this.redone) {
this.source.fireEvent(new EventObject_js_1.default(InternalEvent_js_1.default.START_EDIT));
const count = this.changes.length;
for (let i = 0; i < count; i += 1) {
const change = this.changes[i];
if (change.execute != null) {
change.execute();
}
else if (change.redo != null) {
change.redo();
}
// New global executed event
this.source.fireEvent(new EventObject_js_1.default(InternalEvent_js_1.default.EXECUTED, { change }));
}
this.undone = false;
this.redone = true;
this.source.fireEvent(new EventObject_js_1.default(InternalEvent_js_1.default.END_EDIT));
}
this.notify();
}
}
exports.default = UndoableEdit;