logo

全局搜索

Nova 不仅允许你在特定的资源和关系中搜索,还可以使用 Nova 管理面板中顶部导航栏的全局搜索框对所有资源进行全局搜索:

Global Search

聚焦全局搜索

按键盘上的 /(正斜杠)键可以聚焦全局搜索输入。按下 ESC(回车键)也会关闭全局搜索输入。

标题 / 副标题属性

当资源显示在搜索结果中时,结果将显示资源的「title」 。例如,一个 User 资源可以使用它的 name 属性作为其标题。然后,当资源显示在全局搜索结果中时,将会显示它的 name 属性。

要自定义资源的「title」属性,可以在资源类上定义一个 title 属性:

php
/**
 * 显示资源时用于表示资源的单一值。
 *
 * @var string
 */
public static $title = 'name';

或者,你也可以覆盖资源的 title 方法:

php
/**
 * 显示资源时用于表示资源的单一值。
 *
 * @return string
 */
public function title()
{
    return $this->name;
}

在搜索结果中显示头像

你还可以通过在资源中添加 头像 字段,在搜索结果的标题旁显示资源的「头像」。

副标题

你还可以在全局搜索结果中显示一个较小的 「subtitle」 属性。副标题将展示在标题属性下。在下面的这张截图中,你可以看到 Post 资源的作者信息作为副标题展示,使得能够快速识别是谁撰写的帖子:

Global Search

要定义资源的副标题,应覆盖资源的 subtitle 方法:

php
/**
 * 获取资源的搜索结果副标题。
 *
 * @return string
 */
public function subtitle()
{
    return "Author: {$this->user->name}";
}

预加载

如果你的副标题访问的是相关资源的信息,则应考虑将相关资源添加到资源的 预加载

自定义

限制全局搜索结果数量

你可以通过覆盖资源上的 globalSearchResults 属性,限制通过全局搜索为给定资源返回的结果数量:

php
/**
 * 全局搜索时包含结果的最大数量。
 *
 * @var int
 */
public static $globalSearchResults = 5;

全局搜索频率

你可以使用 Nova::globalSearchDebounce方法配置全局搜索字段的间隔时间和频率。通常,应在应用程序的 NovaServiceProvider 中调用此方法:

php
Nova::globalSearchDebounce(1); // 1 秒

自定义 头像 / 封面

如果你正在创建一个 自定义字段,并希望将其作为全局搜索结果的「头像」/ 封面图片,那么你的字段应该实现 Laravel\Nova\Contracts\Cover 接口。该接口要求你定义一个 resolveThumbnailUrl 方法,该方法应返回所需的「封面图片」的 URL:

php
/**
 * 解析字段的缩略图 URL。
 *
 * @return string|null
 */
public function resolveThumbnailUrl()
{
    return 'https://www.example.com/avatar/'.md5(strtolower($this->value)).'?s=300';
}

禁用资源的全局搜索

默认情况下,所有 Nova 资源都可全局搜索;但你可以通过覆盖资源上的 globallySearchable 属性,将特定资源排除在全局搜索之外:

php
/**
 * 表示该资源是否应可全局搜索。
 *
 * @var bool
 */
public static $globallySearchable = false;

禁用全局搜索

如果你希望在 Nova 中完全禁用全局搜索,可以从你的 App/Providers/NovaServiceProvider 中调用 withoutGlobalSearch 方法:

php
use Laravel\Nova\Nova;

/**
 * 启动任何应用服务。
 *
 * @return void
 */
public function boot()
{
    parent::boot();

    Nova::withoutGlobalSearch();
}