aboutsummaryrefslogtreecommitdiffstats
path: root/documentation/clientsidewidgets/clientsidewidgets-overview.asciidoc
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/clientsidewidgets/clientsidewidgets-overview.asciidoc')
-rw-r--r--documentation/clientsidewidgets/clientsidewidgets-overview.asciidoc33
1 files changed, 33 insertions, 0 deletions
diff --git a/documentation/clientsidewidgets/clientsidewidgets-overview.asciidoc b/documentation/clientsidewidgets/clientsidewidgets-overview.asciidoc
new file mode 100644
index 0000000000..75206944ed
--- /dev/null
+++ b/documentation/clientsidewidgets/clientsidewidgets-overview.asciidoc
@@ -0,0 +1,33 @@
+---
+title: Overview
+order: 1
+layout: page
+---
+
+[[clientsidewidgets.overview]]
+= Overview
+
+The Vaadin client-side API is based on the Google Web Toolkit. It involves
+__widgets__ for representing the user interface as Java objects, which are
+rendered as a HTML DOM in the browser. Events caused by user interaction with
+the page are delegated to event handlers, where you can implement your UI logic.
+
+In general, the client-side widgets come in two categories - basic GWT widgets
+and Vaadin-specific widgets. The library includes __connectors__ for integrating
+the Vaadin-specific widgets with the server-side components, thereby enabling
+the server-side development model of Vaadin. The integration is described in
+<<dummy/../../../framework/gwt/gwt-overview.asciidoc#gwt.overview,"Integrating
+with the Server-Side">>.
+
+The layout of the client-side UI is managed with __panel__ widgets, which
+correspond in their function with layout components in the Vaadin server-side
+API.
+
+In addition to the rendering API, the client-side API includes facilities for
+making HTTP requests, logging, accessibility, internationalization, and testing.
+
+For information about the basic GWT framework, please refer to
+https://developers.google.com/web-toolkit/overview.
+
+
+