Stylized elements

Benefit from CSS Nesting, @layer, @scope, in addition, browser compatibility has improved in recent years, and vendor private prefixes have also been cancelled, there is no longer a need for CSS Modules similar solutions.

Shared style

Use the css to create a shared style table, use @adoptedStyle to apply to the required elements.

import { GemElement, css, adoptedStyle, customElement } from '@mantou/gem';

// Create a style sheet using Constructable Stylesheet
const styles = css`
  h1 {
    text-decoration: underline;
  }
`;

@adoptedStyle(styles)
@customElement('my-element')
class MyElement extends GemElement {}

Light DOM elements (the default) are also affected by global style sheets. Global styles cannot cross the Shadow DOM boundary, so elements using @shadow() can share values through CSS variables.

CSS in JS

You can reference CSS selectors in JS:

import { GemElement, html, css, styled, adoptedStyle, customElement, template } from '@mantou/gem';

const styles = css({
  header: styled.class`
    text-decoration: underline;
    &:hover {
      text-decoration: none;
    }
  `,
});

@adoptedStyle(styles)
@customElement('my-element')
class MyElement extends GemElement {
  @template()
  #content = () => {
    return html`<div class=${styles.header}></div>`;
  };
}

NOTE

Use $ as a key to represent :host, :scope selectors, allowing styles to apply to both ShadowDOM and LightDOM.

Stylized Instance

If you need to specify the style of a single instance through properties or states, you can:

// Omit import...

@customElement('my-element')
@shadow()
class MyElement extends GemElement {
  @attribute color;

  @template()
  #content = () => {
    return html`
      <style>
        :host {
          --color: ${this.color}
        }
      </style>
    `;
  };
}

This method is complex and troublesome to write; it is recommended to use createDecoratorTheme.

Customize the style outside the element

Use ::part(only ShadowDOM) to export the internal content of the element, allowing external custom styles:

/**
 * The following code has the same effect as `<div part="header"></div>`,
 * But Gem recommends using decorators to define parts, so that IDE integration can be done well in the future
 */

// Omit import...

@customElement('my-element')
@shadow()
class MyElement extends GemElement {
  @part static header;

  @template()
  #content = () => {
    return html`<div part=${MyElement.header}></div>`;
  };
}

Also use ElementInternals.states to export element internal state, external styling this element for current state:

// Omit import...

@customElement('my-element')
class MyElement extends GemElement {
  @state opened;

  open = () => {
    // Can be selected by the selector `:state(opened)`
    this.opened = true;
  };
}

NOTE

Note the difference with createState

TIP

Can also customize element styles using hack, for example:

GemLinkElement[Symbol.metadata].adoptedStyleSheets.push(
  css`
    * {
      font-style: italic;
    }
  `,
);

Custom element external style

Tailwind CSS

Atomic CSS solutions such as Tailwind CSS work with Light DOM elements, which is Gem's default: load the generated style sheet globally and use utility classes directly in templates. Global utility classes cannot style content inside elements that use @shadow().