expo xml font

expo-xml-font

使用此Expo插件轻松使用Android XML字体。

该插件可在https://github.com/jsamr/reaeact-native-font-demo上构建一个很棒的指南，介绍了如何在React Native中使用XML字体，但提供了易于使用的API，因此您不必手动使用本机文件。

安装

笔记

V3用于50世纪<= = V2用于Expo 49> =

1. 安装插件

 # using yarn
yarn add expo-xml-font

# using npm
npm install expo-xml-font

2. 将插件添加到app.json或app.config.js文件的plugins部分：

{
  "plugins" : [ " expo-xml-font " ]
}

用法

此示例将以Inter为例，但您可以使用自己喜欢的任何字体。

1. 获取您的字体及其所有变体

 Inter-Thin.ttf (100)
Inter-ExtraLight.ttf (200)
Inter-Light.ttf (300)
Inter-Regular.ttf (400)
Inter-Medium.ttf (500)
Inter-Semibold.ttf (600)
Inter-Bold.ttf (700)
Inter-Extrabold.ttf (800)
Inter-Black.ttf (900)

2. 将所有破折号（“ - ” S）更改为下划线（“ _”），并将所有大写字母更改为小写字母。这是必须与Android的资产名称限制兼容

 inter_thin.ttf (100)
inter_extraLight.ttf (200)
inter_light.ttf (300)
inter_regular.ttf (400)
inter_medium.ttf (500)
inter_semibold.ttf (600)
inter_bold.ttf (700)
inter_extrabold.ttf (800)
inter_black.ttf (900)

3. 将这些文件复制到项目所在的文件夹。例如，您可以将字体文件放在assets/fonts夹中。

4. 在您的app.json或app.config.js中配置expo-xml-font ：

{
  "plugins" : [
    [
      " expo-xml-font " ,
      [
        {
          "name" : " Inter " ,
          "folder" : " assets/fonts " ,
          "variants" : [
            { "fontFile" : " inter_thin " , "fontWeight" : 100 },
            { "fontFile" : " inter_extralight " , "fontWeight" : 200 },
            { "fontFile" : " inter_light " , "fontWeight" : 300 },
            { "fontFile" : " inter_regular " , "fontWeight" : 400 },
            { "fontFile" : " inter_medium " , "fontWeight" : 500 },
            { "fontFile" : " inter_semibold " , "fontWeight" : 600 },
            { "fontFile" : " inter_bold " , "fontWeight" : 700 },
            { "fontFile" : " inter_extrabold " , "fontWeight" : 800 },
            { "fontFile" : " inter_black " , "fontWeight" : 900 }
          ]
        }
      ]
    ]
  ]
}

5. 运行expo prebuild生成XML字体。您现在可以在代码中使用它们！

配置

使用expo-xml-font时，您需要传递提供字体所有详细信息的对象。

 type Options = {
  /**
   * Name of font
   * @example "Inter"
   */
  name : string ;
  /**
   * Path of folder which contains font files. It's alright if the path is relative.
   * @example "assets/fonts"
   */
  folder : string ;
  variants : {
    /**
     * Font file for font. Do NOT include the extension.
     * @example "inter_regular.ttf" -> "inter_regular"
     */
    fontFile : string ;
    /** The font weight of the provided font file */
    fontWeight : 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 ;
    /**
     * Specifies whether or not the font file is italic
     * @default false
     */
    italic ?: boolean ;
  } [ ] ;
} [ ] ;

由于此插件带有一系列字体，因此您可以根据需要指定任意数量的字体系列。