mirror of
https://github.com/discourse/discourse.git
synced 2025-02-25 18:55:32 -06:00
98 lines
2.7 KiB
JavaScript
98 lines
2.7 KiB
JavaScript
/**
|
|
Track visible elemnts on the screen.
|
|
|
|
You can register for triggers on:
|
|
|
|
`focusChanged` the top element we're focusing on
|
|
|
|
`seenElement` if we've seen the element
|
|
|
|
@class Eyeline
|
|
@namespace Discourse
|
|
@module Discourse
|
|
@uses RSVP.EventTarget
|
|
**/
|
|
Discourse.Eyeline = function Eyeline(selector) {
|
|
this.selector = selector;
|
|
}
|
|
|
|
/**
|
|
Call this whenever you want to consider what is being seen by the browser
|
|
|
|
@method update
|
|
**/
|
|
Discourse.Eyeline.prototype.update = function() {
|
|
var $elements, $results, atBottom, bottomOffset, docViewBottom, docViewTop, documentHeight, foundElement, windowHeight,
|
|
_this = this;
|
|
|
|
docViewTop = $(window).scrollTop();
|
|
windowHeight = $(window).height();
|
|
docViewBottom = docViewTop + windowHeight;
|
|
documentHeight = $(document).height();
|
|
$elements = $(this.selector);
|
|
atBottom = false;
|
|
|
|
if (bottomOffset = $elements.last().offset()) {
|
|
atBottom = (bottomOffset.top <= docViewBottom) && (bottomOffset.top >= docViewTop);
|
|
}
|
|
|
|
// Whether we've seen any elements in this search
|
|
foundElement = false;
|
|
$results = $(this.selector);
|
|
return $results.each(function(i, elem) {
|
|
var $elem, elemBottom, elemTop, markSeen;
|
|
$elem = $(elem);
|
|
elemTop = $elem.offset().top;
|
|
elemBottom = elemTop + $elem.height();
|
|
markSeen = false;
|
|
// It's seen if...
|
|
|
|
// ...the element is vertically within the top and botom
|
|
if ((elemTop <= docViewBottom) && (elemTop >= docViewTop)) markSeen = true;
|
|
|
|
// ...the element top is above the top and the bottom is below the bottom (large elements)
|
|
if ((elemTop <= docViewTop) && (elemBottom >= docViewBottom)) markSeen = true;
|
|
|
|
// ...we're at the bottom and the bottom of the element is visible (large bottom elements)
|
|
if (atBottom && (elemBottom >= docViewTop)) markSeen = true;
|
|
|
|
if (!markSeen) return true;
|
|
|
|
// If you hit the bottom we mark all the elements as seen. Otherwise, just the first one
|
|
if (!atBottom) {
|
|
_this.trigger('saw', {
|
|
detail: $elem
|
|
});
|
|
if (i === 0) {
|
|
_this.trigger('sawTop', { detail: $elem });
|
|
}
|
|
return false;
|
|
}
|
|
if (i === 0) {
|
|
_this.trigger('sawTop', { detail: $elem });
|
|
}
|
|
if (i === ($results.length - 1)) {
|
|
return _this.trigger('sawBottom', { detail: $elem });
|
|
}
|
|
});
|
|
};
|
|
|
|
|
|
/**
|
|
Call this when we know aren't loading any more elements. Mark the rest as seen
|
|
|
|
@method flushRest
|
|
**/
|
|
Discourse.Eyeline.prototype.flushRest = function() {
|
|
var _this = this;
|
|
return $(this.selector).each(function(i, elem) {
|
|
var $elem;
|
|
$elem = $(elem);
|
|
return _this.trigger('saw', { detail: $elem });
|
|
});
|
|
};
|
|
|
|
RSVP.EventTarget.mixin(Discourse.Eyeline.prototype);
|
|
|
|
|