|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108 |
- [icons-nuget]: https://www.nuget.org/packages/Material.Icons/
- [wpf-nuget]: https://www.nuget.org/packages/Material.Icons.WPF/
- [avalonia-nuget]: https://www.nuget.org/packages/Material.Icons.Avalonia/
-
- # Material.Icons
- Parsed icons set from [materialdesignicons.com](https://materialdesignicons.com/) and display control implementations for different GUI frameworks.
- - All icons are **always up-to-date** because automatically updated every 6 hours.
- - **Small package size** because icons are graphically encoded via SVG Path.
- - Icon types are **strongly typed** enum, so your **IDE will suggest available variants**:
- ![895428ad-6010-4ffd-bd88-61aecd50f5e1](https://user-images.githubusercontent.com/29896317/213889827-ca4f7673-115a-433e-9fde-305d55d36772.gif)
-
- ## Structure
- This project consists of 3 parts:
- - [![](https://img.shields.io/nuget/dt/Material.Icons?label=Material.Icons&style=flat-square)](#meta) contains info about the icons
- - [![](https://img.shields.io/nuget/dt/Material.Icons.Avalonia?color=blue&label=Material.Icons.Avalonia&style=flat-square)](#avalonia) contains controls for **AvaloniaUI**
- - [![](https://img.shields.io/nuget/dt/Material.Icons.WPF?color=blue&label=Material.Icons.WPF&style=flat-square)](#wpf) contains controls for **WPF**
-
-
- - [FAQ](#faq) - frequently asked questions
-
- ## Avalonia
- #### Getting started
- 1. Install [Material.Icons.Avalonia nuget package](https://www.nuget.org/packages/Material.Icons.Avalonia/):
- ```shell
- dotnet add package Material.Icons.Avalonia
- ```
- [![avalonia-nuget](https://img.shields.io/nuget/v/Material.Icons.Avalonia?label=Material.Icons.Avalonia&style=flat-square)][avalonia-nuget]
- [![avalonia-nuget](https://img.shields.io/nuget/dt/Material.Icons.Avalonia?color=blue&label=Downloads&style=flat-square)][avalonia-nuget]
- 2. Include styles in `App.xaml` (for `2.0.0` version and higher):
- ```xaml
- <Application xmlns:materialIcons="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia"
- ...>
- <Application.Styles>
- ...
- <materialIcons:MaterialIconStyles />
- </Application.Styles>
- </Application>
- ```
- For `1.*.*`:
- ```xaml
- <Application ...>
- <Application.Styles>
- ...
- <StyleInclude Source="avares://Material.Icons.Avalonia/App.xaml" />
- </Application.Styles>
- </Application>
- ```
- #### Using
- Add `Material.Icons.Avalonia` namespace to the root element of your file (your IDE can suggest it or do it automatically):
- ```
- xmlns:materialIcons="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia"
- ```
- Use `MaterialIcon` control:
- ```xaml
- <materialIcons:MaterialIcon Kind="Abacus" />
- ```
- The `Foreground` property controls the color of the icon.
- Also, there is `MaterialIconExt` which allows you to use is as the markup extension:
- ```xaml
- <Button Content="{materialIcons:MaterialIconExt Kind=Abacus}" />
- ```
-
-
- ## WPF
- #### Getting started
- Install [Material.Icons.WPF nuget package](https://www.nuget.org/packages/Material.Icons.WPF/):
- ```shell
- dotnet add package Material.Icons.WPF
- ```
- [![wpf-nuget](https://img.shields.io/nuget/v/Material.Icons.WPF?label=Material.Icons.WPF&style=flat-square)][wpf-nuget]
- [![wpf-nuget](https://img.shields.io/nuget/dt/Material.Icons.WPF?color=blue&label=Downloads&style=flat-square)][wpf-nuget]
- #### Using
- Add `Material.Icons.WPF` namespace to the root element of your file (your IDE can suggest it or do it automatically):
- ```
- xmlns:materialIcons="clr-namespace:Material.Icons.WPF;assembly=Material.Icons.WPF"
- ```
- Use `MaterialIcon` control:
- ```xaml
- <materialIcons:MaterialIcon Kind="Abacus" />
- ```
- The `Foreground` property controls the color of the icon.
- Also, there is `MaterialIconExt` which allows you to use is as the markup extension:
- ```xaml
- <Button Content="{materialIcons:MaterialIconExt Kind=Abacus}" />
- ```
-
-
- ## Meta
- #### Getting started
- Install [Material.Icons nuget package](https://www.nuget.org/packages/Material.Icons/):
- ```shell
- dotnet add package Material.Icons
- ```
- [![icons-nuget](https://img.shields.io/nuget/v/Material.Icons?label=Material.Icons&style=flat-square)][icons-nuget]
- [![icons-nuget](https://img.shields.io/nuget/dt/Material.Icons?color=blue&label=Downloads&style=flat-square)][icons-nuget]
- #### Using
- Icon types stored in `Material.Icons.MaterialIconKind` enum.
- We can resolve an icon path by using `Material.Icons.MaterialIconDataProvider.GetData()`.
-
- ## FAQ
- #### How to change icon color?
- - Change `Foreground` property.
- #### How to update icons?
- - You can manually set `Material.Icons` package version in your project file.
- #### What about versioning policy?
- - We use semver.
- Any package with identical major and minor versions is compatible.
- For example, `1.0.0` and `1.0.1` are compatible, but `1.0.0` and `1.1.0` might not be.
|