### Version History *4.2.10 (2019/04/17)* * Fixed don't swallow first 2% of the video in time slider (https://github.com/mediaelement/mediaelement/pull/2582) @jomo @coveralls * Fixed Chrome to play vimeo videos (https://github.com/mediaelement/mediaelement/pull/2622) @mmusket @coveralls @homerjam * Fixed Update volume.js (https://github.com/mediaelement/mediaelement/pull/2530) - Implementing a slight change to improve accessibility and compliance with WCAG 2.0 success criteria 4.1.1 and 4.1.2 @vavroom @coveralls * Fixed the forceLive always adding "Live Broadcast" memory leak (https://github.com/mediaelement/mediaelement/pull/2589) @joshdvir @coveralls @Qoraiche * Update resources.md (https://github.com/mediaelement/mediaelement/pull/2565) - Add video snapshot plugin resource @Qoraiche @coveralls * Fixed typo (https://github.com/mediaelement/mediaelement/pull/2540) @Qoraiche @coveralls *4.2.9 (2018/03/27)* * Fixed typo in documentation (https://github.com/mediaelement/mediaelement/pull/2512) @moagggi * Added remainingTime getter (https://github.com/mediaelement/mediaelement/pull/2505) @Lewiscowles1986 * Fixed iframe parameters formatting for Vimeo/Facebook (https://github.com/mediaelement/mediaelement/pull/2498) @skreutzer * Added Malay translation (https://github.com/mediaelement/mediaelement/pull/2490) @MuhdNurHidayat * Fixed `getComputedStyle` in Firefox (https://github.com/mediaelement/mediaelement/pull/2487) @pgrzeszczak-neducatio * Fixed documentation for React usage @rafa8626 * Added LICENSE file @rafa8626 * Added conditionals to avoid executing `fullscreen` methods in audio tags @rafa8626 * Added conditionals to avoid triggering keyboard events if `enableKeyboard` is false @rafa8626 * Added missing conditionals when destroying media @rafa8626 * Modified Malay language in the demo @rafa8626 * Set empty source when destroying player to prevent #2499 @rafa8626 * Added conditional to avoid setting duration when `media` has been destroyed @rafa8626 * Replaced callback when seeking in paused media to achieve correct behavior @rafa8626 * Updated documentation about using `startLanguage` and `toggleCaptionsButtonWhenOnlyOne` (https://github.com/mediaelement/mediaelement/pull/2520) @dmdewey *4.2.8 (2018/01/16)* * Clarify effect of setting `toggleCaptionsButtonWhenOnlyOne` (https://github.com/mediaelement/mediaelement/pull/2471) @cjcolvar * Remember `startVolume` value even if video is muted (https://github.com/mediaelement/mediaelement/pull/2470) @D3nnisH * Fix @see links for hls.js renderer (https://github.com/mediaelement/mediaelement/pull/2478) @cjcolvar * UID filter for Flash files @johndyer *4.2.7 (2017/11/17)* * Fixed issue with `setFillMode` when using cross-domain URLs in iframe @rafa8626 * Added new `proxyType` and `streamDelimiter` variables to Flash video to support RTMPS compatibility @rafa8626 * Fixed issues with renderers when trying to use `muted` property while using `MediaElement` shim @rafa8626 * Fixed typo with `Twitch` renderer related to trigger mouse events @rafa8626 * Fixed typo when assigning options to `Dailymotion` renderer @rafa8626 * Added missing workflow to set controls on YouTube, Facebook and Dailymotion renderers via `controls` property @rafa8626 * Added missing `playing` event on `Vimeo` and `Dailymotion` renderer @rafa8626 * Expanded regexp to accept 3-letter country codes and underscore for 4-letter country codes @rafa8626 * Added `init`, `getElement` and `buildfeatures` methods for WP compatibility @rafa8626 * Make `setPoster` method to work on mobile devices with native controls (https://github.com/mediaelement/mediaelement/pull/2419) @lucash * Added missing conditional in native HLS and HTML5 renderer to test media files correctly to trigger error after testing all of them @rafa8626 * Added jsDelivr badge (https://github.com/mediaelement/mediaelement/pull/2421) @LukasDrgon * Fixed issue with `visible` method when `getClientRects` is not a function @rafa8626 * Fixed issues with `parseInt` method not setting radix in some calls @rafa8626 * Added missing argument in `secondsToTimeCode` method to check the time format given and display accordingly @rafa8626 * Fixed issues related to duplicated calls when triggering error and fixed style for poster when error is displayed @rafa8626 * Fixed issue with captions not being rendered inside video frame on any state @rafa8626 * Integrated `destroy` method in `MediaElement` class @rafa8626 * Added validation to modify `SoundCloud` iframe attributes when using `video` tag @rafa8626 * Fixed issue when checking for native dimensions of `video` element to set responsive dimensions correctly @rafa8626 * Added missing workflow to make `loop` work correctly in YouTube according to documentation @rafa8626 * Changed paths for `hls.js` and `flv.js` renderers to always be up-to-date @rafa8626 * Fixed issue with timecode displaying 60 seconds @rafa8626 * Fixed JSDocs for some features @rafa8626 *4.2.6 (2017/09/19)* * Fixed positioning of progress bar tooltip @rafa8626 * Added style to avoid flickering when using volume on Chrome @rafa8626 * Fixed broken UUT @rafa8626 * Added `configs` parameter for native FLV according to documentation for flv.js (https://github.com/mediaelement/mediaelement/pull/2344) @xiaosongxiaosong * Added missing call to avoid further calls to attempt set the player's dimensions once removed @rafa8626 * Fixed typo when checking error event and fixed workflow to loop multiple sources until valid one is found for `html5` and `native_hls` renderers @rafa8626 * Fixed workflow to enable/disable controls once error occurs and once user recovers from error @rafa8626 * Fixed issue when no `height` attribute but style is set to create proper player dimensions @rafa8626 * Use local variable for `getComputedStyle` polyfill to avoid recursion on Firefox (https://github.com/mediaelement/mediaelement/pull/2351) @synthecypher * Fixed accessibility issues when using keyboard on focused progress bar and moved `keyActions` to their individual components @rafa8626 * Fixed issues with progress bar tooltip when media duration is too long @rafa8626 * Added new `mejs` variables needed for WordPress @rafa8626 * Fixed issues with events fired in incorrect time for `flash_video` renderer @milax * Set specific settings for embedding flash object in Edge browser (https://github.com/mediaelement/mediaelement/pull/2364) @milax * Added new constant to detect `passive events` and added conditional for `touchstart` events @rafa8626 * Removed width and height from `embed` object to ensure Flash audio will play on Chrome (https://github.com/mediaelement/mediaelement/pull/2367) @milax * Fixed issue with Caption/Chapters menus not selecting options properly when using mouse @rafa8626 and @Instagit * Removed black area when Flash player is used in audio player (https://github.com/mediaelement/mediaelement/pull/2370) @milax * Fixed issue with `poster` option not being set if `poster` attribute is absent @rafa8626 * Moved code inside `player.js` to corresponding features to restore original order or operations when creating layers @rafa8626 * Added `unmute` command for Facebook renderer @rafa8626 * Fixed events emitting and run handlers of active renderer only for Flash and HTML5 renderer (https://github.com/mediaelement/mediaelement/pull/2368) @milax * Fixed issues when setting sources for Flash HLS renderer and added missing events @rafa8626 * Upgraded `hls.js` to 0.8.2 version and `flv.js` to 1.3.3 version @rafa8626 * Refactor `Facebook` renderer to solve issues when instantiating multiple videos and added new `lang` parameter to load language on SDK @rafa8626 * Fixed typos in `Twitch` renderer that caused channels not to play properly @rafa8626 * Fixed typos in `Flash` renderer to avoid issues with `embed` dimensions @rafa8626 * Reintegrated old workflow to deal only with `dash.js` play errors @rafa8626 * Updated documentation @rafa8626 * Added documentation about MEJS installation through Bower (https://github.com/mediaelement/mediaelement/pull/2399) @thompsonemerson *4.2.5 (2017/08/09)* * Removed workflow that ignored MIME type to get a better media match @rafa8626 * Fixed typos related to HLS MIME type and library version @rafa8626 *4.2.4 (2017/08/08)* * Added missing conditional to set current time properly for live streams (especially YouTube ones) @rafa8626 * Fixed issues with Flash fallback for FLV and RTMP in regards of setting current time and other events @rafa8626 * Fixed typos when setting poster for iOS and when destroying player @rafa8626 * Fixed typo when setting default player caused issues on Firefox when extending `MediaElementPlayer` object @rafa8626 * Fixed issue related to iframe renderers not resizing properly after using fullscreen @rafa8626 * Updated RTMP and Dailymotion sources @rafa8626 * Added `useDefaultControls` configuration to simplify list of `features` (https://github.com/mediaelement/mediaelement-plugins/issues/74) @rafa8626 * Removed `build/mediaelement.js` in `package.js` to avoid duplication issues in Meteor and added missing languages @rafa8626 * Removed unnecessary event un-bindings that caused errors on Edge @rafa8626 * Added missing layer to display errors correctly on native renderers and added missing styles for errors; `customError` accepts a callback as well @rafa8626 * Added missing translations; removed Brazilian Portuguese and added Catalan in demo file @rafa8626 * Added `forceLive` configuration to hide progress bar and display `Live Broadcast` even when `duration` is a valid number @rafa8626 * Fixed issues with Flash HLS renderer related to restarting video once ended @rafa8626 * Added missing translations @rafa8626 * Fixed issue with native M(PEG)-DASH assigned to MediaElement shim related to `The play() request was interrupted` error @rafa8626 * Created workflow to remove/restore `poster` when using FB and iPhone and updated SDK version @rafa8626 *4.2.3 (2017/07/22)* * Fixed issue with setting default player causing some sources to autoplay @rafa8626 * Added new `useFakeFullscreen` configuration element to bypass conditional when entering fullscreen and added CSS to hide native controls @rafa8626 * Fixed issue with sequence of files when creating bundle @rafa8626 * Updated FLV and HLS libraries @rafa8626 * Cleaned stylesheet and fixed minor issues on demo file @rafa8626 * Fixed issues when using `setPoster` method after player was initialized @rafa8626 * Fixed issues with `setSrc` method duplicating events on the native renderers @rafa8626 * Removed code to load media when playing considered unnecessary @rafa8626 * Added mechanism in `YouTube` renderer to add YouTube's thumbnail as a poster using `youtube`'s `imageQuality` parameter @rafa8626 * Fixed typo on `setFill` mode and fixed issue with poster when using iOS @rafa8626 * Fixed issue with `M(PEG)-DASH` renderer related to `dash.js` not picking settings from the renderer @rafa8626 * Added missing dependency to `player/library.js` file (https://github.com/mediaelement/mediaelement/pull/2318) @JulianKniephoff * Added missing code to explain how to use `MediaElement` with `RequireJS` @rafa8626 * Integrated Flashls events to be processed by the player @rafa8626 * Fixed test file when using JSDom and Mocha Chai @rafa8626 * Changed arguments in `M(PEG)-DASH` native renderer to trigger correctly events @rafa8626 *4.2.1/4.2.2 (2017/06/28)* * Added conditional to avoid AJAX request on non-SSL media on iOS @rafa8626 * Fixed error with .versions file @rafa8626 *4.2.0 (2017/06/26)* * Fixed issues related to Promises with native renderers @rafa8626 * Fixed typos in player to execute properly `destroy()` and `stop()` methods @rafa8626 * Fixed issues with error message not being displayed properly in different scenarios @rafa8626 * Fixed issue with controls not being hidden using keyboard @rafa8626 * Fixed issue using fullscreen button and iframes @rafa8626 * Updated documentation on ReactJS about how to destroy a player and fixed typo on WordPress section @rafa8626 * Added missing documentation about how to install `MediaElement` in Drupal @rafa8626 * Fixed typo in `Vimeo` renderer @rafa8626 * Updated version of `Facebook` API @rafa8626 * Replacing `buffer` querySelector with getter function in player (https://github.com/mediaelement/mediaelement/pull/2284) @ychen022 * Fixed issues with keyboard not picking events correctly on Chrome @rafa8626 * Improved error system to catch more errors and present them to user @rafa8626 * Removed `mediaelementplayer` bundles, as well as `jQuery` file, considered unnecessary @rafa8626 * Added new middleware layer to allow interaction with other players @rafa8626 * Used flex-box to reduce calculation via Javascript on control bar (https://github.com/mediaelement/mediaelement/pull/2261) @marcobiedermann and @rafa8626 * Fixed issue with events not being unbound when player is destroyed and removed unnecessary callbacks from it @rafa8626 * Added missing style for buffering element @rafa8626 * Removed conditional to disable control bar when an error happens @rafa8626 * Updated references to (Adobe / Apache) Flex SDK in documentation (https://github.com/mediaelement/mediaelement/pull/2287) @isantolin * Updated CDN references for both native FLV and HLS renderers @rafa8626 * Fixed issue with tooltip position when rail is 100% and gets cut off @rafa8626 * Fixed `The play() request was interrupted` errors by changing way to check for Promises and methods @rafa8626 * Added missing workflow to hide controls when playing media and mouse is out of player container @rafa8626 * Added conditionals to check if `src` track is not empty to avoid render empty track sources @rafa8626 *4.1.3 (2017/06/06)* * Updated Chinese translations (https://github.com/mediaelement/mediaelement/pull/2239) @PeterDaveHello * Changed `destroy()` to `remove()` in React documentation (https://github.com/mediaelement/mediaelement/pull/2243) @evykassirer * Added full support for `autoplay`, `loop` and `muted` attributes to interact in all renderers @rafa8626 * Improved core functionality by adding Promises to ensure proper behavior of plugin's operation, such as `play()`, `setSrc()`, etc. @rafa8626 * Fixed typo for DailyMotion renderer @rafa8626 * Integrated new `robustnessLevel` parameter for DRM on M(PEG)-DASH renderer @rafa8626 * Replaced `childNodes` with `children` to avoid issues with non Node elements inside video/audio tag @rafa8626 * Cleaned `Gruntfile` to remove unnecessary task and align CSS to current browser compatibility @rafa8626 * Fixed `disableControls()` method (https://github.com/mediaelement/mediaelement/pull/2254) @jhutchins * Updated documentation to state support for SoundCloud with native HTML5 renderer @rafa8626 * Updated documentation to expose `instance` argument when using `MediaElementPlayer` or jQuery's `mediaelementplayer` success callback @rafa8626 * Added missing events for `FLV` native renderer @rafa8626 * Fixed to documentation (https://github.com/mediaelement/mediaelement/pull/2259) @marcobiedermann * Optimized SVG sprite (https://github.com/mediaelement/mediaelement/pull/2260) @marcobiedermann * Upgraded regex to match YouTube videos properly @rafa8626 * Fixed regex to check if source is valid YouTube source @rafa8626 * Upgraded `flv.js` to 1.3.0 (https://github.com/mediaelement/mediaelement/pull/2262) @isantolin * Updated `hls.js` to a CDN with SSL support (https://github.com/mediaelement/mediaelement/pull/2263) @isantolin * Sorted CSS properties to reduce filesize when using gzip (https://github.com/mediaelement/mediaelement/pull/2264) @marcobiedermann * Integrated [Stylelint](https://stylelint.io/) for CSS quality @rafa8626 * Improvements to CSS stylesheets via `Stylelint` (https://github.com/mediaelement/mediaelement/pull/2266) and (https://github.com/mediaelement/mediaelement/pull/2269) @marcobiedermann * Fixed workflow to generate proper vendor prefixes (https://github.com/mediaelement/mediaelement/pull/2265) @marcobiedermann * CSS cleanup (https://github.com/mediaelement/mediaelement/pull/2267) @marcobiedermann * Fixed issue related to tooltip changing size when hovering on progress bar and `alwaysShowHours` set to `true` @rafa8626 *4.1.2 (2017/05/25)* * Fixed issues with Accessibility in Chapters/Captions and Volume slider @rafa8626 * Added new resources to documentation @rafa8626 * Fixed MD broken link (https://github.com/mediaelement/mediaelement/pull/2223) @Mackiovello * Changed calculation to avoid higher dimensions than expected using `parseFloat` on `responsive` mode @rafa8626 * Updated `installation.md` file for WordPress upgrades, and fixed README file @rafa8626 * Fixed `hasFluidMode()` method to return proper result (https://github.com/mediaelement/mediaelement/pull/2224) @lucash * Fixed issue with logical operators and `~` symbol @rafa8626 * Integrated `loadScript()` method to optimize way to load external libraries (https://github.com/mediaelement/mediaelement/pull/2226) @jimmywarting * Removed unnecessary whitespaces, upgraded packages and removed comments on bundles @rafa8626 * Fixed issue with `startVolume` not being picked by non-native renderers @rafa8626 * Added `getDuration()` and used methods vs property access to allow `MediaElementPlayer` to be extended (https://github.com/mediaelement/mediaelement/pull/2228) @jhutchins * Added player min-width based on elements visible on control bar @rafa8626 * Added missing events to set `startVolume` properly when loading new data @rafa8626 * Fixed issue related to controlbar not reflecting loading progress @rafa8626 * Fixed issues with native FLV renderer related to load new sources and having multiple players rendering FLV media @rafa8626 * Enabled DRM support for M(PEG)-DASH via `setSrc()` and `dash.drm` configuration @rafa8626 * Added support to pass a single object in `setSrc()` @rafa8626 * Added Persian translation (https://github.com/mediaelement/mediaelement/pull/2238) @wmateam *4.1.1 (2017/05/16)* * Added missing conditional to reuse `exitFullscreen` method @rafa8626 * Added new code snippet to use player with `AudioContext.decodeAudioData()` @rafa8626 * Added missing conditional for bug with hidden iframes in Firefox @rafa8626 * Fixed typo in `Vimeo` renderer @rafa8626 * Added workflow to solve issue with iOS and HTTPS playing media @rafa8626 * Changed `match` to `test` and `includes` to `indexOf` to improve performance @rafa8626 * Fixed `responsive` mode within iframe (https://github.com/mediaelement/mediaelement/pull/2207) @lucash * Updated German translation (https://github.com/mediaelement/mediaelement/pull/2210) @SoftCreatR * Enforced https protocol on external libraries (https://github.com/mediaelement/mediaelement/pull/2212) @jimmywarting * Fixed issue when using YouTube in audio tag triggering double buffering/play events when starting media @rafa8626 * Fixed `fill` mode within iframe @rafa8626 * Fixed player accessibility using Tab key and avoid hidding controls on audio element @rafa8626 * Fix usage for iOS with native controls (https://github.com/mediaelement/mediaelement/pull/2215) @lucash *4.1.0 (2017/05/04)* * Added `grunt watch` and tasks depending on files modified @rafa8626 * Fixed typo for documentation about `features` configuration element (https://github.com/mediaelement/mediaelement/pull/2189) @abumalick * Fixed issue related to time tooltip appearing on all player instances when hovering over one player's progress bar @rafa8626 * Improved workflow to store all `source` attributes for `mediaFiles` list @rafa8626 * Added improvements and hover behavior to player slider (https://github.com/mediaelement/mediaelement/pull/2191) @ricking06 and @rafa8626 * Added `babel-preset-env` to optimize bundles based on supported browsers @rafa8626 * Fixed typos in `Vimeo` and `Twitch` renderers @rafa8626 *4.0.7 (2017/04/25)* * Fixed issues when using `MediaElement` inside an iframe (cross and non cross-domain) @rafa8626 * Fixed way to detect fullscreen mode properly for all renderers and fixed fullscreen for iOS @rafa8626 * Fixed workflow when using `data-mejsoptions` attribute @rafa8626 * Updated flv.js library (https://github.com/mediaelement/mediaelement/pull/2180) @isantolin * Added new section on Documentation to link Code Snippets related to `MediaElement` @rafa8626 *4.0.6 (2017/04/20)* * Remove loading overlay only if it exists instead of failing (https://github.com/mediaelement/mediaelement/pull/2167) @kozze89 * Fixed issue with `replay` icon's CSS position @rafa8626 * Added workaround to avoid Firefox's `getComputedStyle` iframe bug @rafa8626 *4.0.5 (2017/04/14)* * Fixed typo to allow `None` caption to be unchecked @rafa8626 *4.0.4 (2017/04/11)* * Added missing conditional to display error message only if `message` is set on event @rafa8626 * Fixed issue with old versions of IE not unsetting CSS values properly for `fill` mode @rafa8626 * Added workflow from Flash audio shim into video shim and removed several duplicated events @rafa8626 * Fixed issues with play/pause toggle and `fadeIn` and `fadeOut` effects @rafa8626 * Updated HLS shim library to latest version @rafa8626 * Fixed issue with keyboard trap in Safari desktop due to media's children element(s) being moved from original position @rafa8626 * Added missing style to hide native cues when using Safari desktop due to new workflow implemented @rafa8626 * Added documentation about setting new captions, media tag attributes and using `stretching` modes @rafa8626 * Added missing French translations (https://github.com/mediaelement/mediaelement/pull/2161) @kloh-fr * Cleaned SVG sprite and separate plugin icons in new sprite (https://github.com/mediaelement/mediaelement/pull/2157) @johndyer * Updated Swedish translations (https://github.com/mediaelement/mediaelement/pull/2163) @xpetter *4.0.3 (2017/04/04)* * Fixed typo when detecting dimensions for stretching: `auto` @rafa8626 * Perform improvements to AJAX method to prevent "pre-flight" requests @rafa8626 * Removed Captions menu height adjustment considered unnecessary @rafa8626 * Fixed typo with event specific to Android and iOS @rafa8626 * Fixed issue with Android not being able to play video when touching video area @rafa8626 * Added `captionschange` event and fixed minor issue for `None` caption @rafa8626 * Fixed show/hide of play, loading and buffer elements in various events @rafa8626 * Fixed issues with setting source for `hls` renderer due to latest changes on library @rafa8626 * Added documentation about how to use `MediaElement` with [React](https://facebook.github.io/react/) @rafa8626 * Standardized way to create events for all native renderers @rafa8626 * Fixed documentation in `utils.md` to indicate methods in `Features` section @rafa8626 *4.0.2 (2017/03/23)* * Added new unit tests to increase code coverage @rafa8626 * Fixed issue with `setFill()` method and reintroduced old workflow in focusout event @rafa8626 * Added default media dimensions to avoid breaking control bar when player is in small container @rafa8626 * Fixed issue with volume slider and rail width calculation @rafa8626 *4.0.1 (2017/03/22)* * Fixed major issues with iOS that prevent the player to be built @rafa8626 *4.0.0 (2017/03/22)* * Removed all dependencies to jQuery in code and created `utils/dom.js` to mimic jQuery's most used methods @rafa8626 * Added missing unit tests @rafa8626 * Fixed minor issues on Twitch, Facebook HLS and M(PEG)-DASH renderers @rafa8626 * Fixed minor issue with play/pause button not being updated properly when switching to new source and media has ended @rafa8626 * Fixed issues in documentation @rafa8626 * Fixed issue with `readyState` value in Flash video shim @rafa8626 * Added pause event when changing media sources @rafa8626 * Integrated `remove()` polyfill to simplify more code (https://github.com/mediaelement/mediaelement/pull/2140) @jimmywarting * Reintegrated and improved `Download File` workflow if error happens while attempting to play media @rafa8626 * Fixed workflow for `autoplay` property in all renderers @rafa8626 * Integrated [Mocha JSDOM](https://github.com/rstacruz/mocha-jsdom) package to add more unit tests @rafa8626 * Created `utils.md` file to describe the utilities/features available @rafa8626 *3.2.4 (2017/03/14)* * Removed conditional on MS Edge to bypass Flash detection due to error on Browserstack @rafa8626 * Added error event support in Flash shims (https://github.com/mediaelement/mediaelement/pull/2115) @astr0junk * Added default `preload` element if not set on `video` or `audio` due to issue described on #2114 @rafa8626 * Fixed typo in Facebook renderer @rafa8626 * Added missing conditional to avoid issues in Android using Flash @rafa8626 * Refactor loop related to dispatch/remove events (https://github.com/mediaelement/mediaelement/pull/2127) @bricev * Removed unnecessary code from Tracks feature and fixed typo in HLS renderer @rafa8626 * Escaped HTML tags in installation.md file (https://github.com/mediaelement/mediaelement/pull/2130) @GeorgySerga * Integrated Drop Frame Support for Timecode (https://github.com/mediaelement/mediaelement/pull/2126) @dmongrel * Added missing workflow to reintegrate slider when switching from live broadcast to regular file @rafa8626 * Added documentation to install plugin in WordPress @rafa8626 *3.2.3 (2017/03/02)* * Brought missing fix for HLS @rafa8626 *3.2.2 (2017/03/02)* * Fixed issue with renderers order by sorting them when user does not specify any order for them @rafa8626 * Added `addControlElement()` to preserve order of control elements when certain features are reset @rafa8626 * Fixed issue with native HLS when processing errors @rafa8626 * Fixed issue when no dimensions are being set in `