Laravel Google Fonts 项目使用教程
1. 项目的目录结构及介绍
Laravel Google Fonts 项目的目录结构如下:
laravel-google-fonts/
├── config/
│ └── google-fonts.php
├── resources/
│ └── views/
│ └── layouts/
│ └── app.blade.php
├── src/
│ ├── GoogleFonts.php
│ ├── GoogleFontsServiceProvider.php
│ └── ...
├── tests/
│ └── ...
├── composer.json
├── README.md
└── ...
目录结构介绍
config/
: 包含项目的配置文件。resources/views/layouts/
: 包含 Blade 模板文件。src/
: 包含项目的主要源代码文件。tests/
: 包含项目的测试文件。composer.json
: Composer 依赖管理文件。README.md
: 项目说明文档。
2. 项目的启动文件介绍
项目的启动文件主要包括 GoogleFontsServiceProvider.php
和 GoogleFonts.php
。
GoogleFontsServiceProvider.php
该文件位于 src/
目录下,是 Laravel 服务提供者,负责注册和启动 Google Fonts 服务。
namespace Spatie\GoogleFonts;
use Illuminate\Support\ServiceProvider;
class GoogleFontsServiceProvider extends ServiceProvider
{
public function boot()
{
$this->publishes([
__DIR__.'/../config/google-fonts.php' => config_path('google-fonts.php'),
], 'config');
}
public function register()
{
$this->mergeConfigFrom(__DIR__.'/../config/google-fonts.php', 'google-fonts');
}
}
GoogleFonts.php
该文件位于 src/
目录下,是 Google Fonts 的主要逻辑处理类。
namespace Spatie\GoogleFonts;
class GoogleFonts
{
// 主要逻辑处理代码
}
3. 项目的配置文件介绍
项目的配置文件为 config/google-fonts.php
。
config/google-fonts.php
该文件定义了 Google Fonts 的配置信息,包括默认字体和代码字体的 URL。
return [
'fonts' => [
'default' => 'https://fonts.googleapis.com/css2?family=Inter:ital,wght@0,400;0,700;1,400;1,700&display=swap',
'code' => 'https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:ital,wght@0,400;0,700;1,400&display=swap',
],
];
使用方法
在 Blade 模板中使用 @googlefonts
指令加载字体:
<head>
{{-- 加载 Inter 字体 --}}
@googlefonts
{{-- 加载 IBM Plex Mono 字体 --}}
@googlefonts('code')
</head>
当字体首次被请求时,该包会从 Google 的服务器抓取 CSS 和字体资源,并将其存储在本地,然后内联渲染 CSS。如果过程中出现任何问题,包会回退到使用 <link>
标签从 Google 加载字体。