how to use Web APIs and embedded widgets to serve maps, videos, surveys, and other content from around the Web inside your own sites
Embedding is the process of including media from other sources into your web sites.
"other documents" can include:
- media files
- images, sound, video
- other HTML (pages or snippets)
- maps, graphs, charts
- search box e.g. Google custom search
"embedding" is sometimes also called "including" or "transcluding"
For instance, you could programmatically pause and play an embedded audio clip, say, playing "hoorah!" when the user wins a game of Tic-Tac-Toe.
Or, if the user moves their location on an embedded Google Map, your app could be notified and find the city name and look up restaurants in that area on Yelp's API.
<img src=''> is the original embed
Where does the media come from?
- Usually images are served from the same web server as HTML.
- Some web sites host images or other media for free or a small cost
- images: flickr.com, imgur.com, 500px.com, etc.
- video: YouTube.com, Vimeo.com, Wistia.com, etc.
- audio: SoundCloud.com, etc.
- a CDN hosts all sorts of media for you for $$$
- Amazon AWS / CloudFront, CloudFlare, Akamai...
<iframe> means "inline frame"
<iframe id="inlineFrameExample" title="Inline Frame Example" width="300" height="200" src="https://www.openstreetmap.org/export/embed.html?bbox=-0.004017949104309083%2C51.47612752641776%2C0.00030577182769775396%2C51.478569861898606&layer=mapnik"> </iframe>
Beware the "same origin policy":
Refused to display 'http://www.burlingtoncodeacademy.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'.
- some web servers (e.g. Wordpress) set these headers on by default
- other web servers (e.g. Apache) set these headers off by default
sandboxattribute limits what the loaded page can do
Embedding HTML snippets
You can use iframes to load the same HTML onto several pages on your site.
This is often used for login boxes.
Warning: iframes can take longer to load than the rest of the page, and can eat up CPU and RAM, so don't overuse them
"In July 2017, Adobe announced that it would declare Flash to be end-of-life in 2020, and will cease support, distribution, and security updates to Flash Player."
HTML5 defines a standard
<video>tag when you are hosting your own video media file (on your web server or a CDN)
video hosting sites like YouTube, and Vimeo have their own rules and sample code which you should find and copy into your HTML file
Tip: you can automatically start playing the video when the page loads; to be polite you should also mute the volume, like this:
<video muted=true autoplay=true src='/videos/yelling-man.mp4'>
HTML5 also has a prebuilt
<audio> tag that you can use to embed your local audio files into your web pages. There are several key attributes for audio elements.
srcLike with all other forms of media the
srcattribut tells your tag where the actual audio file lives
autoplayAccepts a boolean value, when set to
trueit will begin playback as soon as it can
controlsAdding this attribute with no value will display playback controls to the user
loopAnother boolean attribute that repeats the audio indefinitely when set to
mutedYet another boolean attribute. It mutes your audio when set to
let audio = new Audio('audio_file.mp3'); audio.play();
<iframe id="inlineFrameExample" title="Inline Frame Example" width="300" height="200" src="https://www.openstreetmap.org/export/embed.html?bbox=-73.2130900,44.4749000,-73.2102500,44.4772200&layer=mapnik"> </iframe>
OpenStreetMaps defines a "bounding box" as a four-tuple: min Longitude, min Latitude, max Longitude, max Latitude.
You can find the bounding box for a given map on https://www.openstreetmap.org/ by clicking the Export button.