From 9c143325788f505200b5ebbc739cc6c2bbe14358 Mon Sep 17 00:00:00 2001
From: Kara <kara@users.noreply.github.com>
Date: Wed, 8 Mar 2017 18:12:43 -0800
Subject: [PATCH] docs(select): add docs for static placeholder (#3519)

---
 src/lib/select/select.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/lib/select/select.md b/src/lib/select/select.md
index 8ff4d404f6b0..3cce49f7397d 100644
--- a/src/lib/select/select.md
+++ b/src/lib/select/select.md
@@ -37,6 +37,19 @@ class MyComp {
 }
 ```
 
+### Setting a static placeholder
+
+It's possible to turn off the placeholder's floating animation using the `floatPlaceholder` property. It accepts one of three string options:
+- `'auto'`: This is the default floating placeholder animation. It will float up when a selection is made.
+- `'never'`: This makes the placeholder static. Rather than floating, it will disappear once a selection is made.
+- `'always'`: This makes the placeholder permanently float above the input. It will not animate up or down.
+    
+```html
+<md-select placeholder="State" [(ngModel)]="myState" floatPlaceholder="never">
+   <md-option *ngFor="let state of states" [value]="state.code">{{ state.name }}</md-option>
+</md-select>
+``` 
+
 #### Keyboard interaction:
 - <kbd>DOWN_ARROW</kbd>: Focus next option
 - <kbd>UP_ARROW</kbd>: Focus previous option