Skip to content

Repository files navigation

blur image

tests types module install size gzip size dependencies semantic versioning Common Changelog license


Use the blur-up technique with images, as a web component.

This depends on having some inline base64 code for a small, blurry image. See @substrate-system/stringify for help with that.

Contents

Install

npm i -S @substrate-system/blur-image

Demonstration

See a demonstration here: substrate-system.github.io/blur-image.

Tip

Throttle the internet speed with the dev tools.

Use

Import this module, then use the tag in your HTML. It should work with all contemporary image attributes.

Bundler

Just import the module; it will call the global customElements.define function. Also, import the styles.

import '@substrate-system/blur-image'
import '@substrate-system/blur-image/css'

Then use the tag in your HTML:

<body>
    <blur-image
        src="/100.jpg"
        placeholder="data:image/jpeg;base64,/9j/2wBDAAYEBQY..."
    ></blur-image>
</body>

HTML

This package includes minified CSS and JS files, suitable for linking to directly from your HTML.

First make sure the files are accessible by your web server:

cp ./node_modules/@bicycle-codes/blur-image/dist/index.min.js ./public/blur-image.js
cp ./node_modules/@bicycle-codes/blur-image/dist/style.min.css ./public/blur-image.css

Then link to it in your HTML:

<head>
    <!-- include the style -->
    <link rel="stylesheet" href="/blur-image.css">
</head>

<body>
    <blur-image
        src="/100.jpg"
        placeholder="data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQY..."
    ></blur-image>

    <!-- include the JS -->
    <script src="./blur-image.js"></script>
</body>

Develop

Start a local dev server:

npm start

See Also

About

Blur-up image component

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages