form-field: update docs to reflect actual behavior of label/placeholder

[yr2193]

Bug

I am following this closed bug 17ceb9a
which said the label and placeholder are separated.

What is the expected behavior?

I expect if I follow the example code then I should be able to have my label and placeholder separated.

What is the current behavior?

It does not work as it should be. Only the label is shown.

What are the steps to reproduce?

https://stackblitz.com/edit/angular-qnzimy?file=app%2Finput-overview-example.ts

What is the use-case or motivation for changing an existing behavior?

Which versions of Angular, Material, OS, TypeScript, browsers are affected?

Is there anything else we should know?

https://material.angular.io/components/input/overview
This overview does not include any of these changes. I do not know what is the latest status of label vs placeholder. Is there another bug or something?

[mmalerba]

The placeholder is specified via the standard placeholder attribute on the native <input>: https://stackblitz.com/edit/angular-qnzimy-ndaawa?file=app/input-overview-example.html

[LosD]

@mmalerba That does not seem to follow the documentation, which does not put any significance on the difference between the placeholder attribute and the mat-placeholder element. If this isn't a bug in behavior, it's a bug in the documentation (and the documentation frankly makes much more sense than the behavior)

Furthermore, it doesn't seem to work for mat-select. I've tried to both use the placeholder attribute and mat-placeholder. As soon as a mat-label is specified, the placeholder is ignored completely.

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}