メインコンテンツへスキップ
見出し画像

React RouterやTanStackを使わないページ移動の実装方法 (Code-based routing)

    パッケージなしでページを遷移(コードでページを設定)

    React(+ Vite)アプリでページ切り替え(ルーティング)を実装する時には、React RouterやTanStack Routerを使うのが一般的です。

    しかしこれらを使わずともルーティングは可能なので、その簡単な方法を紹介します。

    本記事では、『コードでページを切り替える方法(Code-based routing)』を説明します。

    もう一つの方法である『ファイルでページを切り替える方式(File-based routing)』については、下記記事をご覧ください。

    まずはReact + Viteを用意しましょう。

    そしてindex.css内のコードはすべて消しておいてください。

    (*React + Viteのセットアップについてはこちらの記事をご覧ください)

    画像

    https://monotein.base.shop/p/00005


    ページの用意

    ページとして「About」、「Home」、そしてページが存在しない場合の「Not Found」のファイルを用意しましょう。

    画像

    各ファイルには次のように書きます。

    // Home.jsx
    
    const Home = () => {
        return (
            <div>
                <h1>Home</h1>
            </div>
        )
    }
    
    export default Home
    // About.jsx
    
    const About = () => {
        return (
            <div>
                <h1>About</h1>
            </div>
        )
    }
    
    export default About
    // NotFound.jsx
    
    const NotFound = () => {
        return (
            <div>
                <h1>Not Found</h1>
            </div>
        )
    }
    
    export default NotFound


    ページ切り替えの仕組みの用意

    App.jsxのコードをすべて消したら、次のように書いてください。

    // App.jsx
    
    const App = () => {
        return 
    }
    
    export default App

    現在のページを保存するために、stateを用意します。

    // App.jsx
    
    import { useState } from "react"        // 追加
    
    const App = () => {
        const [path, setPath] = useState(window.location.pathname)  // 追加
    
        return 
    }
    
    export default App

    そして、ブラウザのURLの変更を扱う次のコードを追加しましょう。

    // App.jsx
    
    import { useEffect, useState } from "react"    // 追加
    
    const App = () => {
        const [path, setPath] = useState(window.location.pathname)
    
        // ⬇追加
        const renderByUrl = () => {
            setPath(window.location.pathname)
        }
    
        useEffect(() => {
            window.addEventListener("popstate", renderByUrl)
            return () => window.removeEventListener("popstate", renderByUrl)
        }, [])
        // ⬆追加
    
        return
    }
    
    export default App

    最後に、先ほど作ったページをURLに合わせて表示するコードを加えます。

    // App.jsx
    
    import { useEffect, useState } from "react"
    import Home from "./Home"               // 追加
    import About from "./About"             // 追加
    import NotFound from "./NotFound"       // 追加
    
    const App = () => {
        const [path, setPath] = useState(window.location.pathname)
    
        const renderByUrl = () => {
            setPath(window.location.pathname)
        }
    
        useEffect(() => {
            window.addEventListener("popstate", renderByUrl)
            return () => window.removeEventListener("popstate", renderByUrl)
        }, [])
    
        // ⬇追加
        if (path === "/") return <Home />
        if (path === "/about") return <About />
        return <NotFound />
        // ⬆追加
    }
    
    export default App


    Linkタグの用意

    ページを移動するリンクに<a>タグを使い、次のように書くとします。

    <a href="/about">About</a>

    しかしこれではページがリロードされてしまい、SPA(Single Page Application)の特徴である「スムーズなページ遷移」にはなりません。

    なので、専用の<Link>タグを用意しましょう。

    Link.jsxを作ってください。

    画像

    次のように書きます。

    // Link.jsx
    
    export function Link({ to, children }) {
        const handleClick = (e) => {
        e.preventDefault()
        window.history.pushState({}, "", to)
        window.dispatchEvent(new PopStateEvent("popstate"))
    }
    
    return (
            <a href={to} onClick={handleClick}>
                {children}
            </a>
        )
    }
    
    export default Link
    画像

    https://monotein.base.shop/p/00005


    <Link>タグを各ページに読み込みましょう。

    // Home.jsx
    import Link from "./Link"      // 追加
    
    const Home = () => {
        return (
            <div>
                <h1>Home</h1>
                <Link to="/about">About</Link>   // 追加
            </div>
        )
    }
    
    export default Home
    // About.jsx
    import Link from "./Link"      // 追加
    
    const About = () => {
        return (
            <div>
                <h1>About</h1>
                <Link to="/home">Home</Link>    // 追加
            </div>
        )
    }
    
    export default About
    // NotFound.jsx
    import Link from "./Link"      // 追加
    
    const NotFound = () => {
        return (
            <div>
                <h1>Not Found</h1>
                <Link to="/home">Home</Link>      // 追加
            </div>
        )
    }
    
    export default NotFound

    これで、パッケージを使わない、コードベースでのルーティングをReactに実装できました。

    しかしこのようなマニュアル方式には限界もあります。


    この実装方法の限界

    ページが増えたときにコードも増えていく、動的ルートが扱いづらい、テストが書きづらいといった問題が典型的です。

    そのためやはり一般的には、React RouterやTanStack Routerといったパッケージを使うことになります。


    なお、もうひとつの切り替え方式である『ファイルでページを切り替える方法(File-based routing)』については、こちらの記事をご覧ください。

    画像

    https://monotein.base.shop/p/00005



    あなたへのおすすめ