コンテンツにスキップ
Page

Label

フォームコントロールのテキストラベルです。必須マークを付けられます。

import { Label, LabelRequired } from "@pelagornis/page/components";

上のプレビューはこのファイルを描画したものです。src/components/ にコピーして使い始めてください。

src/components/LabelExample.tsx
import { Input, Label, LabelRequired, Stack } from "@pelagornis/page/components";
export default function LabelDemo() {
return (
<Stack gap="sizeLarge" className="w-full max-w-sm">
<Stack gap="sizeXSmall">
<Label htmlFor="label-name">
Name <LabelRequired />
</Label>
<Input id="label-name" placeholder="Jane Doe" fullWidth />
</Stack>
<Label size="lg">Large label</Label>
<Label disabled>Disabled label</Label>
</Stack>
);
}

Label は .mdx ページにそのまま書けます。frontmatter の下でインポートしてください。サーバーで描画されるので、client ディレクティブは要りません。

src/content/docs/example.mdx
---
title: Example
---
import { Label } from "@pelagornis/page/components";
<Label htmlFor="email" required>Email address</Label>

pageMarkdoc() がこのコンポーネントの label タグを登録します。markdoc.config.mjs にプリセットを一度追加すれば(Markdoc で使うを参照)、どの .mdoc ページでもタグを書けます。

src/content/docs/example.mdoc
{% label htmlFor="email" required=true %}Email address{% /label %}

属性の名前と値は React の props と同じです。

各 variant prop が受け付ける値です。

Prop値
sizesm md lg

コンポーネントを構成するパーツと、それぞれが描画する data-refineui のロールです。

パーツロール
rootlabel
requiredlabel-required