@gluonjs/core / src/styles / createStyleSheetOwner

Function: createStyleSheetOwner()

createStyleSheetOwner(target): StyleSheetOwner

Creates one disposable stylesheet owner for a Document or ShadowRoot. Owners on the same target share reference counts and never remove sheets that predated Gluon's first retained reference.

Parameters

target

StyleTarget

Returns

StyleSheetOwner

Example

Retain target-local constructed sheets through a reference-counted owner and release exactly that handle's claims:

import {
  createStyleSheetOwner,
  createStyleSheetSelection,
  css,
  getStyleSheetDigest,
  getStyleTextDigest,
  replaceStyleSheet,
  type StyleSheetOwner,
  type StyleSheetSelection,
  type StyleSheetSelectionEntry,
} from '@gluonjs/core';

const sheet = css`:root { --shop-accent: blue; }`;
const entry = { id: 'shop-theme', scope: 'shop', sheet } satisfies StyleSheetSelectionEntry;
const selection: StyleSheetSelection = createStyleSheetSelection([entry]);
const owner: StyleSheetOwner = createStyleSheetOwner(document);
owner.retain(sheet);
replaceStyleSheet(sheet, ':root { --shop-accent: green; }');
console.log(selection.entries[0]?.id, getStyleSheetDigest(sheet), getStyleTextDigest('shop'));
owner.release(sheet);
owner.dispose();