loader

Use the loader block for downloading and connecting scripts by URLs.

Overview

Block modifiers

Functions enabled by block elements

Public block technologies

The block is implemented in:

• js

Description

Block modifiers

type modifier

Provides a set of functions to download and connect different data types.

Acceptable values: 'js', 'bundle'.

Usage: JS.

Depending on the value of the type modifier, the loader block lets you download from a URL and connect:

• js – A JavaScript fragment.
• bundle – A bundle of CSS and JS files.

type modifier with the js value

Provides a function to download and connect a JavaScript fragment.

Accepted arguments:

• url {String} – URL of the JavaScript fragment to download. Required argument.
• [success {Function}] – The callback function to run when the code is loaded successfully.
• [error {Function}] – The callback function to run when the code couldn't load because of an error.

No return value.

For example, loader_type_js can be used for downloading and enabling jQuery:

modules.define('jquery', ['loader_type_js'], function(provide, loader) {

    loader(
        'https://yastatic.net/jquery/2.2.0/jquery.min.js',
        function() { provide(jQuery) });

});

For a more advanced example, see the common.blocks/jquery block in the bem-core library.

type modifier with the bundle value

Provides a function to download and connect a bundle of CSS and JS files.

Accepted arguments:

• id {String} – Bundle ID. Required argument.
• url {String} – The path to the bundle file in URL format. Required argument.
• onSuccess {Function} – The callback to run when the bundle is loaded successfully. Required argument.
• [onError {Function}] – The callback to run when the bundle didn't load.

No return value.

The specification for the bundle technology is currently under development. For more details, write your questions in the forum.

_loaded static method

The function connected with the type_bundle modifier has the _loaded static method. It is used as a helper method after successfully loading the bundle.

Accepted arguments:

• id {String} – Bundle ID. Required argument.

No return value.