qt-material-widgets/README.md

7.4 KiB

I've been using Qt for a while, the lack of UI framework is a big problem for me.

After building UI components from scratch for a while, I decided to try reusing other's projects, that is no piece of cake.

I found qt-material-widgets, but sadly it seems to be no longer supported.

Pull requests from other developer, such as move to cmake which inspired me on migrating this project from qmake to CMake, are not accepted anymore.

I'm very honored to try to take over the maintenance of this project, and welcome all pull requests and issues.

Overview

The original project only supports the qmake build system on Linux platform.

The new project will support both qmake and CMake on as many platforms as possible, mainly Windows, Android ,Linux and MacOS.

Usage

1. clone this project

2. create your widgets app

Create Qt Widgets Application with CMake project as normal

3. modify CMakeLists.txt of your app

First, add component as subdirectory of your project

add_subdirectory(/path/to/qt-material-widgets/components/ ./components)

I'm not sure if these two line is really needed, you can add them when you count error

set(CMAKE_INCLUDE_CURRENT_DIR ON) # I'm not sure if it is really needed
set(CMAKE_EXPORT_COMPILE_COMMANDS ON) # I'm not sure if it is really needed

then, add include and link libraries:

  • add /path/to/qt-material-widgets/include/qmeterial/ into target_include_directories for headers
  • add components into target_link_libraries for .lib

Now you can use qt-material-widgets, all components list as follows:

Qt Material Design Desktop Widgets Language Join the chat at https://gitter.im/qt-material-widgets/Lobby

YouTube video preview available here.

App Bar QtMaterialAppBar
Auto Complete QtMaterialAutoComplete
Avatar QtMaterialAvatar
Badge QtMaterialBadge
Check Box QtMaterialCheckBox
Circular Progress QtMaterialCircularProgress
Dialog QtMaterialDialog
Drawer QtMaterialDrawer
FAB QtMaterialFloatingActionButton
Flat Button QtMaterialFlatButton
Icon Button QtMaterialIconButton
Progress QtMaterialProgress
Radio Button QtMaterialRadioButton
Raised Button QtMaterialRaisedButton
Scroll Bar QtMaterialScrollBar
Slider QtMaterialSlider
Snackbar QtMaterialSnackBar
Tabs QtMaterialTabs
Text Field QtMaterialTextField
Toggle QtMaterialToggle

Implemented components

  • App Bar
  • Auto Complete
  • Avatar
  • Badge
  • Check Box
  • Circular Progress
  • Dialog
  • Drawer
  • Floating Action Button
  • Flat Button
  • Icon Button
  • Progress
  • Radio Button
  • Raised Button
  • Scroll Bar
  • Slider
  • Snackbar
  • Tabs
  • Text Field
  • Toggle

Work in progress

  • Divider
  • List
  • List Item
  • Menu
  • Paper
  • Snackbar Layout
  • Table

Not implemented

  • Card
  • Chips
  • Discrete Slider
  • Grid List
  • Icon Menu
  • Search Field
  • Select Field
  • Stepper
  • Subheaders
  • Toolbar