mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor
synced 2024-11-30 00:55:00 +00:00
d2dfb9ac4f
* Move and rename generic parts of ve.ui to OO.ui * We now have a UI test suite because ve.Element (outside ve.ui) is now part of oojs-ui, so it needs a test suite. * Added to the MW test run (just like we do for unicodejs). * Updated csslint config (also added ve-mw and syntaxhighlight which were missing). oojs-ui still depends on the TriggerRegistry in VE, this is addressed in a follow-up commit. Change-Id: Iec147155c1ddf20b73a4d15d87b8742207032312
120 lines
2.5 KiB
JavaScript
120 lines
2.5 KiB
JavaScript
/*!
|
|
* ObjectOriented UserInterface GroupElement class.
|
|
*
|
|
* @copyright 2011-2013 OOJS Team and others; see AUTHORS.txt
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
*/
|
|
|
|
/**
|
|
* Element containing a sequence of child elements.
|
|
*
|
|
* @class
|
|
* @abstract
|
|
*
|
|
* @constructor
|
|
* @param {jQuery} $group Container node, assigned to #$group
|
|
*/
|
|
OO.ui.GroupElement = function OoUiGroupElement( $group ) {
|
|
// Properties
|
|
this.$group = $group;
|
|
this.items = [];
|
|
this.$items = this.$$( [] );
|
|
};
|
|
|
|
/* Methods */
|
|
|
|
/**
|
|
* Get items.
|
|
*
|
|
* @method
|
|
* @returns {OO.ui.Element[]} Items
|
|
*/
|
|
OO.ui.GroupElement.prototype.getItems = function () {
|
|
return this.items.slice( 0 );
|
|
};
|
|
|
|
/**
|
|
* Add items.
|
|
*
|
|
* @method
|
|
* @param {OO.ui.Element[]} items Item
|
|
* @param {number} [index] Index to insert items after
|
|
* @chainable
|
|
*/
|
|
OO.ui.GroupElement.prototype.addItems = function ( items, index ) {
|
|
var i, len, item, currentIndex,
|
|
$items = $( [] );
|
|
|
|
for ( i = 0, len = items.length; i < len; i++ ) {
|
|
item = items[i];
|
|
|
|
// Check if item exists then remove it first, effectively "moving" it
|
|
currentIndex = this.items.indexOf( item );
|
|
if ( currentIndex >= 0 ) {
|
|
this.removeItems( [ item ] );
|
|
// Adjust index to compensate for removal
|
|
if ( currentIndex < index ) {
|
|
index--;
|
|
}
|
|
}
|
|
// Add the item
|
|
$items = $items.add( item.$ );
|
|
}
|
|
|
|
if ( index === undefined || index < 0 || index >= this.items.length ) {
|
|
this.$group.append( $items );
|
|
this.items.push.apply( this.items, items );
|
|
} else if ( index === 0 ) {
|
|
this.$group.prepend( $items );
|
|
this.items.unshift.apply( this.items, items );
|
|
} else {
|
|
this.$items.eq( index ).before( $items );
|
|
this.items.splice.apply( this.items, [ index, 0 ].concat( items ) );
|
|
}
|
|
|
|
this.$items = this.$items.add( $items );
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Remove items.
|
|
*
|
|
* Items will be detached, not removed, so they can be used later.
|
|
*
|
|
* @method
|
|
* @param {OO.ui.Element[]} items Items to remove
|
|
* @chainable
|
|
*/
|
|
OO.ui.GroupElement.prototype.removeItems = function ( items ) {
|
|
var i, len, item, index;
|
|
// Remove specific items
|
|
for ( i = 0, len = items.length; i < len; i++ ) {
|
|
item = items[i];
|
|
index = this.items.indexOf( item );
|
|
if ( index !== -1 ) {
|
|
this.items.splice( index, 1 );
|
|
item.$.detach();
|
|
this.$items = this.$items.not( item.$ );
|
|
}
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Clear all items.
|
|
*
|
|
* Items will be detached, not removed, so they can be used later.
|
|
*
|
|
* @method
|
|
* @chainable
|
|
*/
|
|
OO.ui.GroupElement.prototype.clearItems = function () {
|
|
this.items = [];
|
|
this.$items.detach();
|
|
this.$items = $( [] );
|
|
|
|
return this;
|
|
};
|