README

此模块在管理员设置中的“主题选项”标签下添加了一个字体选择器。它自带3种字体，由Google Fonts提供，但还可以添加更多字体。

使用方法

添加额外字体

要添加额外字体，只需将“SiteConfig”下的“theme_fonts”字段设置为以下内容

SilverStripe\SiteConfig\SiteConfig:
  theme_fonts:
    metropolis: Metropolis
    nunito-sans: Nunito Sans
    fira-sans: Fira Sans
    merriweather: Merriweather

请注意，任何在Google Fonts中不可用的字体将不会在字体选择器中的预览中显示。

更改默认字体

要设置默认字体，只需将“SiteConfig”下的“default_font”字段设置为以下内容

SilverStripe\Fontpicker\Forms\FontPickerField:
  default_font: metropolis

在自己的主题中使用

首先，请确保在您的模板中有一个HTML class，该class表示主题变体给CSS。以下是一个默认实现，您也将在Bambusa和Watea主题中找到。

<body class="$ClassName <% if $SiteConfig.MainFontFamily %>theme-font-{$SiteConfig.MainFontFamily}<% end_if %>">

现在，您可以在CSS中手动生成颜色变体（类名后缀），或者您可以在Bambusa或Watea主题的src/scss文件夹中查找如何使用SCSS中的@mixin来自动实现。

版本控制

此库遵循Semver。根据Semver，您将能够升级到该库的任何次要或补丁版本，而无需对公共API进行任何破坏性更改。Semver还要求我们明确定义此库的公共API。

所有具有public可见性的方法都是公共API的一部分。所有其他方法都不是公共API的一部分。尽可能保持protected方法在次要/补丁版本中的向后兼容性，但如果您正在覆盖方法，请在升级之前测试您的工作。

silverstripe / theme-fontpicker

维护者

详细信息