HasMany

# Основы

Поле HasMany предназначено для работы с одноименным отношением в Laravel и включает в себя все базовые методы.

Для создания данного поля используется статический метод make().

HasMany::make(
Closure|string $label,
?string $relationName = null,
Closure|string|null $formatted = null,
?ModelResource $resource = null
)
  • $label - лейбл, заголовок поля,
  • $relationName - название отношения,
  • $resource - ресурс модели на которую ссылается отношение.

Параметр $formatted не используется в поле HasMany!

Наличие ресурса модели, на которую ссылается отношение, обязательно!
Ресурс также необходимо зарегистрировать в сервис провайдере MoonShineServiceProvider в методе menu() или resources(). Иначе, будет 404 ошибка.

use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', 'comments', resource: new CommentResource())
];
}
 
//...

Если не указать $relationName, то название отношения будет определено автоматически на основе $label.

use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
];
}
 
//...

Можно не указывать $resource, если ресурс модели соответствует названию отношения.

use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', 'comments')
];
}
 
//...

# Поля

Метод fields() позволят задать поля, которые будут отображаться в preview.

fields(Fields|Closure|array $fields)
use MoonShine\Fields\Relationships\BelongsTo;
use MoonShine\Fields\Relationships\HasMany;
use MoonShine\Fields\Text;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
->fields([
BelongsTo::make('User'),
Text::make('Text'),
])
];
}
 
//...

# Создание объекта отношения

Метод creatable() позволяет создавать новый объект отношения через модальное окно.

creatable(
Closure|bool|null $condition = null,
?ActionButton $button = null,
)
use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
->creatable()
];
}
 
//...

Кастомизировать кнопку создания можно передав методу параметр button.

use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
->creatable(
button: ActionButton::make('Custom button', '')
)
];
}
 
//...

# Количество записей

Метод limit() позволяет ограничить количество записей отображаемых в preview.

limit(int $limit)
use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
->limit(1)
];
}
 
//...

Метод onlyLink() позволят отобразить отношение в виде ссылки с количеством элементов.

onlyLink(?string $linkRelation = null, Closure|bool|null $condition = null)

Методу можно передать необязательные параметры:

  • linkRelation - ссылка на отношение;
  • condition - замыкание или булево значение, отвечающее за отображение отношения как ссылки.

use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
->onlyLink()
];
}
 
//...
linkRelation

Для выборки значений отношения для родительского ресурса, необходимо в ресурсе отношения задать свойство $parentRelations.

namespace App\MoonShine\Resources;
 
use MoonShine\Resources\ModelResource;
 
class CommentResource extends ModelResource
{
//...
 
protected array $parentRelations = ['user'];
 
//...
}

Будет доступен маршрут:
/resource/comment-resource/index-page/user-{id}

Параметр linkRelation позволяет создать ссылку на отношение с привязкой родительского ресурса.

use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
->onlyLink('user')
];
}
 
//...
condition

Параметр condition через замыкание позволят изменять способ отображения в зависимости от условий.

use MoonShine\Fields\Relationships\HasMany;
 
//...
 
public function fields(): array
{
return [
HasMany::make('Comments', resource: new CommentResource())
->onlyLink(condition: function (int $count, Field $field): bool {
return $count > 10;
})
];
}
 
//...

# ID родителя

Если у связи есть ресурс, и необходимо получить ID родительского элемента, то можно воспользоваться трейтом ResourceWithParent.

use MoonShine\Resources\ModelResource;
use MoonShine\Traits\Resource\ResourceWithParent;
 
class PostImageResource extends ModelResource
{
use ResourceWithParent;
 
//...
}

При использовании трейта, необходимо определить методы:

protected function getParentResourceClassName(): string
{
return PostResource::class;
}
 
protected function getParentRelationName(): string
{
return 'post';
}

Для получения ID родителя используется метод getParentId().

$this->getParentId();

Рецепт: сохранение файлов в директории с ID родителя.