-
Notifications
You must be signed in to change notification settings - Fork 4.7k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
fix: allows no rel attribute on external links in the nav #2338
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM. Thanks.
@@ -69,14 +69,14 @@ module.exports = { | |||
} | |||
``` | |||
|
|||
Outbound links automatically get `target="_blank" rel="noopener noreferrer"`. You can offer `target` and `rel` to customize the attributes: | |||
Outbound links automatically get `target="_blank" rel="noopener noreferrer"`. You can offer `target` and `rel` to customize the attributes. Passing a "falsy" value to the `rel` attribute will disable that attribute for a link: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oh, maybe I should make this clearer to say that the falsy value can't be undefined
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMHO, change the rule. Let user set false
rather than falsy value to disable the attribute.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That makes sense.
Should I create an issue to update this in the Chinese docs or something? |
I'll take it later. No worries. |
Co-authored-by: Billyyyyy3320 <newsbielt703@gmail.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for your PR @abea!
* fix: allows no rel attribute on external links in the nav * fix: documents the falsy rel option * fix: clarifies documentation * fix: explicitly uses for rel attr * fix: removes unnecessary condition Co-authored-by: Billyyyyy3320 <newsbielt703@gmail.com> Co-authored-by: Billyyyyy3320 <newsbielt703@gmail.com>
Summary
Currently it's not possible to specify that there should be no
rel
attribute on external nav links to use the default behavior. Setting to an empty string, as indicated in the documentation, is falsy, so you end up in the final ternary, which usesnoopener noreferrer
for external links.This change allows devs to pass in a falsy, non-
undefined
, value to therel
property to have no rel attribute on the link. It also change the fallback of an empty string tonull
since an emptyrel
attribute has no particular meaning, so it's better to have it not there at all.What kind of change does this PR introduce? (check at least one)
If changing the UI of default theme, please provide the before/after screenshot:
Does this PR introduce a breaking change? (check one)
If yes, please describe the impact and migration path for existing applications:
The PR fulfills these requirements:
fix #xxx[,#xxx]
, where "xxx" is the issue number)You have tested in the following browsers: (Providing a detailed version will be better.)
I could not tell from the contributor guide or the package scripts how to build this for linking to a project and testing. I'd be happy to do that with some direction.
If adding a new feature, the PR's description includes:
To avoid wasting your time, it's best to open a feature request issue first and wait for approval before working on it.
Other information: