HN 日本語サマリー

← 一覧へ戻る
Web開発

ウェブサイトの背景にアンビエントな雲を追加するライブラリ

Ambient Website Background Clouds (github.com)

6 pointsby dividedcomet1 コメント

要約

background-cloudsは、ウェブサイトの背後に軽量でアニメーションするローポリの雲のバンクを追加するJavaScriptライブラリです。単一のキャンバスを使用し、ランタイム依存がなく、ユーザーの「reduced motion」設定を尊重します。SPA向けのライフサイクルメソッドも提供しており、npmで簡単にインストール・設定できます。

全文翻訳

background-clouds

background-cloudsは、Webサイトの背後に軽量でアニメーションするローポリの雲のバンクを追加します。単一のキャンバスを使用し、ランタイム依存関係がなく、ユーザーがモーション削減を好む場合はアニメーションを一時停止し、シングルページアプリケーション向けのライフサイクルメソッドを公開します。

[画像: アニメーション化されたローポリの雲の背景]

インストール

npm install background-clouds

使用方法

import { createCloudBackground } from "background-clouds";

const clouds = createCloudBackground({
  canvas: document.querySelector("#background-clouds"),
  seed: "my-site",
  speed: 0.8,
  opacity: 0.9
});

// 後で、例えばルートのアンマウント時などに:
clouds.destroy();
<canvas id="background-clouds" aria-hidden="true"></canvas>
#background-clouds {
  position: fixed;
  inset: 0;
  width: 100%;
  height: 100%;
  pointer-events: none;
  z-index: -1;
}

createCloudBackgroundを呼び出す前にキャンバスが利用可能である必要があります。返されるコントローラーには、start()、stop()、resize()、setSeed(seed)、およびdestroy()メソッドがあります。seedは文字列または数値で指定でき、同じシードを使用すると同じ雲のレイアウトが生成されます。speedとopacityはデフォルトで1であり、非負の数を受け入れます。

オプション

オプションデフォルト説明
canvas必須レンダリング先の<canvas>要素。
seedランダム決定論的な雲の配置のための安定した文字列または数値。
speed1移動速度の乗数。静止した雲にするには0に設定します。
opacity1全体的な雲の不透明度乗数。
pixelRatio2レンダリングに使用される最大デバイスピクセル比率。
reducedMotionメディアクエリprefers-reduced-motionを上書きするには明示的に設定します。

このパッケージはキャンバスのピクセルのみを所有します。サイトのCSSでキャンバスのスタッキング順序、背景色、および配置を設定してください。