1 files changed, 14 insertions, 8 deletions
diff --git a/web/src/widget/button.rs b/web/src/widget/button.rs
index 6afcaee3..cd450b55 100644
--- a/web/src/widget/button.rs
+++ b/web/src/widget/button.rs
@@ -21,19 +21,25 @@ use dodrio::bumpalo;
 ///     .on_press(Message::ButtonPressed);
 /// ```
 ///
-/// Buttons can be disabled by not having an on_press.
+/// If a [`Button::on_press`] handler is not set, the resulting [`Button`] will
+/// be disabled:
 ///
 /// ```
 /// # use iced_web::{button, Button, Text};
 /// #
-/// # enum Message {
-/// #     ButtonPressed,
-/// # }
-/// #
-/// let mut state = button::State::new();
-/// let disabled_button = Button::<Message>::new(&mut state, Text::new("I'm disabled!"));
+/// #[derive(Clone)]
+/// enum Message {
+///     ButtonPressed,
+/// }
+///
+/// fn disabled_button(state: &mut button::State) -> Button<'_, Message> {
+///     Button::new(state, Text::new("I'm disabled!"))
+/// }
+///
+/// fn enabled_button(state: &mut button::State) -> Button<'_, Message> {
+///     disabled_button(state).on_press(Message::ButtonPressed)
+/// }
 /// ```
-
 #[allow(missing_debug_implementations)]
 pub struct Button<'a, Message> {
     content: Element<'a, Message>,