Layering Text & Counters
Layers are the new way to place icons and text visually on top of each other using the power of SVG+JS, replacing our classic icons stacks. With this new approach, you can use more than two icons.
We’ll cover the basics of how to use custom CSS to get layered effects.
Layers are awesome when you don’t want your page’s background to show through, or when you do want to use multiple colors, layer several icons, layer text, or layer counters onto an icon. For clarity in the example, we’ve added a background color on the layers so you can see the effect.
Layering Element | How It Works |
---|---|
fa-layers | Wraps your stack of icons or text. You’ll likely want to also include an fa-fw class so your layers align. |
Inner icons | Add as many icons as you like directly inside your fa-layers element. Icons stack with the last icon on the top. |
fa-layers-text | Add inside your fa-layers element to put text on top of an icon. Combine with data-fa-transform for full control. |
fa-layers-counter | Adds a counter to the top right of your icons. Can be positioned with fa-layers-bottom-left , fa-layers-bottom-right , fa-layers-top-left and the default fa-layers-top-right . Overflow text is truncated with an ellipsis. |
Customizing
We’ve added CSS custom properties to make customizing easier and more efficient. Define your own values for the following properties to override and customize Font Awesome’s defaults.
CSS Custom Property | Details | Accepted Values |
---|---|---|
--fa-counter-background-color | Set fa-layers-counter ’s background color | Any valid CSS color value |
--fa-counter-border-radius | Set fa-layers-counter ’s border radius | Any valid CSS border-radius value |
--fa-counter-line-height | Set fa-layers-counter ’s line-height | Any valid CSS line-height value |
--fa-counter-max-width | Set fa-layers-counter ’s max-width | Any valid CSS width value |
--fa-counter-min-width | Set fa-layers-counter ’s min-width | Any valid CSS width value |
--fa-counter-padding | Set fa-layers-counter ’s padding | Any valid CSS padding value |
--fa-counter-scale | Set how much fa-layers-counter is scaled up/down | Any valid CSS transform scale value |
--fa-top | Set top offset of .fa-layers-top-left or layers-top-right | Any valid CSS top value |
--fa-right | Set right offset of .fa-layers-top-right or layers-bottom-right | Any valid CSS right value |
--fa-bottom | Set bottom offset of .fa-layers-bottom-left or layers-bottom-right | Any valid CSS bottom value |
--fa-left | Set left offset of .fa-layers-top-left or layers-bottom-left | Any valid CSS left value |
--fa-inverse | Set color of an inverted stacked icon | Any valid CSS color value |