5.15.4-alpha.12 • Published 14 days ago

@react-native-vector-icons/fontawesome5 v5.15.4-alpha.12

Weekly downloads
-
License
MIT
Repository
github
Last release
14 days ago

FontAwesome 5

Table of Content

Usage

Using the standard icons works just like the standard icons in this library.

import FontAwesome5 from 'react-native-vector-icons/FontAwesome5';

const icon = <FontAwesome5 name={'comments'} />;

Something special about the FontAwesome5 class is that you can also pass props to change the style of the icon:

import FontAwesome5 from 'react-native-vector-icons/FontAwesome5';

const icon = <FontAwesome5 name={'comments'} solid />;
const icon = <FontAwesome5 name={'git'} brand />;

Valid types

TypeDescription
brandUses the Brands font
lightUses the Light font (pro) or Regular (Free)
solidUses the Solid font

No specified type indicates Regular font.

getImageSource

getImageSource works a little different due to its native backend and how the font is separated into different files. Therefore, the enum FA5Style is defined to help setting the style of the font:

const FA5Style = {
  regular: 0,
  light: 1,
  solid: 2,
  brand: 3,
};

Use this to select which style the generated image should have:

import FontAwesome5, { FA5Style } from 'react-native-vector-icons/FontAwesome5';

FontAwesome5.getImageSource('comments', 30, '#000', FA5Style.solid).then(
  (source) => this.setState({ image: source })
);

Not passing a style will result in Regular style.

Upgrading to Pro

Use the @react-native-vector-icons/fontawesome5-pro package instead.