If you copy paste the lines here into CKEditor, be sure to view CKEditor
source and remove the surrounding <code>...</code>
,
in case mistakenly copied over.
Image or iframe is lazyloaded automatically unless
disabled, no shortcodes required. Usages for shortcodes: grid, customizing
settings, embedding a known entity. Pay attention to attributes,
slashes, colons, single and double quotes:
[blazy]...[item]...[/item]...
[/blazy]
[blazy]
is like field container,
[item]
like field item.data=ENTITY_TYPE:ID:FIELD_NAME:FIELD_IMAGE
, without inline
HTML: [blazy data="node:44:field_media" /]
[blazy data="node:44:field_media:field_media_image" /]
ENTITY_TYPE:ID:FIELD_NAME
, where
ENTITY_TYPE
is node -- only tested with node,
ID
is node ID, FIELD_NAME
can be field Media,
Image, Text (long or with summary), must be multi-value, or unlimited. FIELD_IMAGE
named
field_media_image
as found at Media Image/ Video for hires poster
image, must be similar and single-value field image for all media entities
to have mixed media correctly. This is not field image at Node, it is at
Media.BlazyDefault
methods as seen at Filter, Field or Views UI
forms:[blazy settings="{'style': 'column', 'grid': 4}" /]
[item]
can have class and caption attributes, e.g.: [item class="grid--card card"
caption='Read <a href="https://mysite.com">more</a>']
. grid__content
to make it usable
such as for Bootstrap well/ card. The caption into regular
blazy__caption
. STYLE:SMALL-MEDIUM-LARGE
. STYLE
is one of space-delimited values: column grid
flex nativegrid
.LARGE
with
nativegrid
, no others, can be numeric, or string. The rest must
be numbers due to using no JS and or their contracts. The minimum is 1,
not 0.[blazy grid="column:2-3-4" /]
[blazy grid="grid:2-3-4" /]
[blazy grid="flex:2-3-4" /]
[blazy grid="nativegrid:2-3-4" /]
, will be masonry[blazy grid="nativegrid:2-3-4x4" /]
, will repeat[blazy grid="nativegrid:2-3-4x4 4x3 2x2 2x4 2x2 2x3 2x3 4x2 4x2" /]
[blazy settings="{
'style': 'nativegrid',
'grid_small': 2,
'grid_medium': 3,
'grid': '4x4 ...'
}" /]
4x4
defines WIDTHxHEIGHT
based on
grid-row
CSS property, see and override
blazy/css/blazy.nativegrid.css
.
data-unblazy
:
<img data-unblazy />
<iframe data-unblazy />
[DEPRECATED], cannot co-exist: To build a grid of images/
videos, add attribute data-grid
or data-column
(only to the first item):
<img data-grid="1 3 4" />
<iframe data-column="1 3 4" />
The numbers represent the amount of grids/ columns for small, medium and large devices respectively, space delimited. Be aware! All media items will be grouped regardless of their placements. That's why deprecated.
Tips, if any issues:
[blazy]
shortcode. It is only
useful for grid, or customizing settings, or embedding a known entity.data, settings
can be put together into one
[blazy]
.data
attribute, be sure
grid items are stacked, separated by line breaks, or any relevant HTML tags,
and wrapped each with [item]
:
[blazy]
[item]
<IMG>
[/item]
[item]
<IFRAME>
[/item]
[item]
<p>Any non-media HTML
content</p>
[/item]
[/blazy]
IMG/ IFRAME
, or other HTML as item contents can be wrapped with
any relevant tags, no problem.