Skip to content

Latest commit

 

History

History
51 lines (35 loc) · 2.13 KB

rwd_js.md

File metadata and controls

51 lines (35 loc) · 2.13 KB
Raw
group title functional_areas redirect_to status
frontend-developer-guide
JavaScript in responsive design
Frontend
migrated

What's in this topic

This topic describes the JavaScript used in Magento out-of-the-box Blank and Luma themes to relocate certain elements and change their behavior depending on the [breakpoint]({{ page.baseurl }}/frontend-dev-guide/responsive-web-design/rwd_overview.html#fedg_rwd_terms).

Scripts general overview

The Blank and Luma themes use the following scripts to responsively relocate page elements by breakpoint:

The script files are located in the file system as follows:

├── lib/web/
    ├── matchMedia.js
    ├── mage/
       ├── menu.js

menu.js {#fedg_rwd_js_nav}

In a mobile view, on the 768px breakpoint, menu.js changes the navigation menu look and behavior the following way:

  • Category menu items are not displayed, but are accessible after clicking the menu icon.
  • The behavior of a category link depends on whether the category has sub-categories:
    • If sub-categories exist, the category link behaves as collapsible block. Clicking a category link does not redirect to the category page immediately. Instead it opens a list of sub-categories, including the All category products option.
    • If there are no sub-categories, the category link behaves as usual.

The following image illustrates the mobile-view navigation menu.

responsive menu

Re-using Magento scripts in your theme {#rwd_js_reuse}

You can use the menu.js and matchMedia.js to add responsive behavior in your custom theme. If your theme inherits from Blank or Luma, you do not even need to additionally include the script files in your theme.

If your theme does not inherit from Blank or Luma, to be able to use the scripts, you must configure RequireJS for your theme.