Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@aria-ui/core

Package Overview
Dependencies
Maintainers
1
Versions
19
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@aria-ui/core

A compact and efficient toolkit for building reactive web components. It powers the [Aria UI](https://github.com/ocavue/aria-ui) library, but it can also be used independently.

  • 0.0.6
  • npm
  • Socket score

Version published
Weekly downloads
3.5K
increased by15.19%
Maintainers
1
Weekly downloads
 
Created
Source

@aria-ui/core

A compact and efficient toolkit for building reactive web components. It powers the Aria UI library, but it can also be used independently.

Key Features

Reactive Signals

Uses signals to manage state reactively and automatically update the DOM in response to state changes. It's powered by the mature and battle-tested @preact/signals-core library.

Context Management

Shares signals easily across widely nested HTML elements through context.

DOM Manipulation Utilities

A comprehensive collection of utilities for DOM interactions, enabling declarative management of attributes, styles, and event listeners.

Contexts

Context<T>

A context is a way to provide and consume signals in a HTML tree.

Methods
consume()
consume(element: ConnectableElement): Signal<T>

Receives the signal from a parent element.

provide()
provide(element: ConnectableElement, signal: Signal<T>): void

Provides a signal to all children of the element.

createContext()

function createContext<T>(key: string | symbol, defaultValue: T): Context<T>;

Creates a new context.

DOM

useAriaAttribute()

function useAriaAttribute<K>(
  element: ConnectableElement,
  key: K,
  compute: () => AriaAttributes[K],
): () => void;

useAriaRole()

function useAriaRole(
  element: ConnectableElement,
  compute: () => undefined | AriaRole,
): () => void;

useAttribute()

function useAttribute(
  element: ConnectableElement,
  key: string,
  compute: () => undefined | string | number,
): () => void;

useEventListener()

function useEventListener<K>(
  element: ConnectableElement,
  type: K,
  listener: (event: HTMLElementEventMap[K]) => void,
  options?: boolean | AddEventListenerOptions,
): void;

useStyle()

function useStyle<K>(
  element: ConnectableElement,
  key: K,
  compute: () => CSSStyleDeclaration[K],
): () => void;

Elements

BaseElement

Base class for all custom elements in Aria UI. It implements the ConnectableElement interface.

new BaseElement(): BaseElement

ConnectableElement

Any HTML element that has implemented the addConnectedCallback method.

PropertyTypeDescription
addConnectedCallback(callback: () => void | VoidFunction) => voidRegisters a callback to be called when the element is connected to the DOM.
This callback can return a cleanup function that will be called when the
element is disconnected from the DOM.

Props and States

SingalState<T>

type SingalState<T>: { [K in keyof T]: Signal<T[K]> };

A plain object containing signals.

assignProps()

function assignProps<T>(
  defaultProps: Readonly<T>,
  props?: Partial<T>,
): Readonly<T>;

Merge two objects, with the second object taking precedence. Only keys present in the first object will be included in the result.

mapSignals()

function mapSignals<T>(values: T): SingalState<T>;

Maps every value in the given object to a signal.

mapValues()

function mapValues<T>(signals: SingalState<T>): T;

Maps every signal in the given object to its current value.

Signals

ReadonlySignal<T>

type ReadonlySignal<T>: _ReadonlySignal<T>;

A read-only signal, providing a way to observe state changes without the ability to modify the state.

This is a re-export of ReadonlySignal type from @preact/signals-core.

Signal<T>

type Signal<T>: _Signal<T>;

A mutable signal that can be used to manage reactive state changes.

This is a re-export of Signal type from @preact/signals-core.

SignalValue<S>

type SignalValue<S>: S extends Signal<infer T> ? T : never;

Extracts the value type from a signal type.

batch()

function batch<T>(callback: () => T): T;

Groups multiple signal updates into a single batch, optimizing performance by reducing the number of updates.

This is a re-export of batch from @preact/signals-core.

createComputed()

function createComputed<T>(compute: () => T): ReadonlySignal<T>;

Creates a computed signal that automatically updates its value based on the reactive dependencies it uses. Computed signals are read-only and are used to derive state from other signals, recalculating their value when dependencies change.

This is an alias for computed from @preact/signals-core.

createSignal()

function createSignal<T>(value: T): Signal<T>;

Creates and returns a new signal with the given initial value. Signals are reactive data sources that can be read and written to, allowing components to reactively update when their values change.

This is an alias for signal from @preact/signals-core.

untracked()

function untracked<T>(callback: () => T): T;

Executes a given computation without automatically tracking its dependencies, useful for avoiding unnecessary re-computations.

This is a re-export of untracked from @preact/signals-core.

useEffect()

function useEffect(
  element: ConnectableElement,
  callback: () => void | VoidFunction,
): () => void;

Registers a callback to be called when the given element is connected to the DOM. It will track which signals are accessed and re-run their callback when those signals change. The callback can return a cleanup function that will be called when the effect is destroyed.

The effect will be destroyed and all signals it was subscribed to will be unsubscribed from, when the element is disconnected from the DOM. You can also manually destroy the effect by calling the returned function.

FAQs

Package last updated on 27 Feb 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc