使用法

  1. function MyTutorial() {
  2. const [ isOpen, setIsOpen ] = useState( true );
  3. if ( ! isOpen ) {
  4. return null;
  5. }
  6. return (
  7. <Guide
  8. onFinish={ () => setIsOpen( false ) }
  9. pages={ [
  10. {
  11. content: <p>Welcome to the ACME Store!</p>,
  12. },
  13. {
  14. image: <img src="https://acmestore.com/add-to-cart.png" />,
  15. content: (
  16. <p>
  17. Click <i>Add to Cart</i> to buy a product.
  18. </p>
  19. ),
  20. },
  21. ] }
  22. />
  23. );
  24. }

プロパティ

コンポーネントは以下のプロパティを受け入れます:

className

モーダルに追加するカスタムクラスです。

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

contentLabel

このプロパティはモーダルのアクセシビリティラベルとして使用されます。アクセシビリティの理由から必須です。

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

finishButtonText

ガイドの最後に表示されるFinishボタンのラベルをカスタマイズするために使用します。

  • タイプ: string
  • 必須: いいえ
  • デフォルト: 'Finish'

onFinish

ガイドが終了したときに呼び出される関数です。モーダルが閉じられるか、ユーザーがガイドの最後のページでFinishをクリックしたときにガイドは終了します。

  • タイプ: ( event?: KeyboardEvent< HTMLDivElement > | SyntheticEvent ) => void
  • 必須: はい

pages

ガイド内の各ページを説明するオブジェクトのリストです。各オブジェクトは必ず'content'プロパティを含む必要があり、オプションで'image'プロパティを含むことができます。

  • タイプ: { content: ReactNode; image?: ReactNode; }[]
  • 必須: いいえ
  • デフォルト: []