Ant Design 6 で非推奨になった props と、置き換え先の一覧
ライブラリの変化antd 6.6.8
Ant Design 6 では、いくつかの props が非推奨になり、開発中のコンソールに警告が出ます。このサイトの antd のデモでは、9 ページで 12 件の警告が出ていました。すべて新しい書き方に置き換えたので、その対応表をまとめます。置き換え先は、antd 6.6.8 の型定義(@deprecated)と、実行時の警告で確かめたものです。
置き換えの一覧
| コンポーネント | 非推奨 | 新しい書き方 |
|---|---|---|
| Drawer | width | size |
| Tabs | tabPosition | tabPlacement(左右は left / right → start / end) |
| Tabs | destroyInactiveTabPane | destroyOnHidden |
| Space | direction | orientation |
| Modal | maskClosable | mask={{ closable }} |
| Modal | focusTriggerAfterClose | focusable={{ focusTriggerAfterClose: true }} |
| notification | message | title |
| notification | btn | actions |
| Switch | size="default" | size="medium" |
| Button | iconPosition | iconPlacement |
書き換えの例
tsx
// Modal:背景クリックで閉じるかどうか
<Modal maskClosable={false} /> // 非推奨
<Modal mask={{ closable: false }} /> // antd 6
// notification:タイトルとボタン
notification.open({ message: '保存しました', btn: <Button>元に戻す</Button> }); // 非推奨
notification.open({ title: '保存しました', actions: <Button>元に戻す</Button> }); // antd 6
// Tabs:タブの位置
<Tabs tabPosition="left" /> // 非推奨
<Tabs tabPlacement="start" /> // antd 6気を付けるところ
- Tabs の左右は、名前だけでなく値も変わります。
left/rightではなくstart/endです。 - Drawer を枠の中に出すとき、
style={{ position: "absolute" }}は要りません。getContainer={false}を指定すると、antd が自分で位置を決めます。 - 非推奨の props は、いまも動きます。 警告が出るだけなので、気付きにくい変更です。開発中のコンソールで
[antd:から始まる警告を探すと見つかります。
このサイトで確かめたこと
- 9 ページで同じ操作(Drawer を開く、タブの位置を切り替える、モーダルの背景をクリックする、通知を出す)をして、antd の警告が 12 件から 0 件になりました。
- 置き換えの前後で、見た目と動きは同じでした。モーダルの背景クリック(閉じる・閉じない)と、通知のタイトル・ボタンも同じです。
- 各ページに載せているコード例は、antd 6.6.8 の型検査を通しています。
動くデモで確かめる
- サイドバー(Sidebar) →Drawer の size
- ハンバーガーメニュー →Drawer の size
- タブバー / ボトムナビ →Tabs の tabPlacement
- タブ(Tabs) →tabPlacement・destroyOnHidden
- モーダル・ダイアログ(Modal / Dialog) →mask の closable
- 通知・トースト(Notification / Toast) →title・actions
- バッジ・タグ(Badge / Tag) →Space の orientation
- チェックボックス・ラジオボタン(Checkbox / Radio) →Switch の size
- モーダル・ダイアログの制御 →逆引きのコード例
出典
この記事は、2026/11/03 の時点で、上のバージョンで確かめた内容です。