7.4 KiB
Upgrading Guide
See the CHANGELOG.md for detailed information about what has changed between versions.
This guide is useful to figure out what you need to do between breaking changes.
As always, submit issues that you run into with this guide or with these upgrades to us.
5.4.x to 5.5.0
There are no breaking changes in this version upgrade.
5.4.0 to 5.4.1
Categories were renamed from:
- Holiday to Halloween
- Seasonal to Autumn
The "wand" icon in version 5.4.0 matched the "wand-magic" icon. The magical sparkles have been removed for "wand". If you were relying on this decoration in your design switch to "wand-magic" to bring the magic back.
5.3.x to 5.4.0
There are no breaking changes in this version upgrade.
5.3.0 to 5.3.1
The following Pro-only icons were removed from Font Awesome Free as of 5.3.1:
- abacus
- calculator-alt
- empty-set
- function
- integral
- intersection
- lambda
- omega
- pi
- sigma
- signal-alt
- signal-alt-slash
- signal-slash
- square-root
- tally
- theta
- tilde
- union
- value-absolute
- volume
- volume-down
- volume-slash
- wifi-slash
These icons were unintentionally included in 5.3.0.
5.x.x to 5.3.0
Sass mixin syntax has been updated to address a bug.
Use @extend %fa-icon to correctly maintain CSS order in output files.
Old way:
.twitter {
@include fa-icon; /* incorrect */
@extend .fab;
&:before {
content: fa-content($fa-var-twitter);
}
}
New way:
.twitter {
@extend %fa-icon; /* correct */
@extend .fab;
&:before {
content: fa-content($fa-var-twitter);
}
}
5.1.x to 5.2.x
There are no breaking changes in this version upgrade.
5.1.0 to 5.1.1
Less and Sass files incorrectly contained the "fa-" prefix for style files. These files have been renamed to be consistent with other files in the packages.
If you are using the Less or Sass file styles individually you will need to correct the names in your builds.
| Old filename | New filename |
|---|---|
| less/fa-solid.less | less/solid.less |
| less/fa-regular.less | less/regular.less |
| less/fa-light.less | less/light.less |
| less/fa-brands.less | less/brands.less |
| scss/fa-solid.scss | scss/solid.scss |
| scss/fa-regular.scss | scss/regular.scss |
| scss/fa-light.scss | scss/light.scss |
| scss/fa-brands.scss | scss/brands.scss |
5.0.x to 5.1.0
New packages available for browser-only integration
If you were previously using @fortawesome/fontawesome you need to switch to one of the new packages.
Our Free and Pro CDN provide access to JS, CSS, sprites, and separate SVG files.
We've now made these files conveniently available through NPM.
- @fortawesome/fontawesome-free
- @fortawesome/fontawesome-pro (private package, requires Pro subscription)
If you are familiar with the paths and options available with the CDN these packages should be familiar.
Information about Font Awesome Pro subscriptions can be found in your Font Awesome awesome account.
Renamed packages
The following packages have been renamed as part of 5.1.0 of Font Awesome.
All packages are in the @fortawesome NPM scope
| Old package(1) | New package |
|---|---|
| fontawesome-free-webfonts | fontawesome-free |
| fontawesome-pro-webfonts | fontawesome-pro |
| fontawesome-free-solid | free-solid-svg-icons |
| fontawesome-free-regular | free-regular-svg-icons |
| fontawesome-free-brands | free-brands-svg-icons |
| fontawesome-pro-solid | pro-solid-svg-icons |
| fontawesome-pro-regular | pro-regular-svg-icons |
| fontawesome-pro-light | pro-light-svg-icons |
(1) Old packages have now been deprecated. They are still available but will only receive high priority patch release fixes.
You'll need to update your package.json file with the renamed packages and new versions.
No more default imports
Recently we spent a good deal of time supporting TypeScript to enable us to
create the Angular Font Awesome component. During that adventure we
were
convinced
that we were going to remove default exports from all of our components,
libraries, and packages. This is complete with the umbrella release of 5.1.0 of Font Awesome.
What does that mean?
Old way:
import fontawesome from '@fortawesome/fontawesome'
import solid from '@fortawesome/fontawesome-free-solid'
import faTwitter from '@fortawesome/fontawesome-free-brands/faTwitter'
import FontAwesomeIcon from '@fortawesome/vue-fontawesome'
library.add(solid, faTwitter)
New way:
import { library, dom } from '@fortawesome/fontawesome-svg-core'
import { fas } from '@fortawesome/free-solid-svg-icons'
import { faTwitter } from '@fortawesome/free-brands-svg-icons'
import { FontAwesomeIcon } from '@fortawesome/vue-fontawesome'
library.add(fas, faTwitter)
// Kicks off the process of finding <i> tags and replacing with <svg>
dom.watch()
This is also a valid way to import icons that works if your tool does not support tree shaking:
import { faTwitter } from '@fortawesome/free-brands-svg-icons/faTwitter'
Improved support for tree shaking
Tree shaking is now functional by default and no additional configuration is required to make it work.
The shakable.es.js module has been removed and is no longer needed.
If you've previously configured tree shaking by modifying your webpack or rollup you can safely remove these.
We recommend that you check your bundle size after upgrading an ensure that file sizes are as you would expect.
module.exports = {
// ...
resolve: {
alias: {
'@fortawesome/fontawesome-free-solid$': '@fortawesome/fontawesome-free-solid/shakable.es.js'
}
}
}
const alias = require('rollup-plugin-alias')
rollup({
// ...
plugins: [
alias({
'@fortawesome/fontawesome-free-solid': 'node_modules/@fortawesome/fontawesome-free-solid/shakable.es.js'
})
]
})
5.0.11 to 5.0.12
Due to a collision with the "r" glyph the R Project brand icon has been renamed to r-project.
5.0.x to 5.0.6
SVG Attribute was changed from data-fa-processed to data-fa-i2svg
As part of a bug fix for the release of 5.0.6 we renamed an attribute that was found on <svg> elements from
data-fa-processed to data-fa-i2svg. We feel this more accurately reflects the intent and purpose.
This attribute is added to any icon that has been generated using fontawesome.dom.i2svg().
Be aware that data-fa-i2svg (or data-fa-processed) will no longer be present on icons that are created using
fontawesome.icon().
If you've written and DOM queries that rely on data-fa-processed you should get things working again by doing a
simple find and replace.