Iced Font Awesome

iced_font_awesome is a simple and efficient widget for displaying Font Awesome icons in your Iced applications. Customize the size and color of your icons effortlessly.

Features

• Easy Integration: Quickly add Font Awesome icons to your Iced projects.
• Customizable: Set the size and color of icons to fit your design needs.

Getting Started

Installation

Add the following to your Cargo.toml:

[dependencies]
iced = "^0.14"
iced_font_awesome = "0.4.0"

Usage

Here's a basic example of how to use iced_font_awesome:

use iced::{color, widget::row, Task};
use iced_font_awesome::{fa_icon, fa_icon_brands, fa_icon_solid};

fn main() -> iced::Result {
    iced::application(Demo::new, Demo::update, Demo::view).run()
}

struct Demo {}

impl Demo {
    fn new() -> (Self, Task<()>) {
        (Self {}, Task::none())
    }

    fn update(&mut self, _message: ()) {}

    fn view(&self) -> iced::Element<'_, ()> {
        row!(
            fa_icon("circle-user").size(40.0).color(color!(0, 255, 0)),
            fa_icon_solid("medal")
                .size(50.0)
                .color(color!(249, 170, 51)),
            fa_icon_brands("google").size(60.0)
        )
        .align_y(iced::Alignment::Center)
        .padding(10)
        .spacing(10)
        .into()
    }
}

Result:

Customization

• Size: Adjust the size of the icon using the size method.
• Color: Set the color using the color method.

Icons Explorer

The Icons Explorer is a handy tool to browse and experiment with all available Font Awesome icons.

To run the Icons Explorer example, follow these steps:

1. Clone the repository:

git clone https://github.com/danielmbomfim/iced_font_awesome.git
cd iced_font_awesome

2. Run the example:

cargo run --example explorer

This will start the Explorer, allowing you to browse through the icons.

Font Awesome versions

This library defaults to Font Awesome 7. To use Font Awesome 6, enable the v6 feature and import the icons as follows:

use iced_font_awesome::v6::{fa_icon, fa_icon_brands, fa_icon_solid};

Map of iced version to required iced_font_awesome version.