V5.0.0

[davidjbradshaw]

New features

• Added ResizeObserver to all non-static elements to better detect CSS :hover, CSS Animation, <textarea/> user resizing events and remove the need for user interaction event listeners
  • Adopt ResizeObserver API #961
• Added offsetHeight & offsetWidth options to adjust values returned from iframe
  • FR: Add option for manual offset #1030
• Added bodyBoundingClientRect and documentElementBoundingClientRect size calculation methods
• Added lowestDivElement size calculation method
• Added postMessageTarget option to better support GAS iframes
• Log element used to calculate lowest/tagged element
  • Display the element that determines the height (lowestElement) in the log #400
• Add CSS animation to examples

Changes

• Changed default height calculation to documentElementBoundingClientRect
• Renamed values returned by getPageInfo() to match modern DOM names
  • scrollLeft -> scrollX and scrollTop -> scrollY
• Renamed onInit() -> onReady() , and added deprecation warning
• Removed deprecated values returned by getPageInfo()
• Removed added margin calculation from bodyOffset, use bodyOffsetMargin for old behaviour
• Removed undocumented grow height calculation method
• Removed deprecated v3 methods. Calls to v3 methods will now fail, rather than be a warning
• Removed mouse, touch and resize event listeners, as not required alongside ResizeObserver
  • selective listeners #290
• Removed jQuery from examples
• Removed legacy browser support, please use V4 of iframe-reszier if you still require support for older platforms

Fixes

• Updated lowestElement to exclude non-visible elements (head, meta, base, title, script, link, style, map, area, option, optgroup, template, track, wbr, nobr) and then check remaining elements using element.checkVisibility()
  • <option> tag should never be consider as a displayed element #312
  • lowerElement is good but lowerVisibleElement is much better. #508
• Use Math.ceil() to round up sub-pixel heights
  • Fractional parts are missed during the parsing message data #1017
  • Precision problem with fractional height #811
  • Height is a decimal problem #727
• Fix possible memory leak in addImageListeners
  • Memory leak in contentWindow addImageListeners #708
• Deconflict AMD and CommonJS
  • Doesn't work with ESBuild #1008
• Only check min < max if both are defined as numbers
  • Value for minHeight can not be greater than maxHeight #1204

Chore

• Refactored code to more modern JavaScript
• Updated deps

Todo

• Convert trottle() to use RAF instead of setTimeout(16)
• Add EventListener() methods
  • Add addEventListener() and removeEventListener() methods #710
• Fix multiple targetOrigin
  • Multiple targetOrigin #707
• Fix width resizing
  • Width downsizing not working #663
• Investigate scrolling with sticky headers
  • Anchor scroll to incorrect positioning #794
• Page Visibility API
• Migrate build to Rollup
• Migrate unit tests to Jest
• Update Jasmine for e2e tests
• Test Firefox invisible iframe fix still required
• Split into two packages
• Create new website

[github-advanced-security]

This pull request sets up GitHub code scanning for this repository. Once the scans have completed and the checks have passed, the analysis results for this pull request branch will appear on this overview. Once you merge this pull request, the 'Security' tab will show more code scanning analysis results (for example, for the default branch). Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results. For more information about GitHub code scanning, check out the documentation.