Nuxt UI documentation
Hello π
Got confused by the Nuxt UI docs (ui.nuxt.com) and wanted to know if it happened to others.
Context: integrating
UFileUpload for the time.
Problem: it broke the tab navigation.
Confusion: (see screenshot) the docs said it was already fixed.
Clarification: Fixed in the repo yes but not yet released (not in 4.0.1)
Details:
- the fix https://github.com/nuxt/ui/pull/5128
- the release details https://github.com/nuxt/ui/releases/tag/v4.0.1
See that the PR is nowhere to be found π
---
I integrated the code fix in a pnpm patch for now. so I should be alright until the next release. Let me know if you have been confused by the docs before. πGitHub
fix(FileUpload): stuck focus while tabbing by J-Michalek Β· Pull Re...
π Linked issue
Resolves: #5102
β Type of change
π Documentation (updates to the documentation or readme)
π Bug fix (a non-breaking change that fixes an issue)
π Enhancement (improving an exis...
GitHub
Release v4.0.1 Β· nuxt/ui
π Bug Fixes
App: allow global portal disabling (#5111) (7659fa1)
AuthForm: export type with proper inference for field-specific props (#5106) (344f269)
Avatar: remove redundant img role (066b8a1),...
7 Replies
Hi @cedpoilly. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:
----------------------
You're correct in your understanding: the fix for the tab navigation issue in
Nuxt UI FileUpload Changelog
Nuxt UI Continuous Releases ---------------------- Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: ----------------------
UFileUpload (PR #5128) is listed in the Nuxt UI documentation changelog, but it has not yet been included in an official release such as v4.0.1. The changelog for the FileUpload component specifically mentions this fix:
However, if you check the v4.0.1 release notes, this PR is not included, which means the fix is present in the main branch but not yet published in a stable release. This can indeed be confusing, as the documentation reflects the latest changes in the repository, not just what is available in the latest npm release. For cases like this, Nuxt UI supports installing preview releases directly from a commit using pkg.pr.new. This allows you to use the latest fixes before they're officially released: Replace2477dβ fix: stuck focus while tabbing (#5128)
See changelog
<commit-hash> with the hash of a commit that includes the fix.
Your approach of using a patch is a good workaround until the next official release. This kind of confusion can happen because the docs are always up-to-date with the main branch, not necessarily with the latest published version. You're not alone in noticing this!Nuxt UI FileUpload Changelog
Nuxt UI Continuous Releases ---------------------- Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: ----------------------
<@807645615965470740> Kapa.ai is still learning and improving, please let me know how I did by reacting below.
My opinion is the following: When reading the docs, I think it should be safe to assume that what is mentioned in the changelog is included in the latest stable release. π
I agree with you, @cedpoilly
Can we discuss about this in detail?
@dario sure. How can I help?
Did you already fix the nuxt project issues?
I just wanted to help you solve the issue
Are you a member of the nuxt core dev team?
Not at all, I am just a Nuxt consumer. Just started using Nuxt UI & faced that issue. - I have fixed it with a pnpm patch for my project. I will remove the patch when 4.0.2 ships