Comments (11)
In this case, documentation has not been a focus of ours yet, since the project is very experimental and the APIs have been changing wildly as we figure out the best way to approach GUIs in Rust.
I see.
For some time I have been involved in the "Lazarus" project (which is an open source version of the commercial "Delphi" software which features an extremely convenient way of doing GUI projects with a native compiled langauge). Hence I supposedly am spoiled in my attitude about GUI handling. After deciding to do all new projects in Rust I amoung other things evaluate the GUI crates and seemingly (regarding the great impression I got from the core of the Rust world) this is more bleeding edge than I expected. So thanks for baering with me.
Maybe come time, I might even be able to conrtibute something sensible :)
from iced.
@hecrj
Hmm.
I do "have a problem with the library", as I can't use part of it.
Of course I am aware that this is not a problem of the software, but of the documentation.
But why should that not be discussed on GitHub, where Documentation and examples are hosted / maintained together with the source code ? (Both is just text, and both is equally necessary for usage, after all. And of course both needs appropriate maintenance / user feedback for a crate to flourish. )
IMHO it would be best to have an appropriately "speaking" category "I have a problem with the library documentation" besides the "I have a problem with the library (code) ".
Many thanks for your attention (and making this crate happen) !
from iced.
I also had this problem.
I tried to implement a custom widget and return an overlay element in the widget's overlay method.
But nothing happened.
The code is roughly like this (where ...
omits some code):
impl<...> Widget<...> for MyWidget {
// ...
fn overlay(...) -> ... {
Some(Menu::new(...).overlay(...))
}
}
from iced.
I did not yet understand the concept of "overlay". And I only understand a small gimps of the "theme" stuff.
Moreover it seems to be possible and/or necessary to use multiple renderers ?!?!?
from iced.
There's a ready to use context_menu widget in iced_aw: https://github.com/iced-rs/iced_aw/tree/main/examples/context_menu
The menu in iced_widget is the dropdown part of the picklist, that's why there's no example using it alone.
from iced.
THIS does look promising ....
from iced.
This isn't a bug. Please, read the available options when creating a new issue carefully next time:
Feel free to ask for help in our Discord server or our Discourse forum.
from iced.
I do "have a problem with the library", as I can't use part of it.
Of course I am aware that this is not a problem of the software, but of the documentation.
You are aware and decided to file a bug report anyways. A bit passive-aggresive, isn't it? Isn't this behavior suggesting that either you don't care or, even though you just arrived here, you think you know better than me how I should be managing my own project?
But why should that not be discussed on GitHub
Because the author of the project (the person that you are writing the bug report to, is giving you the software for free, and ultimately addresses everyone's feedback) explicitly and literally asks you to.
IMHO it would be best to have an appropriately "speaking" category "I have a problem with the library documentation" besides the "I have a problem with the library (code) ".
What would be "best" doesn't matter. What matters is how the maintainers of the software you use for free want you to interact with them. I don't want to receive "bug reports" about documentation on GitHub when there are clearly other channels set up to ask for help and discuss these topics.
Many thanks for your attention (and making this crate happen) !
You are welcome! I appreciate it.
from iced.
@mschnell1 As Héctor pointed out, you're welcome to ask questions and discuss things in Discourse or Discord, they exist exactly for this purpose, which is nice because that way github doesn't get too crowded with general questions, which would make the triage of actual bugs very difficult.
I do "have a problem with the library", as I can't use part of it.
Perhaps there's still some misunderstanding, as I mentioned, the 'menu' that appears in iced_widget is just part of the picklist widget, it's not something to be used by itself. For context menus there's the iced_aw widget.
from iced.
" For context menus there's the iced_aw widget."
Yep. Happily in this discussion I have been pointed to same and of course I will try to make use of same ASAP. I did a lot of research and have not been able to find the appropriate "entry point" before. Maybe over there is a better place to discuss the "menu's" documentation / example / findability issues.
Sorry, if I have been perceived as rude, stating that for me documentation is an integral part of any software. Maybe this is just me.
In fact I did quite a lot of (rather small) open source software projects (here on GitHub on the "ReaTeam" repository), and always try to do sufficient documentation, and improve the documentation (if I see a shortcoming or on request) together with the source code.
Thanks to all trying to improve the rust GUI world, which - as I seem to see - right now is one of the most "critical" areas of the fantastically evolving Rust world.
from iced.
@mschnell1 No worries! Every project works differently and has different priorities. Software or open-source doesn't ought to work in any particular way.
As Rich Hickey once wrote in "Open Source is Not About You":
The only people entitled to say how open source 'ought' to work are people who run projects, and the scope of their entitlement extends only to their own projects.
In this case, documentation has not been a focus of ours yet, since the project is very experimental and the APIs have been changing wildly as we figure out the best way to approach GUIs in Rust. But even if we just simply did not want to write any documentation, that would be fine as well!
from iced.
Related Issues (20)
- Stack widget layout issue
- image::Handle::from_rgba not working
- MouseArea: enter and exit does not work inside a scrollable if the cursor is not moved
- `on_scroll` is not fired when scrolling via operations
- bug/missing-docs: manual wgpu integration using `iced-runtime` not handling any keyboard/mouse events. HOT 1
- wgpu integration example fails to build in release mode HOT 3
- Unable to Use style(..) method in text_input with latest Iced component API HOT 3
- Unable to register on_open event for combo box
- Font defaulting to default font when bolded HOT 1
- Example does not run (Windows 11) HOT 2
- Slow startup on Linux due to font loading of **all** the system fonts in `/usr/share/fonts` HOT 4
- TOFU characters while rendering unicode string HOT 1
- High CPU usage after 0.12 when leaving key pressed HOT 2
- Unresolved imports, version: 0.12.1, Os: Windows HOT 1
- Panic with widget::text_editor when pressing multiple key at the same time. HOT 1
- nix shell in DEPENDENCIES.md does not work with wayland
- Dynamic Buttons in version 0.12 HOT 1
- The button cannot display Chinese HOT 4
- Examples just exit after 341c9a3 HOT 2
- Graphical bug in Skia version on text fields when updating the value.
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from iced.