font_awesome_flutter 8.8.1 font_awesome_flutter: ^8.8.1 copied to clipboard
The Font Awesome Icon pack available as Flutter Icons. Provides 1500 additional icons to use in your apps.
font_awesome_flutter #
The Font Awesome Icon pack available as set of Flutter Icons.
Based on Font Awesome 5.13. Includes all free icons:
- Regular
- Solid
- Brands
Installation #
In the dependencies:
section of your pubspec.yaml
, add the following line:
dependencies:
font_awesome_flutter: <latest_version>
Usage #
import 'package:font_awesome_flutter/font_awesome_flutter.dart';
class MyWidget extends StatelessWidget {
Widget build(BuildContext context) {
return IconButton(
// Use the FaIcon Widget + FontAwesomeIcons class for the IconData
icon: FaIcon(FontAwesomeIcons.gamepad),
onPressed: () { print("Pressed"); }
);
}
}
Example #
View the Flutter app in the example
directory to see all the available FontAwesomeIcons
.
FAQ #
Why aren't the icons aligned properly or why are the icons being cut off? #
Please use the FaIcon
widget provided by the library instead of the Icon
widget provided by Flutter. The Icon
widget assumes all icons are square, but
many Font Awesome Icons are not.
Why aren't the icons showing up on Mobile devices? #
If you're not seeing any icons at all, sometimes it means that Flutter has a cached version of the app on device and hasn't pushed the new fonts. I've run into that as well a few times...
Please try:
- Stopping the app
- Running
flutter clean
in your app directory - Deleting the app from your simulator / emulator / device
- Rebuild & Deploy the app.
Why aren't the icons showing up on Web? #
Most likely, the fonts were not correctly added to the FontManifest.json
.
Note: older versions of Flutter did not properly package non-Material fonts
in the FontManifest.json
during the build step, but that issue has been
resolved and this shouldn't be much of a problem these days.
Please ensure you are using Flutter 1.14.6 beta
or newer!
How can I use pro icons? #
This library only packages the free Font Awesome icon fonts. If you own the pro icon fonts and want to use them with Flutter, please follow these instructions.
❗ By importing pro icons you acknowledge that it is your obligation to keep these files private. This includes not uploading your package to a public github repository or other public file sharing services.
- Download this package's newest release, extract the folder and move it to a location of your choice
- Remove
#
s frompubspec.yaml
at the indicated position - run
flutter packages get
- Download your font awesome pro icons (web version)
- Move all
.ttf
files from thewebfonts
directory to this package's lib/fonts (replace existing fonts) - Move
icons.json
frommetadata
to this directory - Run
./tool/update.sh
- Add version
>= 4.7.0
to your project's dependencies, Override it with the path to your local installation
dependencies:
font_awesome_flutter: '>= 4.7.0'
...
dependency_overrides:
font_awesome_flutter:
path: /path/to/your/font_awesome_flutter
...
Duotone icons #
Duotone icons require special treatment. Instead of FaIcon
a special class
FaDuotoneIcon
needs to be used. It allows to set the primary and secondary colors
for the icon. If primary and / or secondary color are not defined, they will default
to the standard IconTheme
color.
FaDuotoneIcon(
FontAwesomeIcons.abacus,
primaryColor: Colors.black.withOpacity(.4),
secondaryColor: Colors.black,
);
Contributors #
- Brian Egan
- Phil Plante
- Michael Spiss