1.0.8 • Published 6 years ago
react-native-dynamic-font v1.0.8
react-native-dynamic-font
Getting started
$ npm install react-native-dynamic-font --save
Mostly automatic installation
$ react-native link react-native-dynamic-font
Manual installation
iOS
- In XCode, in the project navigator, right click
Libraries➜Add Files to [your project's name] - Go to
node_modules➜react-native-dynamic-fontand addReactNativeDynamicFont.xcodeproj - In XCode, in the project navigator, select your project. Add
libReactNativeDynamicFont.ato your project'sBuild Phases➜Link Binary With Libraries - Run your project (
Cmd+R)<
Android
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.ashrithks.dynamicfont.ReactNativeDynamicFontPackage;to the imports at the top of the file - Add
new ReactNativeDynamicFontPackage()to the list returned by thegetPackages()method
- Append the following lines to
android/settings.gradle:include ':react-native-dynamic-font' project(':react-native-dynamic-font').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-dynamic-font/android') - Insert the following lines inside the dependencies block in
android/app/build.gradle:compile project(':react-native-dynamic-font')
Example of how to use
To load a font dynamically, you must first have a base64 string of your font file (TTF or OTF):
import { loadFont, loadFonts } from 'react-native-dynamic-font';
...
/* Load a single font */
loadFont('nameOfFont', base64FontString, 'ttf').then(function(name) {
console.log('Loaded font successfully. Font name is: ', name);
});
/* Load a list of fonts */
loadFonts([{name: 'nameOfFont', data: base64FontString, type: 'ttf'}]).then(function(names) {
console.log('Loaded all fonts successfully. Font names are: ', names);
});
...Font loading using file path
You can download font file to file system and then load it to app without sending base64 to bridge.
import {loadFontFromFile} from 'react-native-dynamic-font';
import RNFetchBlob from 'rn-fetch-blob'
const fontFilePath = RNFetchBlob.fs.dirs.DocumentDir + "fonts/roboto.ttf";
loadFontFromFile("Roboto", fontFilePath)
.then(function(name) {
console.log('Loaded font successfully. Font name is: ', name);
});Options
| option | iOS | Android | Info |
|---|---|---|---|
| name | Not used | Used | Specify registered font name (doesn't work for iOS) |
| data | Used | Used | This can be a data URI or raw base64... if it is raw base64 type must be specified, but defaults to TTF (data URI mime: font/ttf or font/otf) |
| type | Used | Used | (optional) Specify the type of font in the encoded data (ttf or otf). Defaults to "ttf" |
The Response
The ACTUAL name the font was registered with. Use this for your fontFamily.