Skip to content

README.md

Latest commit

 

History

History
162 lines (90 loc) · 3.98 KB

README.md

File metadata and controls

162 lines (90 loc) · 3.98 KB
Raw

Iced - Additional Widgets

Disclaimer: This crate is part of a study project of mine. Please wait for your contributions until March 2021. Thank you very much!

This crate contains additional widgets for the GUI library Iced.

Every widget is hidden by a feature gate. This allows you to cherry pick the widgets you actually need.

Usage:

Include iced_aw as a dependency in your Cargo.toml:

[dependencies]
iced =  { git = "https://github.com/hecrj/iced", rev = "ea1a7248d257c7c9e4a1f3989e68b58a6bc0c4ff" }
iced_aw = { git = "https://github.com/kaiden42/iced_aw", default-features = false, features = [...] }

Why not Crates.io?

This crate is currently based on top of the master branch of Iced. Crates.io refuses crates that uses git repositories as their dependencies. Once Iced becomes stable, iced_aw will be published on Crates.io as well.

Widgets

Currently planned widgets are:

  • Badge
  • Floating Action Button
  • Card
  • Modal
  • Date Picker
  • Time Picker
  • Color Picker

Badge

TODO

Badge concept drawing

Badge showcase

Please take a look into our examples on how to use badges.

Enable this widget with the feature badge. To enable predefined styles, enable the feature colors.

TabBar and Tabs

TODO

Tabs showcase

Please take a look into our examples on how to use TabBars and Tabs.

Enable TabBars with the feature tab_bar and Tabs with tabs.

Floating Action Button

TODO

Floating Action button concept drawing

Floating Button showcase

Please take a look into our examples on how to use floating buttons.

Enable this widget with the feature floating_button. To enable predefined styles for buttons, enable the feature colors.

Card

TODO

Card concept drawing

Card showcase

Please take a look into our examples on how to use cards.

Enable this widget with the feature card. To enable predefined styles, enable the feature colors.

Modal

TODO Modals are usefull for showing some content as an overlay on top. In combination with the Card widget, modals can be used to create some kind of dialog panels.

Modal concept drawing

Modal showcase

Please take a look into our examples on how to use modals.

Enable this widget with the feature modal. To enable predefined styles, enable the feature colors.

Date Picker

TODO

Date Picker concept drawing

Time Picker

TODO

Time Picker concept drawing

Color Picker

TODO

Color Picker concept drawing

Quickstart features

Quickstart features are pretty handy to start and experiment having everything like colors or icons available. Nevertheless, it is recommended to disable these features once the GUI is ready for production and to only include the things you really need.

Color palette

This crate add a predefined color palette based on the CSS color palette.

Enable colors with the feature colors.

Bootstrap icons

Thanks to Bootstrap, iced_aw now contains ~1,200 icons to be used in an Iced GUI.

Enable icons with the feature icons.

Note: the icon font with ~1,200 weights around 0.5 MB. This features should only be used for experimenting with all the icons.