-
Notifications
You must be signed in to change notification settings - Fork 954
Open
Labels
Description
References:
- https://fontawesome.com/changelog
- https://docs.fontawesome.com/upgrade/upgrade-from-older-versions
- Previous upgrade:
Depends on:
When migrating from FA6 → FA7 (draft notes):
Icons are fixed-width by default
- In v7 every icon renders at a fixed width (the “Icon Canvas”).
- The old
fa-fwutility is removed. If you were using it, you now get that behavior automatically. - If you need the old variable (auto) width, add
fa-width-auto. (What's Changed in v7)<!-- v6 style (now unnecessary) --> <i class="fa-solid fa-user fa-fw"></i> <!-- v7 default is fixed width; for auto width do this: --> <i class="fa-solid fa-user fa-width-auto"></i>
Sass/SCSS breaking changes
- Move to Dart Sass and
@use(no more@import). - The
fa-prefix was removed from variables, mixins, and functions; you now reference them via thefanamespace, e.g.$fa-font-path→fa.$font-path. - Legacy mixins like
fa-icon-*andfa-family-*were removed; use the new per-styleicon()mixins. _fixed-widthpartial renamed to_fa-widths.sr-only/sr-only-focusableclasses were removed (roll your own if you still need them).- “Bordered” and “pulled” styles split into separate partials (bordered icons are slated for deprecation in a future release). (Upgrade to v7 with Sass)
References