本文へ移動

Fuda Cards札

画像やライブ3Dを入れるコレクション用のカード枠です。本物の厚み、縁、箔、山、傷み、バインダーを、2つのWebコンポーネントで使えます。

「札(ふだ)」は、カードや札を指す日本語です。 名前について(英語)

目次

やり方

カード要素

fuda-card要素のすべての属性、プロパティ、CSS変数と、それぞれの初期値、大きさと見た目の整え方を説明します。

<fuda-card>は、画像、またはスロットに入れたほかのHTMLを囲む枠です。@johnmorrisdotca/fuda-cards/elementをインポートすると自分で登録され、必要なのはそのインポートだけです。メインのエントリー(@johnmorrisdotca/fuda-cards)は、同じオプションをTypeScriptの型と表として公開し、DOMには触れないので、サーバーでも安全にインポートできます。

枠

属性値働き
titleテキスト上部のカード名。
categoryテキスト角に出す言葉。例:ROCKET。
subtitleテキスト画像の下の1行。
descriptionテキストサブタイトルの下の文章。
numberテキスト下部のカード番号。
rarityテキスト下部のレアリティの印。
variantclassic、sport、cosmic枠の見た目。金、銀、紫。
finishfoil、matte枠が光るかどうか。
flipped真偽値裏面(紺色のFudaの面)を見せる。

既定のスロットには画像を入れます。<img>でも、既存のインタラクティブなビューアーを含む任意のHTMLでも構いません。カードにはドラッグの処理がないので、そのビューアーが自分でポインターを扱います。

import { cardFinishes, cardVariants, type CardOptions } from '@johnmorrisdotca/fuda-cards';

const options: CardOptions = { title: 'Explorer One', variant: cardVariants[2], finish: cardFinishes[0], thickness: 0.325 };
console.log(options.variant, options.finish);
// cosmic foil
cosmic foil

大きさ

要素は初期値で幅300 px、aspect-ratio: 2.5 / 3.5で、内側の寸法はすべてコンテナー単位なので、CSSを1行書くだけでカード全体の大きさが変わります。

<script type="module">import '@johnmorrisdotca/fuda-cards/element';</script>
<style>fuda-card.small { width: 180px; }</style>
<fuda-card class="small" title="Small"></fuda-card>

3Dで回すときの遠近は--fuda-perspective(初期値1000px)です。縁の色は--fuda-edgeで、任意のCSS背景を指定できます。初期値は、classicの枠が金、ほかの枠がカード用紙のクリーム色です。ドロップシャドウは要素そのものに付いているので、カードとその面の間にある要素にfilterを付けないでください。

プロパティとメソッド

メンバー内容
card.wear属性と同じ、摩耗のプリセット。空文字列を代入すると取り除かれる。
card.cardThicknessMm実際に使われる厚み。thickness、なければ素材の厚み、なければ0.325。
card.stackCount山の枚数。1から1000。
card.stackHeight山の高さ(ミリメートル)。
card.heldCount取り出した分を除いて、山に残っている枚数。
card.fanOpen山が扇状に開いているときに真。
card.isMoving画像がパンしているときに真。
card.takeOff(count?)、card.putBack(count?)カードを脇の山へ移す、戻す。
card.pileBounds開いた扇や脇の山がカードの外へ広がる距離。カードの幅を単位とする。
card.setFocused(on)autoplay="focus"のために、このカードをフォーカス状態にする、または外す。

pileBoundsが変わると、fuda-pileイベントが送られます。山、摩耗、動きのコードは別のモジュールです。アーキテクチャを参照してください。

関連するガイド

厚みと山:素材と山。使い込んだカード:摩耗。回転とパン:動きと回転。扇と取り出し:バインダーと山。

ソースを見るGitHub で編集@johnmorrisdotca/fuda-cards 0.11.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。