Ant Design 6 で非推奨になった props と、置き換え先の一覧

ライブラリの変化antd 6.6.8
非推奨 から antd 6 への置き換え:Drawer width → Drawer size、Tabs tabPosition → Tabs tabPlacement、notification message → notification title

Ant Design 6 では、いくつかの props が非推奨になり、開発中のコンソールに警告が出ます。このサイトの antd のデモでは、9 ページで 12 件の警告が出ていました。すべて新しい書き方に置き換えたので、その対応表をまとめます。置き換え先は、antd 6.6.8 の型定義(@deprecated)と、実行時の警告で確かめたものです。

置き換えの一覧

コンポーネント非推奨新しい書き方
Drawerwidthsize
TabstabPositiontabPlacement(左右は left / right → start / end)
TabsdestroyInactiveTabPanedestroyOnHidden
Spacedirectionorientation
ModalmaskClosablemask={{ closable }}
ModalfocusTriggerAfterClosefocusable={{ focusTriggerAfterClose: true }}
notificationmessagetitle
notificationbtnactions
Switchsize="default"size="medium"
ButtoniconPositioniconPlacement

書き換えの例

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 の型検査を通しています。

動くデモで確かめる

出典

この記事は、2026/11/03 の時点で、上のバージョンで確かめた内容です。