MaterialDesignInXamlToolkit README

The project's README from github.com/MaterialDesignInXAML/MaterialDesignInXamlToolkit. As one markdown file: README.md.

Material Design In XAML Toolkit Logo of Material Design in XAML

NuGet-Themes NuGet-Colors

NuGet-Themes-CI NuGet-Colors-CI

Backers on Open Collective Sponsors on Open Collective Chat Issues

Comprehensive and easy to use Material Design theme and control library for the Windows desktop (WPF).

See screenshots

Table of contents

Getting started

[!NOTE] See the full starting guide for more in-depth information.

This quick guide assumes you have already created a WPF project and are using Microsoft Visual Studio 2022.

Install-Package MaterialDesignThemes

<Application 
  x:Class="Example.App"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:materialDesign="http://materialdesigninxaml.net/winfx/xaml/themes"
  StartupUri="MainWindow.xaml">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <materialDesign:BundledTheme BaseTheme="Light" PrimaryColor="DeepPurple" SecondaryColor="Lime" />

                <ResourceDictionary Source="pack://application:,,,/MaterialDesignThemes.Wpf;component/Themes/MaterialDesign2.Defaults.xaml" /> 
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

<Window [...]
  Style="{StaticResource MaterialDesignWindow}"
  [...] >

XML Namespaces

The toolkit exposes two XML namespaces for use in XAML:

Prefix URI Description
materialDesign http://materialdesigninxaml.net/winfx/xaml/themes Primary namespace for all public Material Design types, controls, and converters.
materialDesignInternal http://materialdesigninxaml.net/winfx/xaml/themes-internal Namespace for types in internal sub-namespaces (MaterialDesignThemes.Wpf.Internal, MaterialDesignThemes.Wpf.Converters.Internal, MaterialDesignThemes.Wpf.Behaviors.Internal).

[!WARNING] Types exposed via the materialDesignInternal namespace are considered internal implementation details and are not guaranteed to maintain backwards-compatibility between versions. Use them at your own risk.

To use the internal namespace in XAML:

<Window ...
  xmlns:materialDesignInternal="http://materialdesigninxaml.net/winfx/xaml/themes-internal">

Building the source

To build the project, following is required:

This repository also contains 3 different demo applications:

Screenshots

Material Design 3 demo app screenshots

Buttons Cards Chips Colortool Colorzones Comboboxes Datagrids Dialogs Drawer Elevation Expander Fields Fieldslineup Groupboxes Home Iconpack Lists Menustoolbars Navigationbar Navigationrail Pallete Pickers Progressindicators Ratingbar Slider Snackbar Toggles Tooltips Transitions Trees Typography

Material Design 2 demo app screenshots

[!WARNING] The screenshots below are taken from the Material Design 2 demo app. Material Design 3 is the latest version, so the UI shown here may differ from the latest design.

Screenshot of WPF Material Design 2 demo application home page Buttons Toggles Fields ComboBoxes Palette Color Tools Pickers Icons Cards Menus and Toolbars Progress Bars Dialogs Lists Tree View Sliders Chips Typography Group Box Snackbars Elevation Colorzones Datagrids Drawer Expander Fieldslineup Navigationrail NumericUpDown Ratingbar Tabs Tooltips Transitions

More examples

FAQ

Contributing

Before contributing code read the Contribution Guidelines

Want to say thanks? 🙏🏻

This project exists thanks to all the people who contribute.

Mentions

Backers

Thank you to all our backers! 🙏 Become a backer.

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor.

MaterialDesignInXamlToolkit (MaterialDesignInXAML/MaterialDesignInXamlToolkit)

Searching Database…

16.3K ·GitHub
MaterialDesignInXamlToolkit
Что это такое?Материальный дизайн от Google в применении к WPF: open-source тема и библиотека элементов управления для настольных приложений Windows на C# или VB.Net. Она меняет оформление всех основных элементов WPF и добавляет дополнительные элементы в духе Material Design.
Так это приложение, которое я устанавливаю, или то, что я подключаю к своему проекту?Это библиотека, а не приложение: вы подключаете её к существующему WPF-проекту, и она применяет оформление Material Design к элементам, которые вы уже используете, а также добавляет несколько своих.
Как добавить её в WPF-проект?Установите набор через менеджер NuGet-пакетов в Visual Studio или из командной строки, затем измените App.xaml (и MainWindow.xaml) по инструкции из руководства по началу работы. Чтобы использовать Material Design 3, подключите MaterialDesign3.Defaults.xaml.
Что должно быть установлено перед началом работы?WPF-проект и Visual Studio 2022. Если хотите собрать исходный код набора самостоятельно, дополнительно понадобится набор компонентов «Разработка классических приложений .NET».
Поддержка Material Design 3 уже полностью готова?Целевой MD3 уже доступен через MaterialDesign3.Defaults.xaml, но специальное демо-приложение для него ещё в разработке — полное справочное демо со всеми элементами остаётся демо для Material Design 2.
Это только для Windows или подойдёт и для приложений на Mac и Linux?Только для Windows — библиотека рассчитана на WPF, фреймворк для настольных приложений Windows, поэтому macOS и Linux не поддерживаются.
Какие дополнительные элементы появляются помимо оформленных элементов WPF?Cards, Dialogs, Clock и Multi Action Button, а также полный набор иконок Material Design Icons и удобные эффекты переходов.
Можно ли менять цветовую схему во время работы приложения?Да — палитру легко настроить как на этапе разработки, так и во время выполнения, в соответствии с рекомендациями Google по Material Design.
Уживается ли она с другими библиотеками интерфейсов для WPF?Да — она совместима с Dragablz и MahApps, а в репозитории даже есть демо, объединяющее все три. Внутри библиотека построена на ControlzEx.
Можно ли посмотреть, как выглядят элементы, прежде чем брать библиотеку в проект?Да — в исходном проекте есть демо-приложения: MaterialDesignDemo (оформление Material Design 2, все элементы, рекомендуемый инструмент при разработке) и MaterialDesign3Demo для более нового оформления.
What are similar projects?materialize, MudBlazor, Avalonia, uno, material-components-android, MaterialDrawer, folding-cell, vuetify
Which topics is it in?hacktoberfest2020, xaml, visual-studio, material, wpf, c-sharp, icons, ui-library, material-design, theme, dotnet, c#
Creator
MaterialDesignInXAML
Size
79.1 MB
Stars
16.3K
Updated
CommitOct 16Releasev5.3.2May 01
Age
11y
Commits · 90 Days