Skip to content
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

Remove references to UserCSS and UserStyle #711

Open
ACTCD opened this issue Sep 6, 2024 · 1 comment
Open

Remove references to UserCSS and UserStyle #711

ACTCD opened this issue Sep 6, 2024 · 1 comment
Labels
deprecate Breaking changes

Comments

@ACTCD
Copy link
Collaborator

ACTCD commented Sep 6, 2024

As @quoid has described in above issue, the extension's legacy ==UserStyle== implementation was more of a source of confusion and frustration for users with invalid attempts.

So the best thing to do would be to remove these terms and eliminate those references that cause confusion, especially when we never intend to achieve standardization and compatibility.

We'll probably keep reading .user.css files for a while to preserve compatibility for our historical users, but maybe add a deprecation notice, or provide a one-click conversion feature to convert them to user scripts.

For any new users, and those who are wondering:

  • We have never supported UserCSS/UserStyles based on the @moz-document syntax.
  • We have never supported style formats written for extensions such as Stylus/Stylish etc.
  • We recommend using user scripts and the GM.addStyle(css) API to inject style/css code.
  • We recommend using userscript's @match metadata and js conditional statements to limit css scope.
  • There are some limitations due to the lack of relevant API support in upstream Safari.
    • We may also fail to inject css code early enough (like js)
    • We may not be able to inject css code into sub-frames
@ACTCD ACTCD added the deprecate Breaking changes label Sep 6, 2024
@ACTCD
Copy link
Collaborator Author

ACTCD commented Nov 15, 2024

userstyles

@match may conflict with the metadata block, ending the comment early.

Does not affect actual functionality and injection, but can cause problems in code editors or other scenarios.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
deprecate Breaking changes
Projects
None yet
Development

No branches or pull requests

1 participant