mediawiki-extensions-RevisionSlider/modules/ext.RevisionSlider.PointerLine.js

/**
 * Module containing presentation logic for the revision pointer lines
 *
 * @class PointerLine
 * @param {Pointer} pointer
 * @param {string} name
 * @constructor
 */
function PointerLine( pointer, name ) {
	this.pointer = pointer;
	this.name = name;
}

$.extend( PointerLine.prototype, {
	/**
	 * @type {string}
	 */
	name: '',

	/**
	 * @type {Pointer}
	 */
	pointer: null,

	/**
	 * @type {jQuery}
	 */
	$html: null,

	/**
	 * Check if the offset method is available for the diff element
	 *
	 * @return {boolean}
	 */
	offsetNotAvailable: function () {
		return typeof $( '.diff-ntitle' ).offset() === 'undefined';
	},

	/**
	 * Calculate the relative distance in between the given pointer and column
	 *
	 * @param {jQuery} $sourcePointer
	 * @param {jQuery} $targetColumn
	 * @return {number} distance between the given elements
	 */
	calculateDistance: function ( $sourcePointer, $targetColumn ) {
		return ( $targetColumn.offset().left + $targetColumn.width() / 2 ) -
			( $sourcePointer.offset().left + ( $sourcePointer.width() ) / 2 );
	},

	/**
	 * Calculate and set line's width and position with the given pointer and column
	 *
	 * @param {jQuery} $sourcePointer
	 * @param {jQuery} $targetColumn
	 */
	setCssProperties: function ( $sourcePointer, $targetColumn ) {
		const distance = this.calculateDistance( $sourcePointer, $targetColumn );

		const widthToSet = Math.abs( distance );
		let leftToSet = ( $targetColumn.offset().left + $targetColumn.width() / 2 ) -
			$( '.mw-revslider-revision-slider' ).offset().left;

		if ( distance > 0 ) {
			// targetColumn is right relative to sourcePointer
			leftToSet -= widthToSet;
			leftToSet -= 1;
		} else {
			// targetColumn is left relative to sourcePointer
			leftToSet += 1;
		}

		this.$html.css( {
			width: widthToSet + 'px',
			left: leftToSet + 'px'
		} );
	},

	/**
	 * Check if the target column is located right form the source pointer
	 *
	 * @param {jQuery} $sourcePointer
	 * @param {jQuery} $targetColumn
	 *
	 * @return {boolean}
	 */
	targetColumnIsRightFromPointer: function ( $sourcePointer, $targetColumn ) {
		return this.calculateDistance( $sourcePointer, $targetColumn ) > 0;
	},

	/**
	 * Draws the line between pointer and column by setting borders, position and width of the line box
	 */
	drawLine: function () {
		if ( this.offsetNotAvailable() ) {
			// offset is not available in QUnit tests so skip calculation and drawing
			return;
		}

		const $upperLineDiv = this.$html.find( '.mw-revslider-pointer-line-upper' ),
			$lowerLineDiv = this.$html.find( '.mw-revslider-pointer-line-lower' ),
			$underline = this.$html.find( '.mw-revslider-pointer-line-underline' ),
			$sourcePointer = this.pointer.getView().getElement(),
			$table = $( '.diff-otitle' );

		const isNewer = this.pointer.getView().isNewerPointer();
		$lowerLineDiv.add( $upperLineDiv ).add( $underline )
			.toggleClass( 'mw-revslider-lower-color', !isNewer )
			.toggleClass( 'mw-revslider-upper-color', isNewer );
		const $targetColumn = isNewer ? $( '.diff-ntitle' ) : $table;

		this.setCssProperties( $sourcePointer, $targetColumn );

		$upperLineDiv.addClass( 'mw-revslider-bottom-line' );
		$underline.css( 'width', $table.width() + 'px' );

		if ( this.targetColumnIsRightFromPointer( $sourcePointer, $targetColumn ) ) {
			$upperLineDiv.addClass( 'mw-revslider-left-line' );
			$lowerLineDiv.addClass( 'mw-revslider-right-line' );

			$underline.css( {
				'margin-right': -$table.width() / 2 + 'px',
				'margin-left': 0,
				float: 'right'
			} );
		} else {
			$upperLineDiv.addClass( 'mw-revslider-right-line' );
			$lowerLineDiv.addClass( 'mw-revslider-left-line' );

			$underline.css( {
				'margin-left': -$table.width() / 2 + 'px',
				'margin-right': 0,
				float: 'left'
			} );
		}
	},

	/**
	 * Initializes the DOM element with the line-box for drawing the lines
	 */
	initialize: function () {
		// eslint-disable-next-line mediawiki/class-doc
		this.$html = $( '<div>' )
			.addClass( 'mw-revslider-pointer-line ' + this.name )
			.append(
				// eslint-disable-next-line mediawiki/class-doc
				$( '<div>' ).addClass( 'mw-revslider-pointer-line-upper ' + this.name ),
				// eslint-disable-next-line mediawiki/class-doc
				$( '<div>' ).addClass( 'mw-revslider-pointer-line-lower ' + this.name ),
				// eslint-disable-next-line mediawiki/class-doc
				$( '<div>' ).addClass( 'mw-revslider-pointer-line-underline ' + this.name )
			);
	},

	/**
	 * Adds colored top-borders for the diff columns fitting the line colors between pointers and columns
	 */
	addColoredColumnBorders: function () {
		$( '#mw-diff-otitle1' ).addClass( 'mw-revslider-older-diff-column' );
		$( '#mw-diff-ntitle1' ).addClass( 'mw-revslider-newer-diff-column' );
	},

	/**
	 * Remove colored top-borders for the diff columns fitting the line colors between pointers and columns
	 */
	removeColoredColumnBorders: function () {
		$( '#mw-diff-otitle1' ).removeClass( 'mw-revslider-older-diff-column' );
		$( '#mw-diff-ntitle1' ).removeClass( 'mw-revslider-newer-diff-column' );
	},

	/**
	 * Sets the hooks to draw the column borders
	 */
	setColumnBorderHooks: function () {
		mw.hook( 'wikipage.diff' ).add( this.addColoredColumnBorders );
		mw.hook( 'revslider.expand' ).add( this.addColoredColumnBorders );
		mw.hook( 'revslider.collapse' ).add( this.removeColoredColumnBorders );
	},

	/**
	 * @return {jQuery}
	 */
	render: function () {
		this.initialize();
		this.setColumnBorderHooks();
		return this.getElement();
	},

	/**
	 * @return {jQuery}
	 */
	getElement: function () {
		return this.$html;
	}

} );

module.exports = PointerLine;