summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorJohannes Dahlström <johannesd@vaadin.com>2016-07-19 14:57:05 +0300
committerArtur Signell <artur@vaadin.com>2016-08-05 10:19:45 +0300
commit69f703100ed57720672467e6e53319781cb8ebc9 (patch)
tree0af17e22a90e7891f296caf74426df008e7533b4 /documentation
parentbefaa39cc0637028688f4bfb5d7f6e824ea9a1af (diff)
downloadvaadin-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.asciidoc22
-rw-r--r--documentation/components/components-checkbox.asciidoc14
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()));
----