From b5ba41f5d33f39a09b0584ce9cb544e11b5c8d0b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?"J.=20Rene=CC=81e=20Beach"?= Date: Mon, 18 Feb 2013 13:01:56 -0500 Subject: [PATCH] Issue #1741498 by jessebeach, Wim Leers: Add a mobile preview bar to Drupal core MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: J. Renée Beach --- core/modules/contextual/contextual.toolbar.js | 9 +- .../config/responsive_preview.devices.yml | 45 ++ .../css/responsive-preview.base-rtl.css | 38 ++ .../css/responsive-preview.base.css | 110 ++++ .../css/responsive-preview.theme-rtl.css | 36 ++ .../css/responsive-preview.theme.css | 141 +++++ core/modules/responsive_preview/images/close.png | 3 + .../images/icon-responsive-preview-active.png | 3 + .../images/icon-responsive-preview.png | 4 + .../responsive_preview/js/responsive-preview.js | 581 ++++++++++++++++++++ .../responsive_preview/responsive_preview.info | 5 + .../responsive_preview/responsive_preview.module | 130 +++++ 12 files changed, 1104 insertions(+), 1 deletion(-) create mode 100644 core/modules/responsive_preview/config/responsive_preview.devices.yml create mode 100644 core/modules/responsive_preview/css/responsive-preview.base-rtl.css create mode 100644 core/modules/responsive_preview/css/responsive-preview.base.css create mode 100644 core/modules/responsive_preview/css/responsive-preview.theme-rtl.css create mode 100644 core/modules/responsive_preview/css/responsive-preview.theme.css create mode 100644 core/modules/responsive_preview/images/close.png create mode 100644 core/modules/responsive_preview/images/icon-responsive-preview-active.png create mode 100644 core/modules/responsive_preview/images/icon-responsive-preview.png create mode 100644 core/modules/responsive_preview/js/responsive-preview.js create mode 100644 core/modules/responsive_preview/responsive_preview.info create mode 100644 core/modules/responsive_preview/responsive_preview.module diff --git a/core/modules/contextual/contextual.toolbar.js b/core/modules/contextual/contextual.toolbar.js index 45f9757..ada9f11 100644 --- a/core/modules/contextual/contextual.toolbar.js +++ b/core/modules/contextual/contextual.toolbar.js @@ -27,13 +27,20 @@ Drupal.behaviors.contextualToolbar = { model: model }); - // Update the model based on overlay events. $(document) + // Update the model based on Overlay events. .on('drupalOverlayOpen.contextualToolbar', function () { model.set('isVisible', false); }) .on('drupalOverlayClose.contextualToolbar', function () { model.set('isVisible', true); + }) + // Update the model based on Responsive Preview events. + .on('drupalResponsivePreviewStarted.contextualToolbar', function () { + model.set('isVisible', false); + }) + .on('drupalResponsivePreviewStopped.contextualToolbar', function () { + model.set('isVisible', true); }); // Update the model to show the edit tab if there's >=1 contextual link. diff --git a/core/modules/responsive_preview/config/responsive_preview.devices.yml b/core/modules/responsive_preview/config/responsive_preview.devices.yml new file mode 100644 index 0000000..c8b20c4 --- /dev/null +++ b/core/modules/responsive_preview/config/responsive_preview.devices.yml @@ -0,0 +1,45 @@ +# References: +# - http://en.wikipedia.org/wiki/List_of_displays_by_pixel_density +# - http://www.w3.org/blog/CSS/2012/06/14/unprefix-webkit-device-pixel-ratio/ +# - http://pieroxy.net/blog/2012/10/18/media_features_of_the_most_common_devices.html +# +# The device listing and specifications will be updated periodically through +# minor releases of Drupal. + +devices: + iphone: + label: iPhone 5 + dimensions: + width: 640 + height: 1136 + dppx: 2 + iphone4: + label: iPhone 4 + dimensions: + width: 640 + height: 960 + dppx: 2 + ipad: + label: iPad + dimensions: + width: 1536 + height: 2048 + dppx: 2 + nexus4: + label: Nexus 4 + dimensions: + width: 768 + height: 1280 + dppx: 2 + nexus7: + label: Nexus 7 + dimensions: + width: 800 + height: 1280 + dppx: 1.325 + desktop: + label: Typical desktop + dimensions: + width: 1366 + height: 768 + dppx: 1 diff --git a/core/modules/responsive_preview/css/responsive-preview.base-rtl.css b/core/modules/responsive_preview/css/responsive-preview.base-rtl.css new file mode 100644 index 0000000..eaf2504 --- /dev/null +++ b/core/modules/responsive_preview/css/responsive-preview.base-rtl.css @@ -0,0 +1,38 @@ +/** + * @file + * RTL base styling for responsive preview. + */ + +/** + * Toolbar tab. + */ + +/* At narrow screen widths, float the tab to the right so it falls in line with + * the rest of the toolbar tabs. */ +.js .toolbar .bar .responsive-preview-toolbar-tab.tab { + float: right; +} +/* At wide widths, float the tab to the left. */ +@media only screen and (min-width: 36em) { + .js .toolbar .bar .responsive-preview-toolbar-tab.tab { + float: left; + } +} +.responsive-preview-toolbar-tab .responsive-preview-options { + left: 0.3em; + right: auto; +} + +/** + * Preview container. + * + * The container is kept offscreen after it is built and has been disabled. + */ +#responsive-preview-container { + left: auto; + right: -200%; +} +#responsive-preview-container.active { + left: auto; + right: 0; +} diff --git a/core/modules/responsive_preview/css/responsive-preview.base.css b/core/modules/responsive_preview/css/responsive-preview.base.css new file mode 100644 index 0000000..0efa751 --- /dev/null +++ b/core/modules/responsive_preview/css/responsive-preview.base.css @@ -0,0 +1,110 @@ +/** + * @file + * Base styling for responsive preview. + */ + +/** + * Constrain the window height to the client height when the preview is active. + */ +.responsive-preview-active { + height: 100%; + overflow: hidden; +} + +/** + * Toolbar tab. + */ +.responsive-preview-toolbar-tab { + display: none; +} +/* At narrow screen widths, float the tab to the left so it falls in line with + * the rest of the toolbar tabs. */ +.js .toolbar .bar .responsive-preview-toolbar-tab.tab { + display: block; + float: left; /* LTR */ + position: relative; +} +/* At wide widths, float the tab to the right. */ +@media only screen and (min-width: 36em) { + .js .toolbar .bar .responsive-preview-toolbar-tab.tab { + float: right; /* LTR */ + } +} +.responsive-preview-toolbar-tab .trigger { + display: block; +} +.responsive-preview-toolbar-tab .responsive-preview-options { + display: none; + z-index: 1; +} +.responsive-preview-toolbar-tab.open .responsive-preview-options { + display: block; +} +.js .responsive-preview-toolbar-tab.tab .responsive-preview-options li { + float: none; +} + +/** + * Preview container. + * + * The container is kept offscreen after it is built and has been disabled. + */ +#responsive-preview-container { + bottom: 0; + display: none; + height: 100%; + left: -200%; /* LTR */ + position: fixed; + top: 0; + width: 100%; + z-index: 1050; +} +#responsive-preview-container.active { + display: block; + left: 0; /* LTR */ +} +#responsive-preview-close { + position: absolute; + z-index: 75; +} +.responsive-preview-modal-background { + bottom: 0; + height: 100%; + left: 0; + position: fixed; + right: 0; + top: 0; + width: 100%; + z-index: 1; +} + +/** + * Preview iframe. + */ +#responsive-preview-container iframe { + height: 100%; + position: relative; + width: 100%; + z-index: 100; + -webkit-transition: all 150ms ease-out; + -moz-transition: all 150ms ease-out; + -o-transition: all 150ms ease-out; + transition: all 150ms ease-out; +} + +/** + * Override Toolbar styling in the preview iframe. + */ +body.toolbar-tray-open.responsive-preview-frame { + margin-left: 0 !important; + margin-right: 0 !important; +} +.responsive-preview-frame { + overflow-x: hidden !important; +} +.responsive-preview-frame #toolbar-administration { + display: none !important; +} +.responsive-preview-frame .contextual { + display: none !important; +} diff --git a/core/modules/responsive_preview/css/responsive-preview.theme-rtl.css b/core/modules/responsive_preview/css/responsive-preview.theme-rtl.css new file mode 100644 index 0000000..8add01e --- /dev/null +++ b/core/modules/responsive_preview/css/responsive-preview.theme-rtl.css @@ -0,0 +1,36 @@ +/** + * @file + * RTL styling for responsive preview. + */ + +/** + * Toolbar tab. + */ + +/* Toolbar icon. */ +.toolbar .bar .responsive-preview-toolbar-tab .icon-responsive-preview:before { + left: auto; + right: 1em; +} + +/* Toolbar tab triangle toggle. */ +.responsive-preview-toolbar-tab .trigger:after { + left: 1em; + right: auto; +} +.responsive-preview-toolbar-tab.open:before { + left: 0; + right: auto; +} +.responsive-preview-toolbar-tab.open .trigger:after { + left: 0.7em; + right: auto; +} + +/** + * Preview container. + */ +#responsive-preview-close { + margin-left: 0; + margin-right: 10px; +} diff --git a/core/modules/responsive_preview/css/responsive-preview.theme.css b/core/modules/responsive_preview/css/responsive-preview.theme.css new file mode 100644 index 0000000..e0c537f --- /dev/null +++ b/core/modules/responsive_preview/css/responsive-preview.theme.css @@ -0,0 +1,141 @@ +/** + * @file + * Styling for responsive preview. + */ + +/** + * Toolbar tab. + */ +.responsive-preview-toolbar-tab .responsive-preview-options { + background-color: #0f0f0f; +} +/* Toolbar icon. */ +.toolbar .bar .icon.icon-responsive-preview { + margin-left: 0; + margin-right: 0; + padding-left: 0; + padding-right: 0; + width: 5em; +} +.icon-responsive-preview:before { + background-image: url("../images/icon-responsive-preview.png"); +} +.toolbar .bar .responsive-preview-toolbar-tab .icon-responsive-preview:before { + left: 1em; /* LTR */ +} +.responsive-preview-toolbar-tab.open .icon-responsive-preview:before, +.responsive-preview-toolbar-tab .icon-responsive-preview.active:before { + background-image: url("../images/icon-responsive-preview-active.png"); +} +@media only screen and (min-width: 16.5em) { + .toolbar .responsive-preview-toolbar-tab.tab .icon-responsive-preview:before { + width: 20px; + } +} +/* Device preview options. */ +.responsive-preview-toolbar-tab .responsive-preview-options { + box-shadow: 0 0.8em 2.5em -0.8em rgba(0, 0, 0, 0.75); + position: absolute; + white-space: nowrap; +} +.responsive-preview-toolbar-tab .responsive-preview-options li { + background-color: white; +} +.responsive-preview-toolbar-tab .trigger { + height: 3em; +} +.responsive-preview-toolbar-tab .trigger, +.responsive-preview-toolbar-tab .responsive-preview-options a { + padding-bottom: 1em; + padding-top: 1em; +} +.toolbar .responsive-preview-toolbar-tab.tab .responsive-preview-options a { + color: #777; +} +.toolbar .responsive-preview-toolbar-tab.tab .responsive-preview-options a:hover { + color: black; +} +/* Toolbar tab triangle toggle. */ +.responsive-preview-toolbar-tab .trigger:after { + border-bottom-color: transparent; + border-left-color: transparent; + border-right-color: transparent; + border-style: solid; + border-width: 0.4545em 0.4em 0; + color: #a0a0a0; + content: ' '; + display: block; + height: 0; + line-height: 0; + overflow: hidden; + position: absolute; + right: 1em; /* LTR */ + top: 50%; + margin-top: -0.1666em; + width: 0; + z-index: 1 +} +.responsive-preview-toolbar-tab.open:before { + background-color: white; + bottom: 0; + content: ' '; + display: block; + position: absolute; + right: 0; /* LTR */ + top: 0; + width: 2em; + z-index: 1; +} +.responsive-preview-toolbar-tab.open .trigger:after { + border-bottom: 0.4545em solid; + border-top-color: transparent; + color: black; + right: 0.7em; /* LTR */ + top: 1.25em; +} +.responsive-preview-toolbar-tab .trigger.active:after { + color: black; +} +.responsive-preview-toolbar-tab .trigger.active { + background-image: -webkit-linear-gradient(top, rgb(78,159,234) 0%, rgb(69,132,221) 100%); + background-image: linear-gradient(rgb(78,159,234) 0%,rgb(69,132,221) 100%); +} + +/** + * Preview container. + */ +#responsive-preview-container { + box-shadow: 0 0 10px 0 black; +} +#responsive-preview-container iframe { + box-shadow: + 0 0 0 2px black, + 0 0 0 3px rgba(80,80,80,1); + top: 10px; +} +#responsive-preview-close { + background-attachment: scroll; + background-color: #a0a0a0; + background-image: url("../images/close.png"); + background-image: url("../images/close.png"), -webkit-linear-gradient(transparent, #787878 150%); + background-image: url("../images/close.png"), linear-gradient(transparent, #787878 150%); + background-position: center center; + background-repeat: no-repeat; + border: none; + border-radius: 3px; + cursor: pointer; + font-size: 1em; + height: 2.333em; + margin-left: 10px; /* LTR */ + margin-top: 9px; + width: 2.333em; +} +#responsive-preview-close:hover { + background-image: url("../images/close.png"); +} +.responsive-preview-modal-background { + background-color: black; + background-color: rgba(0,0,0,0.92); + background-image: -webkit-linear-gradient(left, black,rgb(20,20,20) 15%, rgb(45,45,45) 40%, rgb(45,45,45) 60%, rgb(20,20,20) 85%, black 100%); + background-image: linear-gradient(left, black, rgb(20,20,20) 15%, rgb(45,45,45) 40%, rgb(45,45,45) 60%, rgb(20,20,20) 85%, black 100%); +} diff --git a/core/modules/responsive_preview/images/close.png b/core/modules/responsive_preview/images/close.png new file mode 100644 index 0000000..538518e --- /dev/null +++ b/core/modules/responsive_preview/images/close.png @@ -0,0 +1,3 @@ +PNG + + IHDR7tEXtSoftwareAdobe ImageReadyqe<IDAT(SeKKBAx_iWjOhBREࣝ{E. BpEĽuy!h sVYkiֶ^pđ#^j[RPZaC̄>5Vdr2Q\mF*ToBKگ tJr?wϋ||PqkUݞ,/s_n ^z({!-sSS3oRlYgE/S 9d,H+_ϲ5}PrgY{ST⫑V k{,p2D*kfj5Nd2Z>%o=$4֘5FhhfPnoҗ1_M|6]!mf-!K}H2N|S \*6BQ1 #(&INʕr;Sd #Z IENDB` \ No newline at end of file diff --git a/core/modules/responsive_preview/images/icon-responsive-preview-active.png b/core/modules/responsive_preview/images/icon-responsive-preview-active.png new file mode 100644 index 0000000..f6e8a16 --- /dev/null +++ b/core/modules/responsive_preview/images/icon-responsive-preview-active.png @@ -0,0 +1,3 @@ +PNG + + IHDR $cIDAT8c L@HL0#! W?&m"mр0?|?! ?bG(!)dF,~(.teIENDB` \ No newline at end of file diff --git a/core/modules/responsive_preview/images/icon-responsive-preview.png b/core/modules/responsive_preview/images/icon-responsive-preview.png new file mode 100644 index 0000000..3e22cb8 --- /dev/null +++ b/core/modules/responsive_preview/images/icon-responsive-preview.png @@ -0,0 +1,4 @@ +PNG + + IHDR $pIDAT8cZx O? f 380L-\1 L %ϦQM߿@S;#ƐD +iڈEBCituJq4QIENDB` \ No newline at end of file diff --git a/core/modules/responsive_preview/js/responsive-preview.js b/core/modules/responsive_preview/js/responsive-preview.js new file mode 100644 index 0000000..266e568 --- /dev/null +++ b/core/modules/responsive_preview/js/responsive-preview.js @@ -0,0 +1,581 @@ +/** + * @file + * Provides a component that previews the page in various device dimensions. + */ + +(function ($, Backbone, Drupal, drupalSettings, window, document) { + +"use strict"; + +/** + * Attaches behaviors to the toolbar tab and preview containers. + */ +Drupal.behaviors.responsivePreview = { + attach: function (context, settings) { + settings.responsivePreview = settings.responsivePreview || {}; + // once() returns a jQuery set. It will be empty if no unprocessed + // elements are found. window and window.parent are equivalent unless the + // Drupal page is itself wrapped in an iframe. + var $body = $(window.parent.document.body).once('responsive-preview'); + + if ($body.length) { + // If this window is itself in an iframe it must be marked as processed. + // Its parent window will have been processed above. + // When attach() is called again for the preview iframe, it will check + // its parent window and find it has been processed. In most cases, the + // following code will have no effect. + $(window.document.body).once('responsive-preview'); + var gutter = settings.responsivePreview.gutter || 60; + + var envModel = new Drupal.responsivePreview.models.EnvironmentModel({ + dir: document.getElementsByTagName('html')[0].getAttribute('dir') + }); + var tabModel = new Drupal.responsivePreview.models.TabStateModel(); + var previewModel = new Drupal.responsivePreview.models.PreviewStateModel(); + + // The toolbar tab view. + var tabView = new Drupal.responsivePreview.views.TabView({ + el: $(context).find('#toolbar-tab-responsive-preview'), + model: tabModel, + envModel: envModel, + // Gutter size around preview frame. + gutter: gutter + }); + // The preview container view. + var previewView = new Drupal.responsivePreview.views.PreviewView({ + el: Drupal.theme('layoutContainer'), + model: previewModel, + tabModel: tabModel, + envModel: envModel, + // Gutter size around preview frame. + gutter: gutter + }); + + var setViewportWidth = function() { + envModel.set('viewportWidth', document.documentElement.clientWidth); + }; + + $(window) + // Update the viewport width whenever it is resized, but max 4 times/s. + .on('resize.responsivePreview', Drupal.debounce(setViewportWidth, 250)); + + // Allow other scripts to respond to responsive preview mode changes. + tabModel.on('change:isActive', function (model, isActive) { + $(document).trigger((isActive) ? 'drupalResponsivePreviewStarted' : 'drupalResponsivePreviewStopped'); + }); + + // Initialization: set the current viewport width. + setViewportWidth(); + } + // The main window is equivalent to window.parent and window.self. Inside, + // an iframe, these objects are not equivalent. If the parent window is + // itself in an iframe, check that the parent window has been processed. + // If it has been, this invocation of attach() is being called on the + // preview iframe, not its parent. + if ((window.parent !== window.self) && !$body.length) { + var $frameBody = $(window.self.document.body).once('responsive-preview'); + if ($frameBody.length > 0) { + $frameBody.get(0).className += ' responsive-preview-frame'; + } + } + } +}; + +Drupal.responsivePreview = Drupal.responsivePreview || {models: {}, views: {}}; + +/** + * Backbone Model for the environment in which the Responsive Preview operates. + */ +Drupal.responsivePreview.models.EnvironmentModel = Backbone.Model.extend({ + defaults: { + // The viewport width, within which the preview will have to fit. + viewportWidth: null, + // Text direction of the document, affects some positioning. + dir: 'ltr' + } +}); + +/** + * Backbone Model for the Responsive Preview toolbar tab state. + */ +Drupal.responsivePreview.models.TabStateModel = Backbone.Model.extend({ + defaults: { + // The state of the preview. + isActive: false, + // The state of toolbar list if available device previews. + isDeviceListOpen: false, + // The number of devices that fit the current viewport (i.e. previewable). + fittingDeviceCount: 0, + // Dimensions of the currently selected device to preview. + dimensions: { + // The width of the device to preview. + width: null, + // The height of the device to preview. + height: null, + // The dots per pixel of the device to preview. + dppx: null + } + } +}); + +/** + * Backbone Model for the Responsive Preview preview state. + */ +Drupal.responsivePreview.models.PreviewStateModel = Backbone.Model.extend({ + defaults: { + // Indicates whether the preview iframe has been built. + isBuilt: false + } +}); + +/** + * Handles responsive preview toolbar tab interactions. + */ +Drupal.responsivePreview.views.TabView = Backbone.View.extend({ + + events: { + 'click': 'toggleDeviceList', + 'mouseleave': 'toggleDeviceList', + 'click .responsive-preview-device': 'updateDimensions' + }, + + /** + * Implements Backbone Views' initialize(). + */ + initialize: function () { + this.gutter = this.options.gutter; + this.envModel = this.options.envModel; + + this.model.on('change:isActive change:isDeviceListOpen change:fittingDeviceCount', this.render, this); + this.envModel.on('change:viewportWidth', this.updateDeviceList, this); + this.envModel.on('change:viewportWidth', this.correctDeviceListEdgeCollision, this); + }, + + /** + * Implements Backbone Views' render(). + */ + render: function () { + var isActive = this.model.get('isActive'); + var isDeviceListOpen = this.model.get('isDeviceListOpen'); + this.$el + // Render the visibility of the toolbar tab. + .toggle(this.model.get('fittingDeviceCount') > 0) + // Toggle the display of the device list. + .toggleClass('open', isDeviceListOpen) + // Render the state of the toolbar tab button. + .find('> button') + .toggleClass('active', isActive) + .attr('aria-pressed', isActive); + // When the preview is active, a class on the body is necessary to impose + // styling to aid in the display of the preview element. + $('body').toggleClass('responsive-preview-active', isActive); + // The list of devices might render outside the window. + if (isDeviceListOpen) { + this.correctDeviceListEdgeCollision(); + } + return this; + }, + + /** + * Toggles the list of devices available to preview from the toolbar tab. + * + * @param Object event + * jQuery Event object. + */ + toggleDeviceList: function (event) { + // Force the options list closed on mouseleave. + if (event.type === 'mouseleave') { + this.model.set('isDeviceListOpen', false); + } + else { + this.model.set('isDeviceListOpen', !this.model.get('isDeviceListOpen')); + } + + event.preventDefault(); + event.stopPropagation(); + }, + + /** + * Model change handler; corrects possible device list window edge collision. + */ + correctDeviceListEdgeCollision: function () { + // The position of the dropdown depends on the language direction. + var dir = this.envModel.get('dir'); + var edge = (dir === 'rtl') ? 'left' : 'right'; + this.$el + .find('.responsive-preview-options') + .position({ + 'my': edge +' top', + 'at': edge + ' bottom', + 'of': this.$el, + 'collision': 'flip fit' + }); + }, + + /** + * Model change handler; hides devices that don't fit the current viewport. + */ + updateDeviceList: function () { + var gutter = this.gutter; + var viewportWidth = this.envModel.get('viewportWidth'); + var $devices = this.$el.find('.responsive-preview-device'); + // Remove devices whose previews won't fit the current viewport. + $devices.each(function (index, element) { + var $this = $(this); + var width = parseInt($this.data('responsive-preview-width'), 10); + var dppx = parseFloat($this.data('responsive-preview-dppx'), 10); + var previewWidth = width / dppx; + var fits = ((previewWidth + (gutter * 2)) <= viewportWidth); + $this.parent('li').toggleClass('element-hidden', !fits); + }); + // Set the number of devices that fit the current viewport. + this.model.set('fittingDeviceCount', $devices.parent('li').not('.element-hidden').length); + }, + + /** + * Updates the model to reflect the dimensions of the chosen device. + * + * @param Object event + * A jQuery event object. + */ + updateDimensions: function (event) { + var $link = $(event.target); + // Update the device dimensions. + this.model.set('dimensions', { + 'width': parseInt($link.data('responsive-preview-width'), 10), + 'height': parseInt($link.data('responsive-preview-height'), 10), + 'dppx': parseFloat($link.data('responsive-preview-dppx'), 10) + }); + // Toggle the preview on. + this.model.set('isActive', true); + + event.preventDefault(); + } + +}); + +/** + * Handles the responsive preview element interactions. + */ +Drupal.responsivePreview.views.PreviewView = Backbone.View.extend({ + + events: { + 'click #responsive-preview-close': 'onClose' + }, + + /** + * Implements Backbone Views' initialize(). + */ + initialize: function () { + this.gutter = this.options.gutter; + this.tabModel = this.options.tabModel; + this.envModel = this.options.envModel; + + this.tabModel.on('change:isActive change:dimensions', this.render, this); + + // Recalculate the size of the preview container when the window resizes. + this.envModel.on('change:viewportWidth', this.render, this); + }, + + /** + * Implements Backbone Views' render(). + */ + render: function () { + var isActive = this.tabModel.get('isActive'); + + // Render the state of the preview. + this.$el.toggleClass('active', isActive); + + // Early-return if inactive. + if (!isActive) { + return this; + } + + // Build the preview if it doesn't exist. + if (!this.model.get('isBuilt')) { + this._build(); + } + // Refresh the preview. + this._refresh(); + + return this; + }, + + /** + * Closes the preview. + * + * @param Object event + * A jQuery event object. + */ + onClose: function () { + this.tabModel.set('isActive', false); + }, + + /** + * Builds the preview iframe. + */ + _build: function () { + this.$el.append(Drupal.theme('layoutClose')); + // Attach the iframe that will hold the preview. + var $frame = $(Drupal.theme('layoutFrame')) + .attr('data-loading', true) + .appendTo(this.$el); + // Displace the top of the container. + this.$el + .css({ top: this._getDisplacement('top') }) + .attr('data-offset-top', this._getDisplacement('top')) + // Append the container to the body to initialize the iframe document. + .appendTo('body'); + // The contentDocument property is not supported in IE until IE8. + var iframeDocument = $frame[0].contentDocument || $frame[0].contentWindow.document; + // Load the current page URI into the preview iframe. + $frame.on('load.responsivePreview', $.proxy(this._refresh, this)); + iframeDocument.location.href = drupalSettings.basePath + Drupal.encodePath(drupalSettings.currentPath); + // Mark the preview element processed. + this.model.set('isBuilt', true); + }, + + /** + * Refreshes the preview based on the current state (device & viewport width). + */ + _refresh: function () { + var $frame = this.$el.find('#responsive-preview-frame'); + + // Get the static state. + var edge = (this.envModel.get('dir') === 'rtl') ? 'right' : 'left'; + var minGutter = this.gutter; + + // Get current (dynamic) state. + var dimensions = this.tabModel.get('dimensions'); + var viewportWidth = this.envModel.get('viewportWidth'); + + // Calculate preview width & height. + var width = dimensions.width / dimensions.dppx; + var height = dimensions.height / dimensions.dppx; + + // Calculate gutter. + var gutterPercent = (1 - (width / viewportWidth)) / 2; + var gutter = gutterPercent * viewportWidth; + gutter = (gutter < minGutter) ? minGutter : gutter; + + // The preview width plus gutters must fit within the viewport width. + width = (viewportWidth - (gutter * 2) < width) ? viewportWidth - (gutter * 2) : width; + + // Resize & reposition the iframe. + var position = {}; + position[edge] = gutter; // Depends on text direction. + $frame + .stop(true, true) + .animate({ + width: width, + height: height + }, 'fast') + .css(position); + + // Scale if not responsive. + this._scaleIfNotResponsive(); + + // Position the close button. + this.$el + .find('#responsive-preview-close') + .css(edge, gutter + width); + }, + + /** + * Applies scaling in order to better approximate content display on a device. + */ + _scaleIfNotResponsive: function () { + var scalingCSS = this._calculateScalingCSS(); + if (scalingCSS === false) { + return; + } + + // Step 0: find DOM nodes we'll need to modify. + var $frame = this.$el.find('#responsive-preview-frame'); + var $html = $($frame[0].contentDocument || $frame[0].contentWindow.document).find('html'); + + // Step 1: When scaling (as we're about to do), the background (color and + // image) doesn't scale along. Fortunately, we can fix things in case of + // background color. + // @todo: figure out a work-around for background images, or somehow + // document this explicitly. + function isTransparent (color) { + // TRICKY: edge case for Firefox' "transparent" here; this is a + // browser bug: https://bugzilla.mozilla.org/show_bug.cgi?id=635724 + return (color === 'rgba(0, 0, 0, 0)' || color === 'transparent'); + } + var htmlBgColor = $html.css('background-color'); + var bodyBgColor = $html.find('body').css('background-color'); + if (!isTransparent(htmlBgColor) || !isTransparent(bodyBgColor)) { + var bgColor = isTransparent(htmlBgColor) ? bodyBgColor : htmlBgColor; + $frame.css('background-color', bgColor); + } + + // Step 2: apply scaling. + $html.css(scalingCSS); + }, + + /** + * Calculates scaling based on device dimensions and . + * + * Websites that don't indicate via that their width + * is identical to the device width will be rendered at a larger size: at the + * layout viewport's default width. This width exceeds the visual viewport on + * the device, and causes it to scale it down. + * + * This function checks whether the underlying web page is responsive, and if + * it's not, then it will calculate a CSS scaling transformation, to closely + * approximate how an actual mobile device would render the web page. + * + * We assume all mobile devices' layout viewport's default width is 980px. It + * is the value used on all iOS and Android >=4.0 devices. + * + * Related reading: + * - http://www.quirksmode.org/mobile/viewports.html + * - http://www.quirksmode.org/mobile/viewports2.html + * - https://developer.apple.com/library/safari/#documentation/AppleApplications/Reference/SafariWebContent/UsingtheViewport/UsingtheViewport.html + * - http://tripleodeon.com/2011/12/first-understand-your-screen/ + * - http://tripleodeon.com/wp-content/uploads/2011/12/table.html?r=android40window.innerw&c=980 + */ + _calculateScalingCSS: function () { + var settings = this._parseViewportMetaTag(); + var defaultLayoutWidth = 980, initialScale = 1; + var layoutViewportWidth, layoutViewportHeight; + var visualViewPortWidth; // The visual viewport width === the preview width. + + if (settings.width) { + if (settings.width === 'device-width') { + // Don't scale if the page is marked to be as wide as the device. + return false; + } + else { + layoutViewportWidth = parseInt(settings.width, 10); + } + } + else { + layoutViewportWidth = defaultLayoutWidth; + } + + if (settings.height && settings.height !== 'device-height') { + layoutViewportHeight = parseInt(settings.height, 10); + } + + if (settings['initial-scale']) { + initialScale = parseFloat(settings['initial-scale'], 10); + if (initialScale < 1) { + layoutViewportWidth = defaultLayoutWidth; + } + } + + // Calculate the scale, prevent excesses (ensure the (0.25, 2) range). + var dimensions = this.tabModel.get('dimensions'); + visualViewPortWidth = dimensions.width / dimensions.dppx; + var scale = initialScale * (100 / layoutViewportWidth) * (visualViewPortWidth / 100); + scale = Math.min(scale, 2); + scale = Math.max(scale, 0.25); + + var transform = "scale(" + scale + ")"; + var origin = "0 0"; + return { + 'min-width': layoutViewportWidth + 'px', + 'min-height': layoutViewportHeight + 'px', + '-webkit-transform': transform, + '-ms-transform': transform, + 'transform': transform, + '-webkit-transform-origin': origin, + '-ms-transform-origin': origin, + 'transform-origin': origin + }; + }, + + /** + * Parses tag's "content" attribute, if any. + * + * Parses something like this: + * + * into this: + * { + * width: 'device-width', + * initial-scale: '1', + * maximum-scale: '5', + * minimum-scale: '1', + * user-scalable: 'yes' + * } + * + * @return Object + * Parsed viewport settings, or {}. + */ + _parseViewportMetaTag: function () { + var settings = {}; + var $viewportMeta = $(document).find('meta[name=viewport][content]'); + if ($viewportMeta.length > 0) { + $viewportMeta + .attr('content') + // Reduce multiple parts of whitespace to a single space. + .replace(/\s+/g, '') + // Split on comma (which separates the different settings). + .split(',') + .map(function (setting) { + setting = setting.split('='); + settings[setting[0]] = setting[1]; + }); + } + return settings; + }, + + /** + * Gets the total displacement of given region. + * + * @param String region + * Region name. Either "top" or "bottom". + * + * @return Number + * The total displacement of given region in pixels. + */ + _getDisplacement: function (region) { + var displacement = 0; + var lastDisplaced = $('[data-offset-' + region + ']'); + if (lastDisplaced.length) { + displacement = parseInt(lastDisplaced.attr('data-offset-' + region), 10); + } + return displacement; + } + +}); + +/** + * Registers theme templates with Drupal.theme(). + */ +$.extend(Drupal.theme, { + /** + * Theme function for the preview container element. + * + * @return + * The corresponding HTML. + */ + layoutContainer: function () { + return '
'; + }, + + /** + * Theme function for the close button for the preview container. + * + * @return + * The corresponding HTML. + */ + layoutClose: function () { + return ''; + }, + + /** + * Theme function for a responsive preview iframe element. + * + * @return + * The corresponding HTML. + */ + layoutFrame: function (url) { + return ''; + } +}); + +}(jQuery, Backbone, Drupal, drupalSettings, window, document)); diff --git a/core/modules/responsive_preview/responsive_preview.info b/core/modules/responsive_preview/responsive_preview.info new file mode 100644 index 0000000..1930a4d --- /dev/null +++ b/core/modules/responsive_preview/responsive_preview.info @@ -0,0 +1,5 @@ +name = Responsive Preview +description = Provides a component that previews a page in various device dimensions. +package = Core +version = VERSION +core = 8.x diff --git a/core/modules/responsive_preview/responsive_preview.module b/core/modules/responsive_preview/responsive_preview.module new file mode 100644 index 0000000..23729d5 --- /dev/null +++ b/core/modules/responsive_preview/responsive_preview.module @@ -0,0 +1,130 @@ +' . t('About') . ''; + $output .= '

