Button
pill 形のボタンです。href を渡すとリンク(<a>)、渡さなければ <button> として描きます。
tsx
import { Button } from '../../src'
export default function ButtonDemo() {
return <Button>参加方法を見る</Button>
}使い方
tsx
import { Button } from '@under18dev/ui'
<Button>参加方法を見る</Button>例
種類
primary は画面で最も重要な操作に使います。1つの画面に1つまでです。それ以外の操作は secondary にします。
tsx
import { Button, ButtonGroup } from '../../src'
export default function ButtonVariants() {
return (
<ButtonGroup>
<Button>主要な操作</Button>
<Button variant="secondary">補助の操作</Button>
</ButtonGroup>
)
}リンク
href を渡すとリンクになります。arrow を付けると末尾に矢印が付き、同じサイトの中なら →、別のサイトなら ↗ になります。http(s):// のリンクは自動で新しいタブで開き、スクリーンリーダーには「(新しいタブで開く)」と読み上げます。
tsx
import { Button, ButtonGroup } from '../../src'
export default function ButtonLink() {
return (
<ButtonGroup>
{/* 同じサイトの中へのリンクは → */}
<Button href="#events" arrow>
イベントを見る
</Button>
{/* http(s) のリンクは新しいタブで開き、↗ になる */}
<Button href="https://github.com/under18dev" variant="secondary" arrow>
GitHub
</Button>
</ButtonGroup>
)
}大きさ
ヘッダーのように場所が限られるところでは size="sm" を使います。どちらもタップできる範囲は 44px 以上あります。
tsx
import { Button, ButtonGroup } from '../../src'
export default function ButtonSizes() {
return (
<ButtonGroup>
<Button>標準(48px)</Button>
<Button size="sm">小さめ(44px)</Button>
</ButtonGroup>
)
}無効
押せないボタンは破線にして、色だけでなく形でも押せないことを伝えます。
tsx
import { Button } from '../../src'
export default function ButtonDisabled() {
return <Button disabled>受付終了</Button>
}Props
| Prop | 型 | 既定値 | 説明 |
|---|---|---|---|
variant | 'primary' | 'secondary' | 'primary' | 見た目の種類 |
size | 'md' | 'sm' | 'md' | 高さ。md は 48px、sm は 44px |
href | string | — | 指定するとリンクとして描く |
external | boolean | — | 新しいタブで開くか。省略すると http(s) のリンクだけ新しいタブ |
arrow | boolean | false | 末尾に矢印を付ける |
fullWidth | boolean | false | 横幅いっぱいに広げる |
そのほかの属性(onClick、type、disabled、aria-* など)は、そのまま <button> か <a> に渡します。
ButtonGroup
ボタンを横に並べ、狭い画面では折り返します。間隔は 12px です。
アクセシビリティ
- フォーカスしたときは 2px の枠線を、2px 離して表示します。
- 押している間だけ少し縮みます。動きを減らす設定では、すぐに切り替わります。
- 内部リンクは
LinkProviderに渡したコンポーネント(Next.js のLinkなど)で描きます。