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-passwordfield.asciidoc   | 54 ++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 documentation/components/components-passwordfield.asciidoc

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

diff --git a/documentation/components/components-passwordfield.asciidoc b/documentation/components/components-passwordfield.asciidoc
new file mode 100644
index 0000000000..1280de7529
--- /dev/null
+++ b/documentation/components/components-passwordfield.asciidoc
@@ -0,0 +1,54 @@
+---
+title: PasswordField
+order: 11
+layout: page
+---
+
+[[components.passwordfield]]
+= [classname]#PasswordField#
+
+ifdef::web[]
+[.sampler]
+image:{live-demo-image}[alt="Live Demo", link="http://demo.vaadin.com/sampler/#ui/data-input/text-input/password-field]
+endif::web[]
+
+The [classname]#PasswordField# is a variant of [classname]#TextField# that hides
+the typed input from visual inspection.
+
+
+[source, java]
+----
+PasswordField tf = new PasswordField("Keep it secret");
+----
+See the http://demo.vaadin.com/book-examples-vaadin7/book#component.passwordfield.basic[on-line example, window="_blank"].
+
+The result is shown in <<figure.components.passwordfield.basic>>.
+
+[[figure.components.passwordfield.basic]]
+.[classname]#PasswordField#
+image::img/passwordfield-basic.png[]
+
+You should note that the [classname]#PasswordField# hides the input only from
+"over the shoulder" visual observation. Unless the server connection is
+encrypted with a secure connection, such as HTTPS, the input is transmitted in
+clear text and may be intercepted by anyone with low-level access to the
+network. Also phishing attacks that intercept the input in the browser may be
+possible by exploiting JavaScript execution security holes in the browser.
+
+[[components.passwordfield.css]]
+== CSS Style Rules
+
+
+[source, css]
+----
+.v-textfield { }
+----
+
+The [classname]#PasswordField# does not have its own CSS style name but uses the
+same [literal]#++v-textfield++# style as the regular [classname]#TextField#. See
+<<dummy/../../../framework/components/components-textfield#components.textfield.css,"CSS
+Style Rules">> for information on styling it.
+
+CSS Styling
+
+
-- 
cgit v1.2.3

