mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Cite
synced 2024-11-24 06:54:00 +00:00
d03d2d8d20
Pure refactor which shouldn't change output in production. Switches to interfacing with MWDocumentReferences to get refs in index order. Temporarily suppresses any subrefs, we only show top-level refs. Bug: T247921 Change-Id: I9c8347b064173027f436722c87e15e0381c958bd
69 lines
2 KiB
JavaScript
69 lines
2 KiB
JavaScript
'use strict';
|
|
|
|
/*!
|
|
* @copyright 2024 VisualEditor Team's Cite sub-team and others; see AUTHORS.txt
|
|
* @license MIT
|
|
*/
|
|
|
|
/**
|
|
* A facade providing a simplified and safe interface to Cite `ref` and
|
|
* `references` tags in a document.
|
|
*
|
|
* @constructor
|
|
* @mixes OO.EventEmitter
|
|
* @param {ve.dm.Document} doc The document that reference tags will be embedded in.
|
|
*/
|
|
ve.dm.MWDocumentReferences = function VeDmMWDocumentReferences( doc ) {
|
|
// Mixin constructors
|
|
OO.EventEmitter.call( this );
|
|
|
|
// Properties
|
|
this.doc = doc;
|
|
};
|
|
|
|
/* Inheritance */
|
|
|
|
OO.mixinClass( ve.dm.MWDocumentReferences, OO.EventEmitter );
|
|
|
|
/* Methods */
|
|
|
|
/**
|
|
* Singleton MWDocumentReferences for a document.
|
|
*
|
|
* @param {ve.dm.Document} doc Source document associated with the singleton
|
|
* @return {ve.dm.MWDocumentReferences} Singleton docRefs
|
|
*/
|
|
ve.dm.MWDocumentReferences.static.refsForDoc = function ( doc ) {
|
|
let docRefs = doc.getStorage( 'document-references-store' );
|
|
if ( docRefs === undefined ) {
|
|
docRefs = new ve.dm.MWDocumentReferences( doc );
|
|
doc.setStorage( 'document-references-store', docRefs );
|
|
}
|
|
return docRefs;
|
|
};
|
|
|
|
/**
|
|
* Get all refs for a group, organized by parent ref
|
|
*
|
|
* This is appropriate when rendering a reflist organized hierarchically by
|
|
* subrefs using the `extends` feature.
|
|
*
|
|
* @param {string} groupName Filter by this group.
|
|
* @return {Object.<string, ve.dm.MWReferenceNode[]>} Mapping from parent ref
|
|
* name to a list of its subrefs. Note that the top-level refs are under the
|
|
* `null` value.
|
|
*/
|
|
ve.dm.MWDocumentReferences.prototype.getGroupRefsByParents = function ( groupName ) {
|
|
const nodeGroup = this.doc.getInternalList().getNodeGroup( groupName );
|
|
return ( nodeGroup ? nodeGroup.indexOrder : [] )
|
|
.reduce( ( acc, index ) => {
|
|
const node = nodeGroup.firstNodes[ index ];
|
|
const extendsRef = node.element.attributes.extendsRef || '';
|
|
if ( acc[ extendsRef ] === undefined ) {
|
|
acc[ extendsRef ] = [];
|
|
}
|
|
acc[ extendsRef ].push( node );
|
|
return acc;
|
|
}, {} );
|
|
};
|