Skip to content

[docs] Remove outdated references of .ttf and .woff#48399

Merged
ZeeshanTamboli merged 2 commits into
mui:masterfrom
oliviertassinari:update-font-references
May 4, 2026
Merged

[docs] Remove outdated references of .ttf and .woff#48399
ZeeshanTamboli merged 2 commits into
mui:masterfrom
oliviertassinari:update-font-references

Conversation

@oliviertassinari

@oliviertassinari oliviertassinari commented May 1, 2026

Copy link
Copy Markdown
Member

Seeing .ttf and .woff still mentioned in the docs feels very clearly: "this is a 2019 project stuck in the past". Aren't those web font formats now very outdated? https://web.dev/articles/font-best-practices#use_woff2

We need to be coherent with https://mui.com/material-ui/getting-started/supported-platforms/#browser. So, hence the fix (faster to make a PR than to create an issue 😁).

Preview: https://deploy-preview-48399--material-ui.netlify.app/material-ui/customization/typography/#self-hosted-fonts

A continuation of #48398

@oliviertassinari oliviertassinari added docs Improvements or additions to the documentation. type: regression A bug, but worse, it used to behave as expected. labels May 1, 2026
@oliviertassinari oliviertassinari changed the title [docs] Remove references of ttf and woff [docs] Remove outdated references of .ttf and .woff May 1, 2026
@code-infra-dashboard

code-infra-dashboard Bot commented May 1, 2026

Copy link
Copy Markdown

Deploy preview

Bundle size

Bundle Parsed size Gzip size
@mui/material 0B(0.00%) 0B(0.00%)
@mui/lab 0B(0.00%) 0B(0.00%)
@mui/private-theming 0B(0.00%) 0B(0.00%)
@mui/system 0B(0.00%) 0B(0.00%)
@mui/utils 0B(0.00%) 0B(0.00%)

Details of bundle changes


Check out the code infra dashboard for more information about this PR.

@ZeeshanTamboli ZeeshanTamboli left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we update this font-face style below to remove local:
src: local('Raleway'), local('Raleway-Regular'), url(${RalewayWoff2}) format('woff2');

Comment thread docs/data/material/customization/typography/typography.md Outdated
Co-authored-by: Albert Yu <albert@albertyu.co>
Signed-off-by: Olivier Tassinari <oliviertassinari@users.noreply.github.com>
@oliviertassinari

oliviertassinari commented May 2, 2026

Copy link
Copy Markdown
Member Author

Can we update this font-face style below to remove local:
src: local('Raleway'), local('Raleway-Regular'), url(${RalewayWoff2}) format('woff2');

@ZeeshanTamboli Why?

Those seems to work https://schalkneethling.com/posts/understanding-local-in-at-font-face-a-deep-dive/. A browser won't use a local font when declaring the font (@font-face), it only use the local font when referrencing one that is not declared.

The main problem with this seems that users might not have the "right" font installed under that name.

@ZeeshanTamboli

Copy link
Copy Markdown
Member

Can we update this font-face style below to remove local:
src: local('Raleway'), local('Raleway-Regular'), url(${RalewayWoff2}) format('woff2');

@ZeeshanTamboli Why?

Those seems to work https://schalkneethling.com/posts/understanding-local-in-at-font-face-a-deep-dive/. A browser won't use a local font when declaring the font (@font-face), it only use the local font when referrencing one that is not declared.

The main problem with this seems that users might not have the "right" font installed under that name.

I misunderstood. Thanks for the explanation!

@ZeeshanTamboli ZeeshanTamboli merged commit f3a0f59 into mui:master May 4, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to the documentation. type: regression A bug, but worse, it used to behave as expected.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants