使用法

一般的なインターフェースを作成するには、Toolbarコンポーネント内でToolbarButtonをレンダリングする必要があります。

  1. import { Toolbar, ToolbarDropdownMenu } from '@wordpress/components';
  2. import {
  3. more,
  4. arrowLeft,
  5. arrowRight,
  6. arrowUp,
  7. arrowDown,
  8. } from '@wordpress/icons';
  9. function MyToolbar() {
  10. return (
  11. <Toolbar label="Options">
  12. <ToolbarDropdownMenu
  13. icon={ more }
  14. label="Select a direction"
  15. controls={ [
  16. {
  17. title: 'Up',
  18. icon: arrowUp,
  19. onClick: () => console.log( 'up' ),
  20. },
  21. {
  22. title: 'Right',
  23. icon: arrowRight,
  24. onClick: () => console.log( 'right' ),
  25. },
  26. {
  27. title: 'Down',
  28. icon: arrowDown,
  29. onClick: () => console.log( 'down' ),
  30. },
  31. {
  32. title: 'Left',
  33. icon: arrowLeft,
  34. onClick: () => console.log( 'left' ),
  35. },
  36. ] }
  37. />
  38. </Toolbar>
  39. );
  40. }

ブロックコントロールの内部

カスタムブロックに取り組んでいて、ブロックツールバーにコントロールを追加したい場合は、代わりに BlockControls を使用する必要があります。

  1. import { BlockControls } from '@wordpress/block-editor';
  2. import { Toolbar, ToolbarDropdownMenu } from '@wordpress/components';
  3. import {
  4. more,
  5. arrowLeft,
  6. arrowRight,
  7. arrowUp,
  8. arrowDown,
  9. } from '@wordpress/icons';
  10. function Edit() {
  11. return (
  12. <BlockControls group="block">
  13. <ToolbarDropdownMenu
  14. icon={ more }
  15. label="Select a direction"
  16. controls={ [
  17. {
  18. title: 'Up',
  19. icon: arrowUp,
  20. onClick: () => console.log( 'up' ),
  21. },
  22. {
  23. title: 'Right',
  24. icon: arrowRight,
  25. onClick: () => console.log( 'right' ),
  26. },
  27. {
  28. title: 'Down',
  29. icon: arrowDown,
  30. onClick: () => console.log( 'down' ),
  31. },
  32. {
  33. title: 'Left',
  34. icon: arrowLeft,
  35. onClick: () => console.log( 'left' ),
  36. },
  37. ] }
  38. />
  39. </BlockControls>
  40. );
  41. }

@

プロップス

このコンポーネントは DropdownMenu コンポーネントの同じAPIを受け入れます。