首页 > web前端 > js教程 > 使用 Laravel、Inertia.js v 和 Vue 3 实现无限滚动

使用 Laravel、Inertia.js v 和 Vue 3 实现无限滚动

Linda Hamilton
发布: 2024-12-20 21:17:15
原创
219 人浏览过

Implementing Infinite Scrolling with Laravel, Inertia.js v, and Vue 3

在这篇综合指南中,我们将探索如何使用 Inertia.js v2.0 和 Vue 3 在 Laravel 应用程序中实现无限滚动。我们将涵盖前端和后端实现,特别注意处理全页刷新和维护滚动位置。

目录

  • 了解组件
  • 前端实现
  • 后端实现
  • 现实示例:带有类别的博客文章
  • 最佳实践和注意事项

了解组件

无限滚动的实现依赖于三个主要组件:

  1. Inertia.js v2.0 的 WhenVisible 组件:该组件处理交叉观察者逻辑以检测何时需要加载更多内容。
  2. Laravel 的分页:处理服务器端分页逻辑。
  3. Vue 3 的 Composition API:管理我们的前端状态和反应性。

前端实施

让我们从一个为博客文章列表实现无限滚动的 Vue 组件开始:

<script setup>
import { computed } from 'vue'
import { usePage, WhenVisible } from '@inertiajs/vue3'
import LoadingSpinner from '@/components/LoadingSpinner.vue'
import BlogPostCard from '@/components/BlogPostCard.vue'

const page = usePage()

const hasFeaturePost = computed(() => !!page.props.featuredPost)
const categoryName = computed(() => page.props.category?.name)
</script>

<template>
    <div>



<h3>
  
  
  Key Frontend Features
</h3>

<ol>
<li><p><strong>WhenVisible Component</strong>: This component from Inertia.js v2.0 automatically triggers a request when the element becomes visible in the viewport.</p></li>
<li><p><strong>Pagination Parameters</strong>:<br>
</p></li>
</ol>

<pre class="brush:php;toolbar:false">:params="{
    data: {
        page: page.props.postsPagination.current_page + 1,
    },
    only: ['posts', 'postsPagination'],
}"
登录后复制
  • data:指定要加载的下一页
  • only:通过仅获取所需数据来优化请求
  1. 加载状态:组件优雅地处理加载和内容结束状态。

后端实施

这是处理常规分页和整页加载场景的 Laravel 控制器实现:

<?php

namespace App\Http\Controllers;

use App\Models\Post;
use App\Models\Category;
use Illuminate\Pagination\LengthAwarePaginator;
use Inertia\Inertia;

class BlogController extends Controller
{
    public function index(?Category $category = null)
    {
        return Inertia::render('Blog/Index', [
            'category' => $category,
            'featuredPost' => $this->getFeaturedPost(),
            'posts' => $this->getPaginatedPosts($category),
            'postsPagination' => $this->getPaginatedPosts($category)?->toArray(),
        ]);
    }

    protected function getPaginatedPosts(?Category $category): ?LengthAwarePaginator
    {
        $currentPage = request()->input('page', 1);
        $perPage = request()->input('per_page', 12);

        $query = Post::query()
            ->with(['author', 'category'])
            ->published();

        if ($category) {
            $query->where('category_id', $category->id);
        }

        // Apply any additional filters
        if (request()->has('sort')) {
            $query->orderBy(request()->input('sort'), request()->input('direction', 'desc'));
        } else {
            $query->latest();
        }

        // Handle full page load vs. infinite scroll request
        if (!request()->header('X-Inertia')) {
            // Full page load - fetch all pages up to current
            $allResults = collect();

            for ($page = 1; $page <= $currentPage; $page++) {
                $pageResults = $query->paginate($perPage, ['*'], 'page', $page);
                $allResults = $allResults->concat($pageResults->items());
            }

            return new LengthAwarePaginator(
                $allResults,
                Post::query()
                    ->published()
                    ->when($category, fn($q) => $q->where('category_id', $category->id))
                    ->count(),
                $perPage,
                $currentPage
            );
        }

        return $query->paginate($perPage);
    }

    protected function getFeaturedPost()
    {
        return Post::query()
            ->with(['author', 'category'])
            ->published()
            ->featured()
            ->latest()
            ->first();
    }
}
登录后复制

主要后端功能

  1. 分页处理
if (!request()->header('X-Inertia')) {
    // Full page load logic
} else {
    // Regular pagination for infinite scroll
}
登录后复制
  1. 整页加载:当用户刷新或直接访问页面时,我们会获取所有先前的页面以保持正确的滚动位置:
for ($page = 1; $page <= $currentPage; $page++) {
    $pageResults = $query->paginate($perPage, ['*'], 'page', $page);
    $allResults = $allResults->concat($pageResults->items());
}
登录后复制
  1. 高效查询:实现包括关系预加载和范围查询:
$query = Post::query()
    ->with(['author', 'category'])
    ->published();
登录后复制

结论

使用 Laravel 和 Inertia.js v2.0 实现无限滚动可提供流畅的用户体验,同时保持良好的性能和 SEO 实践。 Vue 3 的 Composition API 和 Inertia.js 的 WhenVisible 组件的结合使其易于实现和维护。

记住:

  • 彻底测试实现,特别是对于边缘情况
  • 监控性能指标
  • 考虑为禁用 JavaScript 的用户实施后备
  • 实现无限滚动时请记住可访问性

此实现可以适用于博客文章之外的各种用例,例如产品列表、图片库或任何其他受益于无限滚动的内容。

其他资源

  • Inertia.js 文档
  • Laravel 文档
  • Vue 3 文档
  • 无限滚动的网页可访问性指南

以上是使用 Laravel、Inertia.js v 和 Vue 3 实现无限滚动的详细内容。更多信息请关注PHP中文网其他相关文章!

来源:dev.to
本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
作者最新文章
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板