Scroll.js.flow 2.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. /**
  2. * Copyright (c) 2013-present, Facebook, Inc.
  3. *
  4. * This source code is licensed under the MIT license found in the
  5. * LICENSE file in the root directory of this source tree.
  6. *
  7. * @providesModule Scroll
  8. */
  9. /**
  10. * @param {DOMElement} element
  11. * @param {DOMDocument} doc
  12. * @return {boolean}
  13. */
  14. function _isViewportScrollElement(element, doc) {
  15. return !!doc && (element === doc.documentElement || element === doc.body);
  16. }
  17. /**
  18. * Scroll Module. This class contains 4 simple static functions
  19. * to be used to access Element.scrollTop/scrollLeft properties.
  20. * To solve the inconsistencies between browsers when either
  21. * document.body or document.documentElement is supplied,
  22. * below logic will be used to alleviate the issue:
  23. *
  24. * 1. If 'element' is either 'document.body' or 'document.documentElement,
  25. * get whichever element's 'scroll{Top,Left}' is larger.
  26. * 2. If 'element' is either 'document.body' or 'document.documentElement',
  27. * set the 'scroll{Top,Left}' on both elements.
  28. */
  29. const Scroll = {
  30. /**
  31. * @param {DOMElement} element
  32. * @return {number}
  33. */
  34. getTop: function (element) {
  35. const doc = element.ownerDocument;
  36. return _isViewportScrollElement(element, doc) ? // In practice, they will either both have the same value,
  37. // or one will be zero and the other will be the scroll position
  38. // of the viewport. So we can use `X || Y` instead of `Math.max(X, Y)`
  39. doc.body.scrollTop || doc.documentElement.scrollTop : element.scrollTop;
  40. },
  41. /**
  42. * @param {DOMElement} element
  43. * @param {number} newTop
  44. */
  45. setTop: function (element, newTop) {
  46. const doc = element.ownerDocument;
  47. if (_isViewportScrollElement(element, doc)) {
  48. doc.body.scrollTop = doc.documentElement.scrollTop = newTop;
  49. } else {
  50. element.scrollTop = newTop;
  51. }
  52. },
  53. /**
  54. * @param {DOMElement} element
  55. * @return {number}
  56. */
  57. getLeft: function (element) {
  58. const doc = element.ownerDocument;
  59. return _isViewportScrollElement(element, doc) ? doc.body.scrollLeft || doc.documentElement.scrollLeft : element.scrollLeft;
  60. },
  61. /**
  62. * @param {DOMElement} element
  63. * @param {number} newLeft
  64. */
  65. setLeft: function (element, newLeft) {
  66. const doc = element.ownerDocument;
  67. if (_isViewportScrollElement(element, doc)) {
  68. doc.body.scrollLeft = doc.documentElement.scrollLeft = newLeft;
  69. } else {
  70. element.scrollLeft = newLeft;
  71. }
  72. }
  73. };
  74. module.exports = Scroll;