@flyyer/use-googlefonts
v0.4.2
Published
React hook to dynamically load Google Fonts v2 during execution.
Downloads
1,452
Readme
@flyyer/use-googlefonts
React hook to load Google Fonts v2 when you can't define a priori the expected font on the <head />.
If you know what specific font you require on your project you should omit this library and insert the <link /> tags directly in the <head /> of your HTML via react-helmet or next/head if you are using Next.js.
We made this hook for Flyyer.io to enable developers to create templates with fonts on the fly to match each user preferred font styling. Those tempates are used to create social and marketing images.
Usage
Install this dependency:
yarn add @flyyer/use-googlefontsCommon case usage:
import React from "react";
import { useGoogleFonts, GoogleFontsStatus } from "@flyyer/use-googlefonts";
function App() {
const font = useGoogleFonts([
{
family: "Cabin", // Family Name
styles: [
"600..700", // Range, if family supports it.
"100..200italic", // Range with italic
"300italic", // Weight with italic
"regular", // Shortcut to 400
"italic", // Shortcut to 400 Italic
"500", // Regular with weight
444, // Regular weight for variable font
],
},
{
family: "Roboto", // Family Name - Roboto doesn't support ranges
styles: [
"300italic", // Weight with italic
"regular", // Shortcut to 400
"italic", // Shortcut to 400 Italic
"500",
100,
],
},
]);
if (font.status === GoogleFontsStatus.FAILED) {
console.log(font.error);
} else {
console.log(font.href);
// https://fonts.googleapis.com/css2?family=Cabin:ital,wght@0,400;0,444;0,500;0,600..700;1,100..200;1,300;1,400;1,600..700&family=Roboto:ital,wght@0,100;0,400;0,500;1,300;1,400&display=auto
}
return (
// Use .flyyer-wait class to prevent premature renders while the font is still loading.
<div className={googleFont.status === GoogleFontsStatus.LOADING && "flyyer-wait"}>
<p style={{ fontFamily: "'Cabin', sans-serif" }}>
Almost before we knew it, we had left the ground.
</p>
</div>
);
}To improve performance and speed it is recommended to add the following pre-connection tags in the <head /> of your HTML.
This is done automatically if you are using @flyyer/cli so skip this section if you created your deck with create-flyyer-app
<html>
<head>
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="preconnect" href="https://fonts.googleapis.com" crossorigin>
</head>
<body>
...
</body>
</html>