You are here

function hook_modernizr_load in Modernizr 7.3

Same name and namespace in other branches
  1. 8 modernizr.api.php \hook_modernizr_load()

Registers a Modernizr.load() testObject.

Modernizr.load() is actually a standalone library called yepnope.js which is included in Modernizr custom builder. This hook aims to offer 1:1 feature parity with yepnope.js - current version: 1.5

Learn how all of these properties interact with Modernizr.load() on the yepnope website: http://yepnopejs.com/#testObject

Return value

An array to be output as yepnope testObjects.

1 invocation of hook_modernizr_load()
modernizr_load_list in ./modernizr.module
Asks other Drupal modules for yepnope() commands.

File

./modernizr.api.php, line 60
Hooks provided by the Modernizr module

Code

function hook_modernizr_load() {
  $load = array();

  // Unlike hook_modernizr_info(), no array index is needed.
  // You can add as many Modernizr.load() commands as you want
  $load[] = array(
    // The 'test' property determines which resources get downloaded.
    // Your test can be *any* truthy JavaScript expression; you are NOT
    // limited to Modernizr properties. You can combine tests like so:
    //
    // - Modernizr.borderradius && Modernizr.csstransforms3d
    //
    //   This test requires the user's browser to support both border-radius
    //   and CSS 3D transforms.
    //
    // - Modernizr.mq('only screen and (min-width: 400px)') || !!respond
    //
    //   This test requires the browser to support CSS3 media queries
    //   and have a window width of at least 400px or have access to
    //   the object provided by respond.js, a different JavaScript library
    //   which gives old browsers a minimal ability to eval min- and
    //   max-width media queries.
    //
    // Test the user's browser for border-radius support.
    'test' => 'Modernizr.borderradius',
    // If the test PASSES load these files. Example shows a hardcoded path.
    'yep' => array(
      '/css/radius.css',
    ),
    // If the test FAILS load these files. Example shows a Drupal path (don't
    // forget opening slash, or it won't work except at your site root)
    'nope' => array(
      '/' . drupal_get_path('module', 'modernizr') . '/fake/path/to/radius.css',
    ),
    // These resources will always load regardless of the test results.
    // 'load' and 'both' offer the exact same functionality.
    'both' => array(
      '/always/loaded.js',
    ),
    'load' => array(
      '/always/loaded.js',
    ),
    // Each JavaScript callback should be enclosed inside an anonymous function.
    // Take care to format correctly. You can provide an array of functions that
    // should match the number of items in your yep or nope properties.
    'callback' => array(
      'function(){console.log("If you can see this, a Modernizr.load() individual callback was fired.")}',
    ),
    // The final 'complete' callback requires an anonymous JavaScript function.
    // Take care to format correctly. Despite being inside an array, you should
    // only add one function.
    'complete' => array(
      'function(){console.log("If you can see this, the Modernizr.load() complete callback was fired.")}',
    ),
  );
  return $load;
}