Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add "Little Things to Know" section to the docs #604

Open
manzt opened this issue Jun 7, 2024 · 0 comments
Open

Add "Little Things to Know" section to the docs #604

manzt opened this issue Jun 7, 2024 · 0 comments

Comments

@manzt
Copy link
Owner

manzt commented Jun 7, 2024

Thanks @koaning for the idea. There are just some little things to know when actually using widgets, especially the ipywidgets/traitlets ecosystem, which without documentation could lead to a "meh" overall experience with anywidget.

It would be nice to have an FAQ-style list of tips to steer folks into the pit of success with Jupyter Widgets.

Example:

widget = MyWidget()
widget.observe(on_change)
widget

very rarely is a blanket observe what you want, since multiple traitlet changes will occur per user expected "change", causing the callback to fire multiple times and glitching.

It's better to specify names and filter which changes you actually care about:

widget = MyWidget()
-- widget.observe(on_change)
++ widget.observe(on_change, names=["value"])
widget
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant