قائمة مسار التنقل
يحتاج HasRelationNavigator إلى صفحة لها سجل: لدى ViewRecord وEditRecord والصفحات التي تستخدم InteractsWithRecord مسبقًا الدالتان اللتان يعلنهما، getRecord() وhasRecord(). في صفحة بلا سجل، ينبهك PHP إلى ذلك فور تحميل الصنف.
تظهر صفحة السجل في القائمة إذا، وفقط إذا، كانت تستخدم HasRelationNavigator: صفحة العرض أو صفحة التعديل أو أي صفحة مخصصة للسجل. في تلك الصفحات يفتح آخر عنصر في مسار التنقل القائمة. صفحات العلاقات مدرجة دائمًا، بعد صفحات السجل، مع أيقونات الـ relation managers وشاراتها، وفقط عندما يستطيع المستخدم رؤيتها.
إذا كانت الصفحة تبني عناصر مسار التنقل بنفسها، فمررها عبر withRelationNavigator():
/**
* @return array<string | int, string | Htmlable>
*/
public function getBreadcrumbs(): array
{
return $this->withRelationNavigator([
CustomerResource::getUrl('index') => 'Customers',
$this->getBreadcrumb(),
]);
}الصفحة المخصصة التي تستخدم InteractsWithRecord بنفسها، بدلًا من توسيع ViewRecord أو EditRecord، تصبح لديها دالتان getBreadcrumbs(). ما لم تعرّف دالتها الخاصة، أخبر PHP أيهما تفوز:
class CustomerActivity extends Page
{
use HasRelationNavigator, InteractsWithRecord {
HasRelationNavigator::getBreadcrumbs insteadof InteractsWithRecord;
InteractsWithRecord::getBreadcrumbs as getRecordBreadcrumbs;
}
}تستخدم القائمة $navigationLabel و$navigationIcon الخاصين بالصفحة، ولا تعرضها إلا عندما يسمح بذلك canAccess() لذلك السجل.