material-design-icons README

The project's README from github.com/google/material-design-icons. As one markdown file: README.md.

Material Symbols / Material Icons

These are two different official icon sets from Google, using the same underlying designs. Material Symbols is the current set, introduced in April 2022, built on variable font technology. Material Icons is the classic set, but no longer updated. More details below.

The icons can be browsed in a more user-friendly way at https://fonts.google.com/icons. Use the popdown menu near top left to choose between the two sets; Material Symbols is the default.

The icons are designed under the material design guidelines.

Icon Requests

We’d love to support your icon needs! Please submit your request here on GitHub as an issue.

Please note that Google Fonts does not accept user submissions of finished icon designs! There are fairly strict guidelines for Material icons, plus Google has upstream source files from which this repo is generated. Therefore, Google does not accept pull requests for icon files (whether new icon suggestions, or fixes for existing icons). Concepts are appreciated—just don’t design SVGs and submit them via pull request.

However, users are perfectly welcome to point at outside files or images as examples—for the kind of thing they want, but they won’t just be taken “as is.” This works especially well if you have multiple examples for a single icon, to help us understand the “essence” of the idea.

For example, there is a fairly universal conceptual logo/icon for “agender,” so if you were proposing Google add an agender icon in the Material style, either mentioning that, or pointing at https://www.google.com/search?q=agender+icon would be a helpful tip.

Third-party logos

Currently, Google does not include 3rd-party logos among the Material Symbols or Material Icons due to legal reasons. Some 3rd-party logos that were included in the past have since been removed.

npm Packages

Google does not currently maintain the npm package for this repo, past v3 (2016). However, user @marella is hosting the following. He tells us these are automatically updated and published using GitHub Actions. Note: Google does not monitor or vet these packages.

material-symbols npm install size

material-icons npm install size Downloads

@material-design-icons/font npm (scoped) install size

@material-design-icons/svg npm (scoped) install size

Material Symbols

These newer icons can be browsed in a more user-friendly way at https://fonts.google.com/icons. Use the popdown menu near top left to choose between the two sets; Material Symbols is the default.

These icons were built/designed as variable fonts first (based on the 24 px designs from Material Icons). There are three separate Material Symbols variable fonts, which also have static icons available (but those do not have all the variations available, as that would be hundreds of styles):

Each of the fonts has these design axes, which can be varied in CSS, or in many more modern design apps:

The following directories in this repo contain specifically Material Symbols (not Material Icons) content:

What is currently not available in Material Symbols?

Material Icons

The icons can be browsed in a more user-friendly way at https://fonts.google.com/icons?icon.set=Material+Icons

These classic icons are available in five distinct styles:

The following directories in this repo contain specifically Material Icons (not Material Symbols) content:

What is currently not available in Material Icons?

Material Icons update history

4.0.0 Update

3.0.1 Update

3.0.0 Update

2.0

Getting Started

Read the developer guide on how to use the material design icons in your project.

Using a font

The font and variablefont folders contain pre-generated font files that can be included in a project. This is especially convenient for the web; however, it is generally better to link to the web font hosted on Google Fonts:

<link href="https://fonts.googleapis.com/css2?family=Material+Icons"
      rel="stylesheet">

<link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined"
      rel="stylesheet">

Read more on Material Symbols or Material Icons in the Google Fonts developer guide.

License

We have made these icons available for you to incorporate into your products under the Apache License Version 2.0. Feel free to remix and re-share these icons and documentation in your products. We'd love attribution in your app's about screen, but it's not required.

material-design-icons (google/material-design-icons)

Searching Database…

54.1K ·GitHub
Material-design-icons
Что это такое?Это официальный репозиторий Google с иконками Material Design, в котором два набора: Material Symbols (актуальный набор, который регулярно обновляется) и Material Icons (классический набор, который не обновляется с 2022 года).
Это шрифт, SVG-файлы или что-то другое?Всё вместе: готовые переменные шрифты (WOFF2), статические файлы иконок в SVG и PNG, а также спрайты. Они лежат в папках вроде 'symbols', 'variablefont', 'android', 'font', 'ios', 'png' и 'src'.
Как добавить эти иконки в мой проект?Для веба рекомендуется подключать веб-шрифт, размещённый на Google Fonts, а не хранить его у себя; в папках font/variablefont репозитория также есть файлы, которые можно подключить напрямую. Для сценариев на основе npm доступны пакеты, которые поддерживает сообщество: 'material-symbols', 'material-icons', '@material-design-icons/font' и '@material-design-icons/svg'.
Нужно ли что-то особенное, чтобы пользоваться этими иконками?Сам этот репозиторий не требует инструментов сборки; нужен только способ использовать шрифты, SVG или PNG: веб-страница, проект на Android или iOS либо менеджер пакетов npm.
Кто официально поддерживает пакеты npm?Google не поддерживает пакеты npm после версии v3 (2016 год). Текущие пакеты npm публикует и автоматически обновляет сторонний разработчик (@marella) через GitHub Actions, а Google их не проверяет и не контролирует.
В чём разница между Material Symbols и Material Icons?Material Symbols — более новый набор, построенный на переменных шрифтах: в CSS можно менять оси Optical Size, Weight, Grade и Fill. Material Icons — более старый набор с фиксированным стилем, в котором есть пять отдельных стилей (Outlined, Filled, Rounded, Sharp, Two tone), но нет гибкости переменных шрифтов и новых иконок с 2022 года.
Можно ли получить логотипы сторонних брендов в этом наборе иконок?Нет, Google по юридическим причинам не включает логотипы сторонних брендов в Material Symbols и Material Icons, а некоторые такие логотипы, которые были раньше, удалены.
Какие форматы файлов доступны?В зависимости от пакета можно получить переменные или статические шрифты WOFF2/WOFF, CSS, SVG (при необходимости оптимизированные с помощью SVGO), а также PNG и спрайты для Android и iOS.
Можно ли анимировать заливку иконок, чтобы показывать состояние выбора?Да, в Material Symbols ось Fill (0–100) можно менять в CSS, чтобы создать анимированную заливку, которая полезна для показа выбора пользователя. В старом наборе Material Icons так сделать нельзя.
What are similar projects?Font-Awesome, MaterialDesign, tabler-icons, heroicons, react-native-ui-kitten, mdb-ui-kit, simple-icons, fluentui-system-icons
Which topics is it in?svg-icons, icon-pack, material, fonts, ui-kit, font, icons, image, material-design, design-system, svg, graphics
Creator
google
Size
4.9 GB
Stars
54.1K
Updated
CommitOct 09Release4.0.0Aug 31
Age
12y
Commits · 90 Days