Dữ liệu dùng chung

Đây là tài liệu Inertia.js v1, phiên bản không còn được duy trì tích cực. Vui lòng tham khảo tài liệu v3.

Đôi khi bạn cần truy cập một số dữ liệu cụ thể trên nhiều trang trong ứng dụng. Ví dụ, bạn có thể cần hiển thị người dùng hiện tại trong header của website. Việc truyền thủ công dữ liệu này trong từng response trên toàn ứng dụng khá bất tiện. May mắn là có một lựa chọn tốt hơn: dữ liệu dùng chung.

Chia sẻ dữ liệu

Tất cả adapter phía máy chủ của Inertia đều cung cấp một cách để đưa dữ liệu dùng chung vào mọi request. Việc này thường được thực hiện bên ngoài controller. Dữ liệu dùng chung sẽ tự động được merge với page props mà controller cung cấp. Trong ứng dụng Laravel, việc này thường do middleware HandleInertiaRequests xử lý; middleware này được tự động cài đặt khi bạn cài adapter phía máy chủ.

class HandleInertiaRequests extends Middleware
{
    public function share(Request $request)
    {
        return array_merge(parent::share($request), [
            // Synchronously...
            'appName' => config('app.name'),

            // Lazily...
            'auth.user' => fn () => $request->user()
                ? $request->user()->only('id', 'name', 'email')
                : null,
        ]);
    }
}

Ngoài ra, bạn có thể chia sẻ dữ liệu thủ công bằng phương thức Inertia::share.

use Inertia\Inertia;

// Synchronously...
Inertia::share('appName', config('app.name'));

// Lazily...
Inertia::share('user', fn (Request $request) => $request->user()
    ? $request->user()->only('id', 'name', 'email')
    : null
);

Nên sử dụng dữ liệu dùng chung một cách tiết chế vì toàn bộ dữ liệu dùng chung được gửi kèm trong mọi response. Page props và dữ liệu dùng chung được merge với nhau, vì vậy hãy namespace dữ liệu dùng chung phù hợp để tránh xung đột.

Truy cập dữ liệu dùng chung

Sau khi chia sẻ dữ liệu ở phía máy chủ, bạn có thể truy cập dữ liệu đó trong bất kỳ trang hoặc component nào. Sau đây là ví dụ cách truy cập dữ liệu dùng chung trong một layout component.

<template>
    <main>
        <header>
            You are logged in as: {{ user.name }}
        </header>
        <article>
            <slot />
        </article>
    </main>
</template>

<script>
export default {
    computed: {
        user() {
            return this.$page.props.auth.user
        }
    }
}
</script>

<script setup>
import { computed } from 'vue'
import { usePage } from '@inertiajs/vue3'

const page = usePage()

const user = computed(() => page.props.auth.user)
</script>

<template>
    <main>
        <header>
            You are logged in as: {{ user.name }}
        </header>
        <article>
            <slot />
        </article>
    </main>
</template>

import { usePage } from '@inertiajs/react'

export default function Layout({ children }) {
    const { auth } = usePage().props

    return (
        <main>
            <header>
                You are logged in as: {auth.user.name}
            </header>
            <article>
                {children}
            </article>
        </main>
    )
}

<script>
    import { page } from '@inertiajs/svelte'
</script>

<main>
    <header>
        You are logged in as: {$page.props.auth.user.name}
    </header>
    <article>
        <slot />
    </article>
</main>

Flash message

Một trường hợp sử dụng rất phù hợp khác của dữ liệu dùng chung là flash message. Đây là các message được lưu trong session chỉ cho request kế tiếp. Ví dụ, một cách phổ biến là đặt flash message sau khi hoàn tất một tác vụ và trước khi redirect sang trang khác. Sau đây là một cách đơn giản để triển khai flash message trong ứng dụng Inertia. Trước tiên, hãy chia sẻ flash message trên mỗi request.

class HandleInertiaRequests extends Middleware
{
    public function share(Request $request)
    {
        return array_merge(parent::share($request), [
            'flash' => [
                'message' => fn () => $request->session()->get('message')
            ],
        ]);
    }
}

Tiếp theo, hiển thị flash message trong một component frontend, chẳng hạn layout của website.

<template>
    <main>
        <header></header>
        <article>
            <div v-if="$page.props.flash.message" class="alert">
                {{ $page.props.flash.message }}
            </div>
            <slot />
        </article>
        <footer></footer>
    </main>
</template>

<template>
    <main>
        <header></header>
        <article>
            <div v-if="$page.props.flash.message" class="alert">
                {{ $page.props.flash.message }}
            </div>
            <slot />
        </article>
        <footer></footer>
    </main>
</template>

import { usePage } from '@inertiajs/react'

export default function Layout({ children }) {
    const { flash } = usePage().props

    return (
        <main>
            <header></header>
            <article>
                {flash.message && (
                    <div class="alert">{flash.message}</div>
                )}
                {children}
            </article>
            <footer></footer>
        </main>
    )
}

<script>
    import { page } from '@inertiajs/svelte'
</script>

<main>
    <header></header>
    <article>
        {#if $page.props.flash.message}
            <div class="alert">{$page.props.flash.message}</div>
        {/if}
        <slot />
    </article>
    <footer></footer>
</main>

Tài liệu chính thức

Bài dịch này được đối chiếu từ tài liệu Inertia.js v1 chính thức. Nếu có khác biệt do phiên bản hoặc cập nhật mới, hãy ưu tiên tài liệu chính thức làm nguồn tham chiếu.

Bắt đầu

Cài đặt

Khái niệm cốt lõi

Kiến thức cơ bản

Nâng cao

Chia sẻ dữ liệu

Truy cập dữ liệu dùng chung

Flash message

Tài liệu chính thức

​Chia sẻ dữ liệu

​Truy cập dữ liệu dùng chung

​Flash message

​Tài liệu chính thức

Chia sẻ dữ liệu

Truy cập dữ liệu dùng chung

Flash message

Tài liệu chính thức