Skip to content

[docs] Fix use of ellipsis#3633

Merged
oliviertassinari merged 1 commit intomui:masterfrom
oliviertassinari:fix-ellipsis
Dec 29, 2025
Merged

[docs] Fix use of ellipsis#3633
oliviertassinari merged 1 commit intomui:masterfrom
oliviertassinari:fix-ellipsis

Conversation

@oliviertassinari
Copy link
Copy Markdown
Member

@oliviertassinari oliviertassinari commented Dec 27, 2025

Why?

  • Type designers specifically space these dots so they are more legible and aesthetically balanced.
  • A screen reader might literally say "dot, dot, dot" (though when I test this, it silences it with VoiceOver and TalkBack).

For example: https://vercel.com/design/guidelines#use-the-ellipsis-character. It's already done correctly in the historical repositories.

@oliviertassinari oliviertassinari added docs Improvements or additions to the documentation. type: regression A bug, but worse, it used to behave as expected. labels Dec 27, 2025
@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented Dec 27, 2025

  • vite-css-base-ui-example

    pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/react@3633
    
    pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/utils@3633
    

commit: 5e0e3ec

@mui-bot
Copy link
Copy Markdown

mui-bot commented Dec 27, 2025

Bundle size report

Bundle Parsed size Gzip size
@base-ui/react 0B(0.00%) 0B(0.00%)

Details of bundle changes


Check out the code infra dashboard for more information about this PR.

@netlify
Copy link
Copy Markdown

netlify Bot commented Dec 27, 2025

Deploy Preview for base-ui ready!

Name Link
🔨 Latest commit 4d45626
🔍 Latest deploy log https://app.netlify.com/projects/base-ui/deploys/694fda3594af8a00088bd188
😎 Deploy Preview https://deploy-preview-3633--base-ui.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented Dec 27, 2025

Deploy Preview for base-ui ready!

Name Link
🔨 Latest commit 5e0e3ec
🔍 Latest deploy log https://app.netlify.com/projects/base-ui/deploys/694fdac4dcc39a000844aada
😎 Deploy Preview https://deploy-preview-3633--base-ui.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

oliviertassinari added a commit to mui/material-ui that referenced this pull request Dec 27, 2025
oliviertassinari added a commit to mui/mui-x that referenced this pull request Dec 27, 2025
function renderValue(value: Language[]) {
if (value.length === 0) {
return 'Select languages...';
return 'Select languages';
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unrelated nitpick: Is there a point in having the ellipsis here?
It seems that Select language should be clear enough, but maybe this is some sort of a "rule" I'm not aware of? 🤔

Copy link
Copy Markdown
Member Author

@oliviertassinari oliviertassinari Dec 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@LukasTy To what I understand, the ellipsis use cases are:

  • More inputs are needed to trigger the action.
  • An action is in progress.

https://vercel.com/design/guidelines#ellipsis-for-further-input-loading-states makes the same arguments.

A select placeholder is none of those so the ellipsis is wrong in this context. However, it's a different problem than what this PR aims to solve. Let's make another one, if you want to?. Merging.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Given this description:

Menu options that open a follow-up e.g., "Rename…"

I would say that the existing placeholders seem to comply with this guide - they open a Popup with more options. 🤷

Copy link
Copy Markdown
Member Author

@oliviertassinari oliviertassinari Dec 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But

  • there are already other clues, e.g. chevron
  • most design systems don't have this ellipsis convention for select, MD, Apple Human Interface, Joy UI, Geist.

So this seems redundant, unnecessary information in the UI.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Finishing this in #4445.

value.length > 0
? value.map((v) => fonts.find((f) => f.value === v)?.label).join(', ')
: 'Select fonts...'
: 'Select fonts'
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same question as before.
Do we even need this?

Suggested change
: 'Select fonts'
: 'Select fonts'

function renderValue(value: Language[]) {
if (value.length === 0) {
return 'Select languages...';
return 'Select languages';
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And here. 🙈

@colmtuite colmtuite self-requested a review December 29, 2025 13:12
@oliviertassinari oliviertassinari merged commit 54e40bf into mui:master Dec 29, 2025
23 checks passed
@oliviertassinari oliviertassinari deleted the fix-ellipsis branch December 29, 2025 14:25
atomiks pushed a commit to atomiks/base-ui that referenced this pull request Dec 30, 2025
atomiks pushed a commit to atomiks/base-ui that referenced this pull request Dec 30, 2025
atomiks pushed a commit to atomiks/base-ui that referenced this pull request Jan 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to the documentation. type: regression A bug, but worse, it used to behave as expected.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants