ColorSwatch
ColorSwatchは、色の見本を表示するコンポーネントです。
<ColorSwatch color="#186bf2" />
使い方
import { ColorSwatch } from "@yamada-ui/react"
import { ColorSwatch } from "@/components/ui"
import { ColorSwatch } from "@workspaces/ui"
<ColorSwatch />
バリアントを変更する
<Wrap gap="md">
<For each={["plain", "circle", "square"]}>
{(variant, index) => (
<ColorSwatch color="#186bf2" variant={variant} key={index} />
)}
</For>
</Wrap>
サイズを変更する
<Wrap gap="md" alignItems="center">
<For each={["2xs", "xs", "sm", "md", "lg", "xl", "2xl"]}>
{(size, index) => <ColorSwatch color="#186bf2" size={size} key={index} />}
</For>
</Wrap>
アルファ
アルファチャンネルを使った見本の作例です。
<VStack>
<Wrap gap="md">
{Object.entries(theme.colors.whiteAlpha).map(([key, color]) => (
<ColorSwatch key={key} color={color} />
))}
</Wrap>
<Wrap gap="md">
{Object.entries(theme.colors.blackAlpha).map(([key, color]) => (
<ColorSwatch key={key} color={color} />
))}
</Wrap>
</VStack>
影を無効にする
デフォルトでは、色を見やすくするためにインラインに影がついています。影を無効にする場合は、withShadowをfalseに設定します。
<ColorSwatch color="#186bf2" withShadow={false} />
グループ化する
複数の色を含む見本を作成する場合は、ColorSwatchGroupを使用します。
<Wrap gap="md">
<ColorSwatchGroup
items={["green.500", "green.600", "green.700", "green.800"]}
/>
<ColorSwatchGroup items={["red.500", "red.400", "red.300"]} />
<ColorSwatchGroup items={[]} />
</Wrap>
Props
アクセシビリティ
aria-labelを設定すると、スクリーンリーダーによって読み上げられます。
<ColorSwatch color="#4387f4" aria-label="Blue" />
ARIAロールと属性
| 要素 | ロールと属性 | 使い方 |
|---|---|---|
div.ui-color-swatch__root | role="img" | 画像であることを示します。 |
aria-roledescription="color swatch" | "color swatch"を設定します。 | |
aria-label | colorが文字列の場合はその値を設定します。ColorSwatchGroupから使用される場合は、colorSwatchの"Color swatch group"翻訳ラベル（ローカライズ済み）を設定します。 |
類似のコンポーネント
NativeTable
NativeTableは、データを効率的に整理して表示するコンポーネントです。
Stat
Statは、数値やデータをボックス内に表示するために使用されます。
Table
Tableは、列のソートや行の選択やクリックイベント機能を備えたテーブルのコンポーネントです。