mui / mui/material-ui

[docs][select] `placeholder` prop is omitted

Open
#44,821 3 comments 3 reactions 1 assignee View on GitHub

@aarongarciah is already working on this.

Since Dec 20, 2024.

docs scope: docs-infra scope: select support: docs-feedback
Dominant language
JavaScript
Stars
99.1k
Forks
32.5k
Avg merge
2d 17h
Merged PRs (30d)
106

Description

Related page

https://mui.com/material-ui/api/select/

Kind of issue

Missing information

Issue description

Following issue https://github.com/mui/material-ui/pull/44502, the placeholder prop has been removed from the Select component for having no effect. While I'm inclined to disagree (MUI could render a placeholder, and the Select documentation event suggests on how to render one) the API documentation should at least reflect that decision.

As of the time of writing, the Select API documentation makes no mention of the omission of the placeholder prop. In fact, it refers to OutlinedInput:

Props of the OutlinedInput component are also available.

Which is where it is rightfully listed, leading developers to believe it should be available in Select.

I was ready to file a bug report, but having found that issue, I discovered placeholder was omitted intentionally. At first I went to the documentation to figure out what's what with this prop, but no mention of it was made, which lead me to create the issue you're reading now.

Context

No response

Search keywords: select placeholder

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.