使用法

階層のページの親ページを選択するためのユーザーインターフェースをレンダリングします:

  1. import { useState } from 'react';
  2. import { TreeSelect } from '@wordpress/components';
  3. const MyTreeSelect = () => {
  4. const [ page, setPage ] = useState( 'p21' );
  5. return (
  6. <TreeSelect
  7. __nextHasNoMarginBottom
  8. label="Parent page"
  9. noOptionLabel="No parent page"
  10. onChange={ ( newPage ) => setPage( newPage ) }
  11. selectedId={ page }
  12. tree={ [
  13. {
  14. name: 'Page 1',
  15. id: 'p1',
  16. children: [
  17. { name: 'Descend 1 of page 1', id: 'p11' },
  18. { name: 'Descend 2 of page 1', id: 'p12' },
  19. ],
  20. },
  21. {
  22. name: 'Page 2',
  23. id: 'p2',
  24. children: [
  25. {
  26. name: 'Descend 1 of page 2',
  27. id: 'p21',
  28. children: [
  29. {
  30. name: 'Descend 1 of Descend 1 of page 2',
  31. id: 'p211',
  32. },
  33. ],
  34. },
  35. ],
  36. },
  37. ] }
  38. />
  39. );
  40. }

プロパティ

コンポーネントが受け入れるプロパティのセットは以下に示されます。

このセットに含まれていないプロパティは、使用されるSelectControlコンポーネントに適用されます。

ラベル

このプロパティが追加されると、ラベルプロパティをコンテンツとして使用してラベルが生成されます。

  • タイプ: String
  • 必須: いいえ

オプションなしラベル

このプロパティが追加されると、空の選択を表すためにこのラベルを持つオプションが追加されます。

  • タイプ: String
  • 必須: いいえ

変更時

選択されている新しいノード要素のIDを受け取る関数です。

  • タイプ: function
  • 必須: はい

選択されたID

現在選択されているノードのIDです。

  • タイプ: string | string[]
  • 必須: いいえ

ツリー

ユーザーが選択できる可能性のあるノードを持つツリーオブジェクトの配列です。

  • タイプ: Object[]
  • 必須: いいえ

__nextHasNoMarginBottom

将来のバージョンでデフォルトになる新しいマージンなしスタイルを選択し始めます。

  • タイプ: Boolean
  • 必須: いいえ
  • デフォルト: false