Iframely embeds cloud JavaScript library, helps with rich media embed codes rendering for Iframely hosted iFrames. Library functions include unfurling URLs, lazy-loading, and rich-media events handling.
npm install @iframely/embed.jsEmbed.js script is a part of Iframely cloud service for rich media embeds and works only with Iframely-hosted iFrame helpers. The script is normally hosted on Iframely's CDN and is included when required into HTML codes that our API returns. If you wish to self-host the script rather than rely on our CDN, we make the script available here on GitHub and on NPM.
The script's main function is to adjust height of rich media with variable sizes (say, Twitter, Facebook or Iframely summary cards) and to handle other messages received from Iframely iFrames. The script also enables lazy-loading through intersection observer (including video placeholders), unfurls URLs if you use Iframely without making API requests first, and uses web component imports to speed-up bulk inserts of rich media.
Read more about the script itself at iframely.com/docs/embedjs. The description below focuses solely on self-hosting of the script.
To serve embed.js script from your network, your reverse proxy needs to be configured to point embed.js file to its location on the local disc.
* dist/embed.js - not minified development version
* dist/embed.min.js - minified production version
You can either clone repo from GitHub, or pull library from NPM as @iframely/embed.js. We recommend creating a symlink to a file first for a simpler reverse proxy config.
Alternatively, you may include the contents of embed.js into your other JavaScript distributions. Include src/index.js main script or entire "@iframely/embed.js" module in your own build configuration to pull all dependencides.
The HTML embed codes you get from Iframely APIs will include the cloud copy of embed.js by default (as