aboutsummaryrefslogtreecommitdiffstats
path: root/documentation/components/components-table.asciidoc
diff options
context:
space:
mode:
authorMarko Gronroos <magi@vaadin.com>2016-07-19 19:12:09 +0300
committerArtur Signell <artur@vaadin.com>2016-08-05 10:19:44 +0300
commit44a94bb28605bec406f415ef66fc332c265f7c9a (patch)
treedd392c41bdcddf53fe08289d01ea6f1c7617c5cd /documentation/components/components-table.asciidoc
parentf548cfa87625c970be4f10efe18a10763495a51a (diff)
downloadvaadin-framework-44a94bb28605bec406f415ef66fc332c265f7c9a.tar.gz
vaadin-framework-44a94bb28605bec406f415ef66fc332c265f7c9a.zip
Revised client-side arch, Java Servlet, new project, view navigation, and basic UI schematic diagrams (#19897). Mostly disabled and rearranged Table section, etc.
Change-Id: Iedcd7bfc04c53b7d1cdf621261234688d21a52f3
Diffstat (limited to 'documentation/components/components-table.asciidoc')
-rw-r--r--documentation/components/components-table.asciidoc14
1 files changed, 12 insertions, 2 deletions
diff --git a/documentation/components/components-table.asciidoc b/documentation/components/components-table.asciidoc
index d1839a8ac0..25abb2263c 100644
--- a/documentation/components/components-table.asciidoc
+++ b/documentation/components/components-table.asciidoc
@@ -14,6 +14,13 @@ endif::web[]
((("[classname]#Table#", id="term.components.table", range="startofrange")))
+[NOTE]
+====
+[classname]#Table# is largely obsolete and has been replaced by the newer [classname]#Grid# component.
+Nevertheless, it still has some features, such as drag and drop, which have no counterpart in Grid.
+Table also still uses the old data API.
+Hence, only a short introduction is given below; see the online Vaadin Docs for more details.
+====
The [classname]#Table# component is intended for presenting tabular data
organized in rows and columns. The [classname]#Table# is one of the most
@@ -21,6 +28,9 @@ versatile components in Vaadin. Table cells can include text or arbitrary UI
components. You can easily implement editing of the table data, for example
clicking on a cell could change it to a text field for editing.
+.Basic Table Example
+image::img/table-example1.png[width=35%, scaledwidth=50%]
+
The data contained in a [classname]#Table# is managed using the Vaadin data model (see <<dummy/../../../framework/datamodel/datamodel-overview.asciidoc#datamodel.overview,"Binding Components to Data">>), through the [classname]#Container# interface of the [classname]#Table#.
This makes it possible to bind a table directly to a data source, such as a database query.
Only the visible part of the table is loaded
@@ -72,8 +82,7 @@ rows are given simply as object arrays, in the same order in which the
properties were added. The objects must be of the correct class, as defined in
the [methodname]#addContainerProperty()# calls.
-.Basic Table Example
-image::img/table-example1.png[width=35%, scaledwidth=50%]
+ifdef::vaadin7[]
Scalability of the [classname]#Table# is largely dictated by the container. The
default [classname]#IndexedContainer# is relatively heavy and can cause
@@ -1152,5 +1161,6 @@ image::img/table-cellstylegenerator1.png[width=50%, scaledwidth=80%]
endif::web[]
+endif::vaadin7[]
(((range="endofrange", startref="term.components.table")))