Dữ liệu dùng chung

Đô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

Mọi server-side adapter của Inertia đều cung cấp phương thức để shared data có sẵn cho mỗi request. Việc này thường được thực hiện ngoài controller. Shared data tự động merge với page props được cung cấp trong controller. Trong ứng dụng Laravel, việc này thường do middleware HandleInertiaRequests xử lý, middleware được tự động cài khi cài server-side adapter.

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.

Chia sẻ once props

Bạn có thể chia sẻ dữ liệu chỉ resolve một lần và được client ghi nhớ qua các lần điều hướng tiếp theo bằng once props.

class HandleInertiaRequests extends Middleware
{
    public function share(Request $request)
    {
        return array_merge(parent::share($request), [
            'countries' => Inertia::once(fn () => Country::all()),
        ]);
    }
}

Ngoài ra, bạn có thể định nghĩa riêng phương thức shareOnce() trong middleware. Middleware sẽ đánh giá cả share() và shareOnce(), sau đó gộp kết quả.

class HandleInertiaRequests extends Middleware
{
    public function shareOnce(Request $request): array
    {
        return array_merge(parent::shareOnce($request), [
            'countries' => fn () => Country::all(),
        ]);
    }
}

Bạn cũng có thể chia sẻ once props thủ công bằng phương thức Inertia::shareOnce().

Inertia::shareOnce('countries', fn () => Country::all());

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.

<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>

TypeScript

Bạn có thể cấu hình shared props type toàn cục bằng declaration merging của TypeScript.

Flash data

Với thông báo một lần như toast hoặc success alert, bạn có thể dùng flash data. Khác shared data, flash data không được lưu trong browser history state nên không xuất hiện lại khi điều hướng qua history.

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 v3 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

Dữ liệu & Props

Bảo mật

Nâng cao

Chia sẻ dữ liệu

Chia sẻ once props

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

TypeScript

Flash data

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

​Chia sẻ dữ liệu

​Chia sẻ once props

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

​TypeScript

​Flash data

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

Chia sẻ dữ liệu

Chia sẻ once props

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

TypeScript

Flash data

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