refactor: susun semula struktur folder — Laravel source ke src/

This commit is contained in:
Saufi
2026-05-19 15:58:35 +08:00
parent f052251b94
commit bf53c71b45
10806 changed files with 1385379 additions and 121 deletions

View File

@@ -0,0 +1,181 @@
---
name: inertia-react-development
description: "Develops Inertia.js v1 React client-side applications. Activates when creating React pages, forms, or navigation; using Link or router; or when user mentions React with Inertia, React pages, React forms, or React navigation."
license: MIT
metadata:
author: laravel
---
@php
/** @var \Laravel\Boost\Install\GuidelineAssist $assist */
@endphp
# Inertia React Development
## Documentation
Use `search-docs` for detailed Inertia v1 React patterns and documentation.
## Basic Usage
### Page Components Location
React page components should be placed in the `{{ $assist->inertia()->pagesDirectory() }}` directory.
### Page Component Structure
@boostsnippet("Basic React Page Component", "react")
export default function UsersIndex({ users }) {
return (
<div>
<h1>Users</h1>
<ul>
{users.map(user => <li key={user.id}>{user.name}</li>)}
</ul>
</div>
)
}
@endboostsnippet
### Client-Side Navigation
Use `<Link>` for client-side navigation (not `<a>` tags):
@boostsnippet("Inertia React Navigation", "react")
import { Link } from '@inertiajs/react'
<Link href="/">Home</Link>
<Link href="/users">Users</Link>
<Link href={`/users/${user.id}`}>View User</Link>
@endboostsnippet
### Link With Method
@boostsnippet("Link with POST Method", "react")
import { Link } from '@inertiajs/react'
<Link href="/logout" method="post" as="button">
Logout
</Link>
@endboostsnippet
### Programmatic Navigation
@boostsnippet("Router Visit", "react")
import { router } from '@inertiajs/react'
function handleClick() {
router.visit('/users')
}
// Or with options
router.visit('/users', {
method: 'post',
data: { name: 'John' },
onSuccess: () => console.log('Success!'),
})
@endboostsnippet
## Form Handling
### Using `router.post`
@boostsnippet("Form With router.post", "react")
import { router } from '@inertiajs/react'
import { useState } from 'react'
export default function CreateUser() {
const [values, setValues] = useState({
name: '',
email: '',
})
const [processing, setProcessing] = useState(false)
function handleSubmit(e) {
e.preventDefault()
setProcessing(true)
router.post('/users', values, {
onFinish: () => setProcessing(false),
})
}
return (
<form onSubmit={handleSubmit}>
<input
type="text"
value={values.name}
onChange={e => setValues({ ...values, name: e.target.value })}
/>
<input
type="email"
value={values.email}
onChange={e => setValues({ ...values, email: e.target.value })}
/>
<button type="submit" disabled={processing}>
Create User
</button>
</form>
)
}
@endboostsnippet
### Using `useForm` Hook (If Available)
Check the Inertia documentation to confirm if `useForm` is available in your version:
@boostsnippet("useForm Hook Example", "react")
import { useForm } from '@inertiajs/react'
export default function CreateUser() {
const { data, setData, post, processing, errors } = useForm({
name: '',
email: '',
})
function submit(e) {
e.preventDefault()
post('/users')
}
return (
<form onSubmit={submit}>
<input
type="text"
value={data.name}
onChange={e => setData('name', e.target.value)}
/>
{errors.name && <div>{errors.name}</div>}
<input
type="email"
value={data.email}
onChange={e => setData('email', e.target.value)}
/>
{errors.email && <div>{errors.email}</div>}
<button type="submit" disabled={processing}>
Create User
</button>
</form>
)
}
@endboostsnippet
## Inertia v1 Limitations
Inertia v1 does not support these v2 features:
- `<Form>` component
- Deferred props
- Prefetching
- Polling
- Infinite scrolling with `WhenVisible`
- Merging props
Do not use these features in v1 projects.
## Common Pitfalls
- Using traditional `<a>` links instead of Inertia's `<Link>` component (breaks SPA behavior)
- Trying to use Inertia v2 features (deferred props, `<Form>` component, etc.) in v1 projects
- Using `<form>` without preventing default submission (use `e.preventDefault()`)
- Not handling loading states during form submission