' . t('The Responsive Preview module provides a quick way to preview a page on your site within the dimensions of many popular device and screen sizes.') . '

'; + $output .= '

' . t('Uses') . '

'; + $output .= '

' . t('To launch a preview, first click the toolbar tab with the small device icon. The tab has the title "@title". A list of devices will appear. Selecting a device name will launch a preview of the current page within the dimensions of that device.', array('@title' => t('Preview page layout'))) . '

'; + $output .= '

' . t('To close the preview, click the close button signified visually by an x.') . '

'; + return $output; + } +} + +/** + * Returns a list of devices and their properties from configuration. + */ +function responsive_preview_get_devices_list() { + $devices = config('responsive_preview.devices')->get('devices'); + + $links = array(); + foreach($devices as $name => $info) { + $links[$name] = array( + 'title' => $info['label'], + 'href' => '', + 'options' => array( + 'fragment' => '!', + 'external' => TRUE, + ), + 'attributes' => array( + 'class' => array('responsive-preview-device'), + 'data-responsive-preview-width' => ($info['dimensions']['width']) ? $info['dimensions']['width'] : '', + 'data-responsive-preview-height' => ($info['dimensions']['height']) ? $info['dimensions']['height'] : '', + 'data-responsive-preview-dppx' => ($info['dimensions']['dppx']) ? $info['dimensions']['dppx'] : '1', + ), + ); + } + + return $links; +} + +/** + * Prevents the preview tab from rendering on administration pages. + */ +function responsive_preview_access() { + return !path_is_admin(current_path()); +} + +/** + * Implements hook_toolbar(). + */ +function responsive_preview_toolbar() { + $items['responsive_preview'] = array( + '#type' => 'toolbar_item', + 'tab' => array( + 'trigger' => array( + '#theme' => 'html_tag', + '#tag' => 'button', + '#value' => t('Layout preview'), + '#value_prefix' => '', + '#value_suffix' => '', + '#attributes' => array( + 'id' => 'responsive-preview', + 'title' => t('Preview page layout'), + 'class' => array('icon', 'icon-responsive-preview', 'trigger'), + ), + ), + 'device_options' => array( + '#theme' => 'links', + '#links' => responsive_preview_get_devices_list(), + '#attributes' => array( + 'class' => array('responsive-preview-options'), + ), + ), + ), + '#wrapper_attributes' => array( + 'id' => 'toolbar-tab-responsive-preview', + 'class' => array('responsive-preview-toolbar-tab'), + ), + '#attached' => array( + 'library' => array( + array('responsive_preview', 'responsive-preview'), + ), + ), + '#weight' => 200, + '#access' => responsive_preview_access(), + ); + + return $items; +} + +/** + * Implements hook_library(). + */ +function responsive_preview_library_info() { + $path = drupal_get_path('module', 'responsive_preview'); + $options = array( + 'scope' => 'footer', + 'attributes' => array('defer' => TRUE), + ); + + $libraries['responsive-preview'] = array( + 'title' => 'Preview layouts', + 'version' => VERSION, + 'css' => array( + $path . '/css/responsive-preview.base.css', + $path . '/css/responsive-preview.theme.css', + ), + 'js' => array( + $path . '/js/responsive-preview.js' => $options, + ), + 'dependencies' => array( + array('system', 'jquery'), + array('system', 'drupal'), + array('system', 'backbone'), + array('system', 'jquery.ui.position'), + ), + ); + + return $libraries; +} -- 1.7.10.4