From 99d6de546c74f0eed230ea8253dda6b85109d2e7 Mon Sep 17 00:00:00 2001
From: Markus Koivisto <markus@vaadin.com>
Date: Fri, 22 Jan 2016 14:55:18 +0200
Subject: Add documentation to master branch

Change-Id: I2504bb10f1ae73ec0cbc08b7ba5a88925caa1674
---
 .../components/components-listselect.asciidoc      | 62 ++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 documentation/components/components-listselect.asciidoc

(limited to 'documentation/components/components-listselect.asciidoc')

diff --git a/documentation/components/components-listselect.asciidoc b/documentation/components/components-listselect.asciidoc
new file mode 100644
index 0000000000..24f1bebc03
--- /dev/null
+++ b/documentation/components/components-listselect.asciidoc
@@ -0,0 +1,62 @@
+---
+title: ListSelect
+order: 17
+layout: page
+---
+
+[[components.listselect]]
+= [classname]#ListSelect#
+
+ifdef::web[]
+[.sampler]
+image:{live-demo-image}[alt="Live Demo", link="http://demo.vaadin.com/sampler/#ui/data-input/multiple-value/list-select]
+endif::web[]
+
+The [classname]#ListSelect# component is list box that shows the selectable
+items in a vertical list. If the number of items exceeds the height of the
+component, a scrollbar is shown. The component allows both single and multiple
+selection modes, which you can set with [methodname]#setMultiSelect()#. It is
+visually identical in both modes.
+
+
+[source, java]
+----
+// Create the selection component
+ListSelect select = new ListSelect("The List");
+        
+// Add some items (here by the item ID as the caption)
+select.addItems("Mercury", "Venus", "Earth", ...);
+
+select.setNullSelectionAllowed(false);
+
+// Show 5 items and a scrollbar if there are more
+select.setRows(5);
+----
+
+The number of visible items is set with [methodname]#setRows()#.
+
+[[figure.components.listselect.basic]]
+.The [classname]#ListSelect# Component
+image::img/listselect-basic.png[]
+
+Common selection component features are described in
+<<dummy/../../../framework/components/components-selection#components.selection,"Selection
+Components">>.
+
+== CSS Style Rules
+
+
+[source, css]
+----
+.v-select {}
+  .v-select-select {}
+    option {}
+----
+
+The component has an overall [literal]#++v-select++# style. The native
+[literal]#++<select>++# element has [literal]#++v-select-select++# style. The
+items are represented as [literal]#++<option>++# elements.
+
+
+
+
-- 
cgit v1.2.3

