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

[docs] Edits on new Styles docs #503

Merged
29 commits merged into from
Feb 5, 2019
Merged

[docs] Edits on new Styles docs #503

29 commits merged into from
Feb 5, 2019

Conversation

ghost
Copy link

@ghost ghost commented Jan 30, 2019

justinfagnani and others added 4 commits January 29, 2019 17:46
I added a brief intro to shadow DOM scoping, sections on static styles, inline styles and external styles, and tried to clarify the organization around what elements styles apply to: host, shadow root, or slotted.

Not sure if the top-level headings are right though
Co-Authored-By: justinfagnani <justin@fagnani.com>
@ghost ghost requested a review from justinfagnani as a code owner January 30, 2019 22:42
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
Kate Jeffreys and others added 9 commits January 30, 2019 17:03
Co-Authored-By: katejeffreys <katejeffreys@google.com>
Co-Authored-By: katejeffreys <katejeffreys@google.com>
Co-Authored-By: katejeffreys <katejeffreys@google.com>
Copy link
Contributor

@arthurevans arthurevans left a comment

Choose a reason for hiding this comment

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

Left some comments on doc.

docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
docs/_guide/styles.md Outdated Show resolved Hide resolved
@ghost ghost changed the title Edits on new Styles docs (not ready yet) [docs] Edits on new Styles docs Feb 3, 2019
@ghost ghost changed the base branch from styles-doc-update to master February 4, 2019 23:13
@ghost ghost changed the base branch from master to styles-doc-update February 4, 2019 23:14
@ghost ghost changed the base branch from styles-doc-update to master February 4, 2019 23:21
@justinfagnani
Copy link
Contributor

justinfagnani commented Feb 4, 2019

@katejeffreys I don't see most of the changes anymore. Oops, my fault.


In this section:

* [Write CSS styles for a host element](#host-styles). The host element is your component. It is called the "host" because it hosts shadow DOM. You can style the element itself with the special CSS selectors `:host` and `:host()`.
Copy link
Contributor

Choose a reason for hiding this comment

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

description duplicates the into to this page


* [Write CSS styles for a host element](#host-styles). The host element is your component. It is called the "host" because it hosts shadow DOM. You can style the element itself with the special CSS selectors `:host` and `:host()`.
* [Write CSS styles for elements in shadow DOM](#shadow-dom-styles).
* [Write CSS styles for slotted children](#slotted-styles). Light DOM children of your host element can be rendered in shadow DOM via the `slot` element. You can style slotted content with the `::slotted()` CSS selector.
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe leave off the second sentence, and change the first to just define "slotted children", like:

Slotted elements are light DOM children of the host that are rendered into a shadow root with the <slot> element.

@googlebot
Copy link

We found a Contributor License Agreement for you (the sender of this pull request), but were unable to find agreements for all the commit author(s) or Co-authors. If you authored these, maybe you used a different email address in the git commits than was used to sign the CLA (login here to double check)? If these were authored by someone else, then they will need to sign a CLA as well, and confirm that they're okay with these being contributed to Google.
In order to pass this check, please resolve this problem and have the pull request author add another comment and the bot will run again. If the bot doesn't comment, it means it doesn't think anything has changed.

@googlebot googlebot added cla: no and removed cla: yes labels Feb 4, 2019
@ghost
Copy link
Author

ghost commented Feb 5, 2019

@jbingham pls check your CLA

@justinfagnani
Copy link
Contributor

@katejeffreys we can go ahead without @jbingham's CLA. He's either not in the right orgs, or the CLA bot sometimes just messes up on any PR with multiple authors.

@jbingham
Copy link
Contributor

jbingham commented Feb 5, 2019 via email

@ghost ghost merged commit 363358e into master Feb 5, 2019
@ghost
Copy link
Author

ghost commented Feb 5, 2019

Sorry @jbingham, idk what happened there, dont' think it was you


If you don't want to use custom properties, you can define per-instance styles in a `<style>` element inside shadow DOM. See the section on [Defining your styles in a style element](#styleelement) for more information.

</div>

Choose a reason for hiding this comment

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

already closed in line 15 :)

@ghost ghost deleted the styles-doc-update-kj branch March 25, 2019 19:12
This pull request was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants