如何在 material-ui 主题中导入和使用自定义字体？

Question

我正在尝试在 Material-UI 主题的 React 应用中导入和使用 Yellowtail 字体（来自 Google Fonts）。

据我所知，所有谷歌字体都在 npm 上，我已经安装了它，带有

npm install typeface-yellowtail --save

命令。

我已经在App.js中导入了，放到主题的font-family部分，把主题传给了MuiThemeProvider，但是还是不行。我错过了什么？

这就是我在 App.js 中的内容（标题包含一个带有一些网格的 AppBar，正文只包含一个用于测试的 h1 文本）

import React, { Component, Fragment } from 'react';
import Header from './Components/Layouts/Header';
import AppBody from './Components/Layouts/AppBody';
import Footer from './Components/Layouts/Footer'; 
import { MuiThemeProvider, createMuiTheme } from '@material-ui/core';
import 'typeface-yellowtail';

const theme = createMuiTheme({  
  typography: {
    fontFamily: 
      '"Yellowtail", cursive',
  },
});

class App extends Component {
  render() {
    return (
      <MuiThemeProvider theme={theme}>
        <Header />
        <AppBody />
        <Footer />       
      </MuiThemeProvider>
    );
  }
}

export default App;

Answer 1

您可以先加载 CSS 文件，而不是通过 npm 安装。

@import url('https://fonts.googleapis.com/css?family=Yellowtail&display=swap');

导入这个 CSS 文件

import './assets/css/yellowtail.css';

现在你不需要使用任何@font-face。这可以与正常的字体系列一起使用。

Answer 2

你错过了三件事：

• 导入npm包作为的东西
• 使用CssBaseline 组件
• 将override 添加到提供给createMuiTheme() 的对象中

查看示例：

import React, { Component, Fragment } from 'react';
import Header from './Components/Layouts/Header';
import AppBody from './Components/Layouts/AppBody';
import Footer from './Components/Layouts/Footer'; 
import { MuiThemeProvider, createMuiTheme, CssBaseline } from '@material-ui/core';
import yellowtail from 'typeface-yellowtail';

const theme = createMuiTheme({  
  typography: {
    fontFamily: 
      '"Yellowtail", cursive',
  },
  overrides: {
    MuiCssBaseline: {
      '@global': {
        '@font-face': [yellowtail],
      },
    },
  },
});

class App extends Component {
  render() {
    return (
      <MuiThemeProvider theme={theme}>
        <CssBaseline />
        <Header />
        <AppBody />
        <Footer />       
      </MuiThemeProvider>
    );
  }
}

export default App;

示例 CodeSandbox (MUI v3)：https://codesandbox.io/s/late-pond-gqql4?file=/index.js

示例 CodeSandbox (MUI v4)：https://codesandbox.io/s/pensive-monad-eqwlx?file=/index.js

注意事项

• 在从 Material-UI v3 到 v4 的过渡中，MuiThemeProvider 更改为 ThemeProvider。如果您使用的是 v4，这是唯一需要的更改 - 此示例代码在两个版本上都适用。

• 您必须在 Material-UI 的 Typography 组件中换行文本才能使用字体。

Answer 3

更新：由于提到了@ekkis，我正在添加有关如何包含 Google 字体的更多详细信息。以下答案假设您使用的是 Material UI v4.10.1

1. 安装gatsby-plugin-web-font-loader以安装谷歌字体。

2. 编辑 gatsby-config.js 以包含插件和 Google 字体。

module.exports = {
  plugins:      [
    {
      resolve: "gatsby-plugin-web-font-loader",
      options: {
        google: {
          families: ["Domine", "Work Sans", "Happy Monkey", "Merriweather", "Open Sans", "Lato", "Montserrat"]
        }
      }
    },
  ]
}

1. 要使用该字体，请在src/components 中创建一个名为theme.js 的文件

import {
  createMuiTheme,
  responsiveFontSizes
} from "@material-ui/core/styles"

let theme = createMuiTheme({
  typography: {
    fontFamily: [
                  "Work Sans",
                  "serif"
                ].join(","),
    fontSize:   18,
  }
})

// To use responsive font sizes, include the following line
theme     = responsiveFontSizes(theme)

export default theme

4. 现在您已经导出了theme，您可以在组件中使用它。

5. 将theme 导入到您的组件中。假设<Layout /> 是您的主要组件。

// src/components/layout.js

/**
 * External
 */
import React from "react"
import PropTypes from "prop-types"
import {
  ThemeProvider
} from "@material-ui/styles"
import { Typography } from "@material-ui/core"

/**
 * Internal
 */
import theme from "./theme"

const Layout = ({ children }) => {

  return (
    <>
      <ThemeProvider theme={theme}>
        <Typography variant="body1">Hello World!</Typography>
      </ThemeProvider>
    </>
  )
}

6. 要在其他组件中使用 Google 字体，只需使用

<Typography ...>Some Text</Typography> 

只要这些组件用作其父组件，这些组件就会继续使用 Google 字体。希望这会有所帮助。

---

旧答案：

将您的文本放在Typography 组件中，以反映您通过npm 安装的Google 字体

import { Typography } from "@material-ui/core"

假设您在<AppBody> 中有一些文本

<AppBody>
    Hello World!
</AppBody>

上面的文字现在应该改为

<AppBody>
    <Typography variant="body1">Hello World!</Typography>
</AppBody>

请参阅 Material UI docs 了解不同的变体。

Answer 4

有一种更简单的方法可以做到这一点，不需要.css 文件或安装任何额外的包。

如果您的字体可通过诸如Google Fonts 之类的 CDN 使用，则只需将其导入应用的根 HTML 文件：

<link
  href="https://fonts.googleapis.com/css2?family=Yellowtail&display=swap"
  rel="stylesheet"
/>

然后在 Material-UI 主题中添加一行：

const theme = createTheme({
  typography: { fontFamily: ["Yellowtail", "cursive"].join(",") }
});

Working codesandbox example with Material-UI v5.