Live props در Inertia.js 3.11: آپدیت صفحه بدون polling
خلاصهٔ کاملتر
Inertia.js v3.11.0 و inertia-laravel v3.7.0 قابلیت live props رو اضافه کردن، که کارش Pascal Baljet بوده. live prop یعنی propی که هر وقت یه رویداد broadcast (پیامی که سرور از طریق WebSocket به کلاینتها میفرسته) برسه، خودش دوباره بارگذاری میشه. پس صفحه بدون polling، یعنی بدون اینکه هر چند ثانیه از سرور بپرسی چیزی عوض شده یا نه، بهروز میشه.
سمت سرور، prop رو با Inertia::live() میپیچی و رویدادی که باید تازهش کنه رو بهش میدی. Inertia کانالها رو از متد broadcastOn() همون رویداد میخونه:
return Inertia::render('Orders/Show', [
'order' => Inertia::live(fn () => $order->fresh(), on: new OrderUpdated($order)),
]);سمت کلاینت هم یه transport به createInertiaApp() میدی، مثلاً live: echo() که از Echo تنظیمشده با configureEcho() استفاده میکنه. وقتی OrderUpdated broadcast بشه، Inertia یه partial reload فقط برای prop order میزنه و propهایی که منتظر همون رویداد روی همون کانال هستن، با یه درخواست تازه میشن. پکیجهای @laravel/echo-vue، @laravel/echo-react و @laravel/echo-svelte وابستگی اختیاری هستن، پس اپهایی که از این قابلیت استفاده نمیکنن لازمشون ندارن.
آرگومان on آرایهای از رویدادها رو هم قبول میکنه و با channel میشه کانال رو دستی تعیین کرد. کانالهای public، private، presence و encrypted private همه پشتیبانی میشن. merge propها نمیتونن live باشن، ولی propهای deferred، once، optional و always متد ->live() رو قبول میکنن. reloadها بهطور پیشفرض برای هر prop حداکثر یه بار در ثانیه انجام میشن و این عدد با throttle (به میلیثانیه) برای هر prop یا کل اپ قابل تغییره. وقتی تب مخفیه هم reloadها صبر میکنن، مگه اینکه pauseWhenHidden: false بدی.
بهجای اینکه رویداد فقط به صفحه بگه «دوباره بارگذاری کن»، میشه مقدار جدید رو مستقیم با Inertia::broadcastProps() داخل متد broadcastWith() رویداد فرستاد تا صفحه هیچ درخواستی نزنه. فقط حواست باشه همهٔ مشترکهای اون کانال همین payload رو میگیرن، پس فقط دادهای بفرست که برای همهٔ کاربرهای اون کانال یکیه.
یه هوک جدید به اسم useProp() هم اومده که مقدار prop رو همراه فلگهای loading و loaded برمیگردونه؛ loading تا وقتی هر درخواستی، حتی بارگذاری deferred، داره اون prop رو تازه میکنه true میمونه. Inertia همچنین socket ID رو تو هدر X-Socket-Id میفرسته تا broadcast(...)->toOthers() درست کار کنه. transportهای pusher() برای هر کلاینت سازگار با Pusher و actionCable() برای Rails و AnyCable هم اضافه شدن و میشه transport سفارشی هم نوشت.
نکات کلیدی:
- live props تو Inertia.js v3.11.0 و inertia-laravel v3.7.0 اضافه شده
- Inertia::live() یه prop رو به یک یا چند رویداد broadcast وصل میکنه
- throttle پیشفرض یه reload در ثانیه برای هر prop هست
- Inertia::broadcastProps() مقدار رو داخل رویداد میفرسته و درخواست اضافه رو حذف میکنه
- merge propها نمیتونن live باشن
- transportها: echo() برای Echo و Reverb، pusher() و actionCable()




