1KA_F2F/frontend/drupal/sites/all/modules/lazy/README.md

Lazy-load is a simple Drupal module which integrates bLazy lazy-loading script via image field display formatters and input-filters for inline images and iframes.

There is another contributed module utilizing its namesake, Blazy. Make sure to check it out, especially if you need more advanced features and support for many features out of the box.

This module started to fill-in the only area Blazy module lacks of; inline-images and inline-iframes. Now, Lazy-load can also be enabled for each image field as well.

You can use Lazy-load module tandem with Blazy, though that is not a requirement.

Requirements

• Libraries API module (Drupal 7 only)
• bLazy v1.8.2 script as a library item

Installing Manually

• Download bLazy from https://github.com/dinbror/blazy
• Extract the downloaded file,
• rename blazy-master directory to blazy,
• copy the folder into one of the following places that Libraries API module supports, sites/all/libraries (or site-specific libraries folder): i.e.: sites/all/libraries/blazy/blazy.min.js

Installing via Composer

• Run composer require --prefer-dist composer/installers to ensure that you have the composer/installers package installed. This package facilitates the installation of packages into directories other than /vendor (e.g. /libraries) using Composer.

• If your composer.json doesn’t already have a definition for the libraries path, define one similar to the one below, depending on your setup:

"extra": {
    "installer-paths": {
        "web/sites/all/libraries/{$name}": ["type:drupal-library"]
    }
}

• Add following to the “repositories” section of composer.json:

"repositories": [

    {
        "type": "package",
        "package": {
            "name": "dinbror/blazy",
            "version": "1.8.2",
            "type": "drupal-library",
            "extra": {
              "installer-name": "blazy"
            },
            "source": {
                "type": "git",
                "url": "https://github.com/dinbror/blazy",
                "reference": "1.8.2"
            }
        }
    }

]

• Install the required Blazy library: composer require 'dinbror/blazy:1.8.2'

• Install this module: composer require 'drupal/lazy:^1.0'

Usage

There are two options to set up for your site to lazy-load images. And both options share the same settings.

1. Image fields
2. Inline images and Iframes managed in rich-text fields (ckeditor)

Image Fields

1. Go to Manage display page of the entity type you want to enable lazy-loading. i.e. Article
2. Select the display you want the change. i.e. Teaser
3. Change the format from Image to Lazy-load image to enable lazy-loading for the selected field. The Image formatter settings for image style and link image to should remain unchanged.

Inline images and Iframes

1. Configure the text format you want to enable lazy-loading. i.e. Full HTML
2. Check Lazy-load images and IFRAMEs via bLazy option to enable the filter, and save configuration.
3. Go to Lazy-load settings.
4. Check the boxes for the inline elements to be lazy-loaded via filter <img> <iframe>
5. Save configuration

Repeat steps 1-2 for each text-format you want to enable lazy-loading.

To disable lazy-loading for specific image or iframes, add skip-class to the class attribute. Default value (no-b-lazy) can be changed in the configuration.

<img class="no-b-lazy" src="this-image-will-load-normal" alt="">

Blazy plugin can be manupulated in your theme/module javascript:

The options in Blazy configuration section of the settings form are the default options of the Blazy library. Refer to Blazy plugin documentation for each setting.

Get Blazy plugin options.

let opt = Drupal.settings.lazy ? Drupal.settings.lazy : {};

Access Blazy's public functions:

Function	Description
Drupal.lazy.revalidate();	Revalidates document for visible images. Useful if you add images with scripting or ajax
Drupal.lazy.load(element(s), force);	Forces the given element(s) to load if not collapsed. If you also want to load a collapsed/hidden elements you can add true as the second parameter. You can pass a single element or a list of elements. Tested with getElementById, getElementsByClassName, querySelectorAll, querySelector and jQuery selector.
Drupal.lazy.destroy();	Unbind events and resets image array

Use Case

If you have numerous images and/or iframes in your content, it could become a challenge to update that content to make compatible for lazy-loading. In most cases those updates needs to be handled manually, because most of the time if not all, the body content (HTML) doesn't follow a pattern to update them programmatically.

This is the main reason I created this module, to avoid a need for altering body content manually while making them easy to lazy-load.

The Lazy-load filter doesn't make any changes to existing content. It only rewrites the <img> and/or <iframe> tags in already rendered output to have them compatible for bLazy script to lazy-load. Since the filtered output is cached, there should not be any changes in performance.