mediawiki-extensions-Cite/modules/ve-cite/ve.dm.MWReferenceModel.js

263 lines
7.4 KiB
JavaScript
Raw Normal View History

'use strict';
/*!
* VisualEditor DataModel MWReferenceModel class.
*
* @copyright 2011-2018 VisualEditor Team's Cite sub-team and others; see AUTHORS.txt
* @license MIT
*/
/**
* Corresponds to one ref and its metadata, chosen for an action.
*
* TODO: Distinguish this module from ve.dm.MWReferenceNode
*
* @constructor
* @mixes OO.EventEmitter
* @param {ve.dm.Document} [parentDoc] The parent Document we can use to auto-generate a blank
* Document for the reference in case {@see setDocument} was never called
* @property {ve.dm.Document|Function|undefined} doc Might be deferred via a function, to be
* lazy-evaluated when {@see getDocument} is called
*/
ve.dm.MWReferenceModel = function VeDmMWReferenceModel( parentDoc ) {
// Mixin constructors
OO.EventEmitter.call( this );
// Properties
this.extendsRef = null;
this.listKey = '';
this.listGroup = '';
this.listIndex = null;
this.group = '';
if ( parentDoc ) {
this.doc = () => parentDoc.cloneWithData( [
{ type: 'paragraph', internal: { generated: 'wrapper' } },
{ type: '/paragraph' },
{ type: 'internalList' },
{ type: '/internalList' }
] );
}
};
/* Inheritance */
OO.mixinClass( ve.dm.MWReferenceModel, OO.EventEmitter );
/* Static Methods */
/**
* Create a reference model from a reference internal item.
*
* @param {ve.dm.MWReferenceNode} node Reference node
* @return {ve.dm.MWReferenceModel} Reference model
*/
ve.dm.MWReferenceModel.static.newFromReferenceNode = function ( node ) {
const doc = node.getDocument();
const internalList = doc.getInternalList();
const attributes = node.getAttributes();
const ref = new ve.dm.MWReferenceModel();
ref.extendsRef = attributes.extendsRef;
ref.listKey = attributes.listKey;
ref.listGroup = attributes.listGroup;
ref.listIndex = attributes.listIndex;
ref.group = attributes.refGroup;
ref.doc = function () {
// cloneFromRange is very expensive, so lazy evaluate it
return doc.cloneFromRange( internalList.getItemNode( attributes.listIndex ).getRange() );
};
return ref;
};
/* Methods */
/**
* Find matching item in a surface.
*
* @param {ve.dm.Surface} surfaceModel Surface reference is in
* @return {ve.dm.InternalItemNode|null} Internal reference item, null if none exists
*/
ve.dm.MWReferenceModel.prototype.findInternalItem = function ( surfaceModel ) {
if ( this.listIndex !== null ) {
return surfaceModel.getDocument().getInternalList().getItemNode( this.listIndex );
}
return null;
};
/**
* Insert reference internal item into a surface.
*
* If the internal item for this reference doesn't exist, use this method to create one.
* The inserted reference is empty and auto-numbered.
*
* @param {ve.dm.Surface} surfaceModel Surface model of main document
*/
ve.dm.MWReferenceModel.prototype.insertInternalItem = function ( surfaceModel ) {
// Create new internal item
const doc = surfaceModel.getDocument();
const internalList = doc.getInternalList();
// Fill in data
this.listKey = 'auto/' + internalList.getNextUniqueNumber();
this.listGroup = 'mwReference/' + this.group;
// Insert internal reference item into document
const item = internalList.getItemInsertion( this.listGroup, this.listKey, [] );
surfaceModel.change( item.transaction );
this.listIndex = item.index;
// Inject reference document into internal reference item
surfaceModel.change(
ve.dm.TransactionBuilder.static.newFromDocumentInsertion(
doc,
internalList.getItemNode( item.index ).getRange().start,
this.getDocument()
)
);
};
/**
* Update an internal reference item.
*
* An internal item for the reference will be created if no `ref` argument is given.
*
* @param {ve.dm.Surface} surfaceModel Surface model of main document
*/
ve.dm.MWReferenceModel.prototype.updateInternalItem = function ( surfaceModel ) {
const doc = surfaceModel.getDocument();
const internalList = doc.getInternalList();
const listGroup = 'mwReference/' + this.group;
// Group/key has changed
if ( this.listGroup !== listGroup ) {
// Get all reference nodes with the same group and key
const group = internalList.getNodeGroup( this.listGroup );
const refNodes = group.keyedNodes[ this.listKey ] ?
group.keyedNodes[ this.listKey ].slice() :
[ group.firstNodes[ this.listIndex ] ];
// Check for name collision when moving items between groups
const keyIndex = internalList.getKeyIndex( this.listGroup, this.listKey );
if ( keyIndex !== undefined ) {
// Resolve name collision by generating a new list key
this.listKey = 'auto/' + internalList.getNextUniqueNumber();
}
// Update the group name of all references nodes with the same group and key
const txs = [];
for ( let i = 0, len = refNodes.length; i < len; i++ ) {
txs.push( ve.dm.TransactionBuilder.static.newFromAttributeChanges(
doc,
refNodes[ i ].getOuterRange().start,
{ refGroup: this.group, listGroup: listGroup }
) );
}
surfaceModel.change( txs );
this.listGroup = listGroup;
}
// Update internal node content
const itemNodeRange = internalList.getItemNode( this.listIndex ).getRange();
surfaceModel.change(
ve.dm.TransactionBuilder.static
.newFromRemoval( doc, itemNodeRange, true ) );
surfaceModel.change(
ve.dm.TransactionBuilder.static
.newFromDocumentInsertion( doc, itemNodeRange.start, this.getDocument() ) );
};
/**
* Insert reference at the end of a surface fragment.
*
* @param {ve.dm.SurfaceFragment} surfaceFragment Surface fragment to insert at
* @param {boolean} [placeholder] Reference is a placeholder for staging purposes
*/
ve.dm.MWReferenceModel.prototype.insertReferenceNode = function ( surfaceFragment, placeholder ) {
const attributes = {
extendsRef: this.extendsRef,
listKey: this.listKey,
listGroup: this.listGroup,
listIndex: this.listIndex,
refGroup: this.group
};
if ( placeholder ) {
attributes.placeholder = true;
}
surfaceFragment
.insertContent( [
{
type: 'mwReference',
attributes: attributes,
// See ve.dm.MWReferenceNode.static.cloneElement
originalDomElementsHash: Math.random()
},
{ type: '/mwReference' }
] );
};
/**
* Get the key of a reference in the references list.
*
* @return {string} Reference's list key
*/
ve.dm.MWReferenceModel.prototype.getListKey = function () {
return this.listKey;
};
/**
* Get the name of the group a references list is in.
*
* @return {string} References list's group
*/
ve.dm.MWReferenceModel.prototype.getListGroup = function () {
return this.listGroup;
};
/**
* Get the index of reference in the references list.
*
* @return {string} Reference's index
*/
ve.dm.MWReferenceModel.prototype.getListIndex = function () {
return this.listIndex;
};
/**
* Get the name of the group a reference is in.
*
* @return {string} Reference's group
*/
ve.dm.MWReferenceModel.prototype.getGroup = function () {
return this.group;
};
/**
* Get reference document.
*
* Auto-generates a blank document if no document exists.
*
* @return {ve.dm.Document} The (small) document with the content of the reference
*/
ve.dm.MWReferenceModel.prototype.getDocument = function () {
if ( typeof this.doc === 'function' ) {
this.doc = this.doc();
}
return this.doc;
};
/**
* Set the name of the group a reference is in.
*
* @param {string} group Reference's group
*/
ve.dm.MWReferenceModel.prototype.setGroup = function ( group ) {
this.group = group;
};
/**
* Set the reference document.
*
* @param {ve.dm.Document} doc The (small) document with the content of the reference
*/
ve.dm.MWReferenceModel.prototype.setDocument = function ( doc ) {
this.doc = doc;
};