diff options
author | Johannes Dahlström <johannesd@vaadin.com> | 2016-07-19 14:57:05 +0300 |
---|---|---|
committer | Artur Signell <artur@vaadin.com> | 2016-08-05 10:19:45 +0300 |
commit | 69f703100ed57720672467e6e53319781cb8ebc9 (patch) | |
tree | 0af17e22a90e7891f296caf74426df008e7533b4 /documentation | |
parent | befaa39cc0637028688f4bfb5d7f6e824ea9a1af (diff) | |
download | vaadin-framework-69f703100ed57720672467e6e53319781cb8ebc9.tar.gz vaadin-framework-69f703100ed57720672467e6e53319781cb8ebc9.zip |
BoV: Components/Button,CheckBox: Listener API updates
Change-Id: I266bf780d24e411b17d449ff5f9ce880fad53d36
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/components/components-button.asciidoc | 22 | ||||
-rw-r--r-- | documentation/components/components-checkbox.asciidoc | 14 |
2 files changed, 13 insertions, 23 deletions
diff --git a/documentation/components/components-button.asciidoc b/documentation/components/components-button.asciidoc index 9105aa5e9b..fdd6cf594f 100644 --- a/documentation/components/components-button.asciidoc +++ b/documentation/components/components-button.asciidoc @@ -15,8 +15,8 @@ endif::web[] The [classname]#Button# component is normally used for initiating some action, such as finalizing input in forms. When the user clicks a button, a -[classname]#Button.ClickEvent# is fired, which can be handled with a -[interfacename]#Button.ClickListener# in the [methodname]#buttonClick()# method. +[classname]#Button.ClickEvent# is fired, which can be handled by adding a __click listener__ +using either the [methodname]#onClick()# or the [methodname]#addClickListener()# method. You can handle button clicks with an anonymous class as follows: @@ -25,14 +25,7 @@ You can handle button clicks with an anonymous class as follows: ---- Button button = new Button("Do not press this button"); -button.addClickListener(new Button.ClickListener() { - public void buttonClick(ClickEvent event) { - Notification.show("Do not press this button again"); - } -}); - -// Java 8 -button.addClickListener(click -> +button.addClickListener(clickEvent -> Notification.show("Do not press this button again")); ---- See the http://demo.vaadin.com/book-examples-vaadin7/book#component.button.basic[on-line example, window="_blank"]. @@ -45,11 +38,10 @@ The button component can be styled in many ways, as illustrated in <<figure.comp .Button in Different Styles of Valo Theme image::img/button-example1.png[width=70%, scaledwidth=100%] -If you handle several buttons in the same listener, you can differentiate -between them either by comparing the [classname]#Button# object reference -returned by the [methodname]#getButton()# method of -[classname]#Button.ClickEvent# to a kept reference. For a detailed description -of these patterns together with some examples, please see +If you handle several buttons in the same listener, you can differentiate between +them by comparing the [classname]#Button# object reference returned by the [methodname]#getButton()# +method of [classname]#Button.ClickEvent# to a kept reference. For a detailed description +of these patterns together with some examples, please see <<dummy/../../../framework/architecture/architecture-events#architecture.events,"Events and Listeners">>. == CSS Style Rules diff --git a/documentation/components/components-checkbox.asciidoc b/documentation/components/components-checkbox.asciidoc index 570a3ee083..cf00fd1b61 100644 --- a/documentation/components/components-checkbox.asciidoc +++ b/documentation/components/components-checkbox.asciidoc @@ -20,12 +20,10 @@ and check box groups with the [classname]#OptionGroup# component in multiple selection mode, as described in <<dummy/../../../framework/components/components-optiongroup#components.optiongroup,"OptionGroup">>. -Clicking on a check box will change its state. The state is a -[classname]#Boolean# property that you can set with the [methodname]#setValue()# -method and obtain with the [methodname]#getValue()# method of the -[classname]#Property# interface. Changing the value of a check box will cause a -[classname]#ValueChangeEvent#, which can be handled by a -[classname]#ValueChangeListener#. +Clicking on a check box will change its state. The state is a [classname]#Boolean# +property that you can set with the [methodname]#setValue()# method and obtain with +the [methodname]#getValue()# method. Changing the value of a check box will cause +a [classname]#ValueChangeEvent#, which can be handled by a [classname]#ValueChangeListener#. [source, java] @@ -35,10 +33,10 @@ CheckBox checkbox2 = new CheckBox("Box with a Check"); checkbox2.setValue(true); -checkbox1.addValueChangeListener(event -> // Java 8 +checkbox1.addValueChangeListener(event -> checkbox2.setValue(! checkbox1.getValue())); -checkbox2.addValueChangeListener(event -> // Java 8 +checkbox2.addValueChangeListener(event -> checkbox1.setValue(! checkbox2.getValue())); ---- |