Index: lib/paper_input.dart |
diff --git a/lib/paper_input.dart b/lib/paper_input.dart |
index 2d4e9409935771a57028da718f5cc2d20c76d49c..c58cc95a05e9f135f5b1eec185d20e994a6b3fb9 100644 |
--- a/lib/paper_input.dart |
+++ b/lib/paper_input.dart |
@@ -16,6 +16,8 @@ import 'paper_input_container.dart'; |
import 'paper_input_error.dart'; |
import 'paper_input_char_counter.dart'; |
+/// Material design: [Text fields](https://www.google.com/design/spec/components/text-fields.html) |
+/// |
/// `<paper-input>` is a single-line text field with Material Design styling. |
/// |
/// <paper-input label="Input label"></paper-input> |
@@ -35,6 +37,15 @@ import 'paper_input_char_counter.dart'; |
/// <paper-icon-button suffix icon="clear"></paper-icon-button> |
/// </paper-input> |
/// |
+/// A `paper-input` can use the native `type=search` or `type=file` features. |
+/// However, since we can't control the native styling of the input, in these cases |
+/// it's recommended to use a placeholder text, or `always-float-label`, |
+/// as to not overlap the native UI (search icon, file button, etc.). |
+/// |
+/// <paper-input label="search!" type="search" |
+/// placeholder="search for cats" autosave="test" results="5"> |
+/// </paper-input> |
+/// |
/// See `Polymer.PaperInputBehavior` for more API docs. |
/// |
/// ### Styling |