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

Clarify Vanilla Emotion auto-prefixing capabilities in documentation #1662

Merged
merged 5 commits into from
Dec 4, 2019

Conversation

clemmy
Copy link
Contributor

@clemmy clemmy commented Nov 30, 2019

Happy Thanksgiving everyone! fixes #1523

What:

I made this issue a while back where I had misconceptions about the capabilities of Vanilla Emotion. In this PR, I tidy up the docs a bit to hopefully erase these misconceptions (at least when read by me!).

Why:

These changes are needed to help Emotion users understand the capabilities of Vanilla vs React emotion better.

How:

Markdown changes!

Checklist:

  • Documentation
  • Tests
  • Code complete
  • Changeset

@changeset-bot
Copy link

changeset-bot bot commented Nov 30, 2019

💥 No Changeset

Latest commit: 10ba3fe

Merging this PR will not cause any packages to be released. If these changes should not cause updates to packages in this repo, this is fine 🙂

If these changes should be published to npm, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@@ -63,10 +63,10 @@ The ["@emotion/core"](https://www.npmjs.com/package/@emotion/core) package requi

- CSS prop support

- Similar to the `style` prop but adds support for nested selectors, media queries, and auto-prefixing.
Copy link
Member

Choose a reason for hiding this comment

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

I understand how lack of this information in the previous section could be confusing - but was this one here confusing as well? I would keep this section as is - mention of style prop is kinda nice, it indicates how it looks like in the code.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Upon re-reading this part of the code, I realize that I was associating the style prop with the framework agnostic section for some reason. Let me re-add this part.


- Allows developers to skip the `styled` API abstraction and style components and elements directly.

- Similar to the `style` prop, but also has support for auto vendor-prefixing, nested selectors, and media queries.
Copy link
Member

Choose a reason for hiding this comment

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

Would prefer moving this to its former position (first in the list) - seems more important than the point about styled API.

@Andarist Andarist changed the base branch from master to next December 4, 2019 07:24
@Andarist Andarist changed the base branch from next to master December 4, 2019 08:42
@Andarist Andarist merged commit 6c3aced into emotion-js:master Dec 4, 2019
@Andarist
Copy link
Member

Andarist commented Dec 4, 2019

Thank you!

louisgv pushed a commit to louisgv/emotion that referenced this pull request Sep 6, 2020
…motion-js#1662)

* Update docs/introduction.mdx to be more clear with auto-prefixing support

* Mention style prop again

* Re-order bullet points in CSS prop usage
craftzdog added a commit to craftzdog/craftzdog-homepage that referenced this pull request Nov 5, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

How to get auto-prefixing with vanilla Emotion?
2 participants