@ampproject/amp-instagram
Advanced tools
Readme
The Bento Instagram component allows you embed an Instagram post. It can be used as a web component <bento-instagram>, or as a Preact/React functional component <BentoInstagram>.
You must include each Bento component's required CSS library before adding custom styles in order to guarantee proper loading. Or use the lightweight pre-uprgrade styles available inline. See Layout and Style.
The examples below demonstrate use of the <bento-instagram> web component.
[example preview="top-frame" playground="false"]
Install via npm:
npm install @ampproject/bento-instagram
import '@ampproject/bento-instagram';
[/example]
<script>[example preview="top-frame" playground="false"]
<head>
<script async custom-element="bento-instagram" src="https://cdn.ampproject.org/v0/bento-instagram-1.0.js"></script>
<style data-bento-boilerplate>
bento-instagram {
display: block;
overflow: hidden;
position: relative;
}
</style>
</head>
<bento-instagram
id="my-instagram"
data-shortcode="CKXYAzuj7TE"
data-captioned>
</bento-instagram>
<button id="change-shortcode">Change shortcode</button>
</div>
<script>
(async () => {
const instagram = document.querySelector('#my-instagram');
await customElements.whenDefined('bento-instagram');
// set up button actions
document.querySelector('#change-shortcode').onclick = () => instagram.dataset.shortcode = '1totVhIFXl';
})();
</script>
[/example]
Each Bento component has a small CSS library you must include to guarantee proper loading without content shifts. Because of order-based specificity, you must manually ensure that stylesheets are included before any custom styles.
<link rel="stylesheet" type="text/css" href="https://cdn.ampproject.org/v0/bento-instagram-1.0.css">
Alternatively, you may also make the light-weight pre-upgrade styles available inline:
<style data-bento-boilerplate>
bento-instagram {
display: block;
overflow: hidden;
position: relative;
}
</style>
Container type
The bento-instagram component has a defined layout size type. To ensure the component renders correctly, be sure to apply a size to the component and its immediate children (slides) via a desired CSS layout (such as one defined with height, width, aspect-ratio, or other such properties):
bento-instagram {
height: 500px;
width: 100px;
}
data-shortcodeThe instagram data-shortcode is found in every instagram photo URL. For example, in https://instagram.com/p/fBwFP, fBwFP is the data-shortcode.
data-captionedInclude the Instagram caption. bento-instagram will attempt to resize to the correct height including the caption.
You may use the bento-instagram element selector to style the component.
The examples below demonstrates use of the <BentoInstagram> as a functional component usable with the Preact or React libraries.
[example preview="top-frame" playground="false"]
Install via npm:
npm install @ampproject/bento-instagram
import React from 'react';
import { BentoInstagram } from '@ampproject/bento-instagram/react';
import '@ampproject/bento-instagram/styles.css';
function App() {
return (
<BentoInstagram
shortcode="CKXYAzuj7TE"
captioned
/>
);
}
[/example]
Container type
The BentoInstagram component has a defined layout size type. To ensure the component renders correctly, be sure to apply a size to the component and its immediate children (slides) via a desired CSS layout (such as one defined with height, width, aspect-ratio, or other such properties). These can be applied inline:
<BentoInstagram style={{width: '300px', height: '200px'}} shortcode="CKXYAzuj7TE">
</BentoInstagram>
Or via className:
<BentoInstagram className='custom-styles' shortcode="CKXYAzuj7TE">
</BentoInstagram>
.custom-styles {
height: 100px;
width: 100%;
}
shortcodeThe instagram shortcode is found in every instagram photo URL. For example, in https://instagram.com/p/fBwFP, fBwFP is the shortcode.
captionedInclude the Instagram caption. bento-instagram will attempt to resize to the correct height including the caption.
FAQs
AMP HTML amp-instagram Component
The npm package @ampproject/amp-instagram receives a total of 2 weekly downloads. As such, @ampproject/amp-instagram popularity was classified as not popular.
We found that @ampproject/amp-instagram demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 16 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.