@ampproject/amp-fit-text
Advanced tools
Expands or shrinks its font size to fit the content within the space given to it. Use Bento Fit Text as a web component <bento-fit-text>, or a Preact/React functional component <BentoFitText>.
The Bento Fit Text component allows you to manage the size and fit of text within a specified area. For content contained in a Bento Fit Text component, it determines the best font size to fit all of the content within the available space. The expected content for Bento Fit Text is text or other inline content, but it can also contain non-inline content.
You must include each Bento component's required CSS library to guarantee proper loading and before adding custom styles. Or use the light-weight pre-upgrade styles available inline. See Layout and style.
The examples below demonstrate use of the <bento-fit-text> web component.
[example preview="top-frame" playground="false"]
Install via npm:
npm install @ampproject/bento-fit-text
import '@ampproject/bento-fit-text';
[/example]
<script>[example preview="top-frame" playground="false"]
<head>
<script src="https://cdn.ampproject.org/custom-elements-polyfill.js"></script>
<!-- These styles prevent Cumulative Layout Shift on the unupgraded custom element -->
<script async custom-element="bento-fit-text" src="https://cdn.ampproject.org/v0/bento-fit-text-1.0.js"></script>
<style data-bento-boilerplate>
bento-fit-text {
display: block;
overflow: hidden;
position: relative;
}
</style>
</head>
<bento-fit-text id="my-fit-text">
Lorem ipsum dolor sit amet, has nisl nihil convenire et, vim at aeque
inermis reprehendunt.
</bento-fit-text>
<div class="buttons" style="margin-top: 8px;">
<button id="font-button">Change max-font-size</button>
<button id="content-button">Change content</button>
</div>
<script>
(async () => {
const fitText = document.querySelector('#my-fit-text');
await customElements.whenDefined('bento-fit-text');
// set up button actions
document.querySelector('#font-button').onclick = () => fitText.setAttribute('max-font-size', '40');
document.querySelector('#content-button').onclick = () => fitText.textContent = 'new content';
})();
</script>
[/example]
If the content of the bento-fit-text overflows the available space, even with a
min-font-size specified, the overflowing content is cut off and hidden. WebKit and Blink-based browsers show ellipsis for overflowing content.
In the following example, we specified a min-font-size of 40, and added more content inside the bento-fit-text element. This causes the content to exceed the size of its fixed block parent, so the text is truncated to fit the container.
[example preview="inline" playground="true" imports="bento-fit-text:1.0"]
<div style="width: 300px; height: 300px; background: #005AF0; color: #FFF;">
<bento-fit-text min-font-size="40">
Lorem ipsum dolor sit amet, has nisl nihil convenire et, vim at aeque
inermis reprehendunt. Lorem ipsum dolor sit amet, has nisl nihil convenire
et, vim at aeque inermis reprehendunt
</bento-fit-text>
</div>
[/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/amp-fit-text-1.0.css">
Alternatively, you may also make the light-weight pre-upgrade styles available inline:
<style data-bento-boilerplate>
bento-fit-text {
display: block;
overflow: hidden;
position: relative;
}
</style>
Container type
The bento-fit-text 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-fit-text {
height: 100px;
width: 100%;
}
While overflowing content is visually truncated to fit the container, note that it's still present in the document. Do not rely on the overflow behaviour to simply "stuff" large amounts of content in your pages - while visually it may look appropriate, it may lead to the page becoming overly verbose to users of assistive technologies (such as screen readers), as for these users all the truncated content will still be read/announced in full.
The attributes for <bento-fit-text> can be configured to use different
options based on a media query.
min-font-sizeSpecifies the minimum font size in pixels as an integer that the bento-fit-text can use.
max-font-sizeSpecifies the maximum font size in pixels as an integer that the bento-fit-text can use.
The examples below demonstrate use of the <BentoFitText> as a functional component usable with the Preact or React libraries.
[example preview="top-frame" playground="false"]
Install via npm:
npm install @ampproject/bento-fit-text
import React from 'react';
import {BentoFitText} from '@ampproject/bento-fit-text/react';
import '@ampproject/bento-fit-text/styles.css';
function App() {
return (
<BentoFitText>
Lorem ipsum dolor sit amet, has nisl nihil convenire et, vim at aeque
inermis reprehendunt.
</BentoFitText>
);
}
[/example]
Container type
The BentoFitText 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:
<BentoFitText style={{width: 300, height: 100}}>
Lorem ipsum dolor sit amet, has nisl nihil convenire et, vim at aeque
inermis reprehendunt.
</BentoFitText>
Or via className:
<BentoFitText className="custom-styles">
Lorem ipsum dolor sit amet, has nisl nihil convenire et, vim at aeque
inermis reprehendunt.
</BentoFitText>
.custom-styles {
height: 100px;
width: 100%;
}
minFontSizeSpecifies the minimum font size in pixels as an integer that the bento-fit-text can use.
maxFontSizeSpecifies the maximum font size in pixels as an integer that the bento-fit-text can use.
FAQs
AMP HTML amp-fit-text Component
The npm package @ampproject/amp-fit-text receives a total of 76 weekly downloads. As such, @ampproject/amp-fit-text popularity was classified as not popular.
We found that @ampproject/amp-fit-text 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
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.