Text entry - 信息列表

简介

文本条目用于展示简单文本：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('title')

自定义颜色

你可以为文本设置颜色：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('status')
    ->color('primary')

除了允许静态值之外，color() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

添加图标

你可以为文本条目添加图标：

use Filament\Infolists\Components\TextEntry;
use Filament\Support\Icons\Heroicon;

TextEntry::make('email')
    ->icon(Heroicon::Envelope)

icon() 方法也接受一个函数来动态计算图标。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

使用 iconPosition() 你可以设置图标的位置：

use Filament\Infolists\Components\TextEntry;
use Filament\Support\Enums\IconPosition;
use Filament\Support\Icons\Heroicon;

TextEntry::make('email')
    ->icon(Heroicon::Envelope)
    ->iconPosition(IconPosition::After) // `IconPosition::Before` or `IconPosition::After`

iconPosition() 方法也接受一个函数来动态计算图标位置。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

图标颜色默认为文本颜色，如果要自定义图标颜色，请使用 iconColor()：

use Filament\Infolists\Components\TextEntry;
use Filament\Support\Icons\Heroicon;

TextEntry::make('email')
    ->icon(Heroicon::Envelope)
    ->iconColor('primary')

iconColor() 方法也接受一个函数来动态计算图标颜色。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

显示成”徽章”

默认情况下，文本很简单且没有背景色。你可以使用 badge() 方法使之显示成徽章。这一功能的一个很好的用例是带状态的文本，你可能想要显示与该状态相匹配的颜色徽章：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('status')
    ->badge()
    ->color(fn (string $state): string => match ($state) {
        'draft' => 'gray',
        'reviewing' => 'warning',
        'published' => 'success',
        'rejected' => 'danger',
    })

你也可以添加其他东西到徽章中，比如图标。

此外，你也可以传入一个布尔值，用以控制文本是否应该以徽章显示：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('status')
    ->badge(FeatureFlag::active())

除了允许静态值之外，badge() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

格式化

当使用文本条目时，你可能希望在 UI 中实际输出不同于该条目原始状态值的文本，原始值通常自动从 Eloquent 模型中检索而来。格式化状态在保留原始数据的完整性的同时，允许你将其以对用户更友好的方式展示。

要在不改变原始状态值的同时格式化文本条目的值，你可以使用 formatStateUsing() 方法。该方法允许你接受一个函数，该函数接受状态值作为参数并返回格式化后的值：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('status')
    ->formatStateUsing(fn (string $state): string => __("statuses.{$state}"))

上例中，数据库的 status 字段可能包含 draft、reviewing、published 或者 rejected 等值，而格式化后的状态值为这些值的翻译后的版本。

传入 formatStateUsing() 的函数可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

日期格式化

除了传入函数到 formatStateUsing() 之外，你可以使用 date()、dateTime() 和 time() 方法，使用 PHP 日期格式化 token 将 Entry 的值格式化：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->date()

TextEntry::make('created_at')
    ->dateTime()

TextEntry::make('created_at')
    ->time()

你也可以传入自定义格式化字符串到 date()、dateTime() 或者 time() 方法，自定义日期格式。你可以使用 PHP 日期格式化 token作为格式化字符串值：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->date('M j, Y')
    
TextEntry::make('created_at')
    ->dateTime('M j, Y H:i:s')
    
TextEntry::make('created_at')
    ->time('H:i:s')

除了允许静态值之外，date()、dateTime() 和 time() 方法也接受一个函数来动态计算其格式。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

使用 Carbon 的 macro 格式格式化日期

你也可以使用 isoDate()、isoDateTime() 和 isoTime() 方法，使用 Carbon 的 macro 格式来格式化条目值：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->isoDate()

TextEntry::make('created_at')
    ->isoDateTime()

TextEntry::make('created_at')
    ->isoTime()

通过将自定义宏格式化字符串传入到 isoDate()、isoDateTime() 或者 isoTime() 方法，你可以自定义日期格式化。你可以使用 Carbon 的宏格式：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->isoDate('L')

TextEntry::make('created_at')
    ->isoDateTime('LLL')

TextEntry::make('created_at')
    ->isoTime('LT')

除了允许静态值之外，isoDate()、isoDateTime() 和 isoTime() 方法也接受一个函数来动态计算其格式。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

格式化相对日期

你也可以使用 since()，使用 Carbon 的 diffForHumans() 将 Entry 值格式化:

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->since()

Text entry with relative date formatting

另外，你也可以使用 dateTooltip()、dateTimeTooltip()、timeTooltip()、isoDateTooltip()、isoDateTimeTooltip()、isoTime()、isoTimeTooltip() 或者 sinceTooltip() 方法在 Tooltip 中展示格式化日期，通常用于提供额外信息。

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->since()
    ->dateTooltip() // Accepts a custom PHP date formatting string

TextEntry::make('created_at')
    ->since()
    ->dateTimeTooltip() // Accepts a custom PHP date formatting string

TextEntry::make('created_at')
    ->since()
    ->timeTooltip() // Accepts a custom PHP date formatting string

TextEntry::make('created_at')
    ->since()
    ->isoDateTooltip() // Accepts a custom Carbon macro format string

TextEntry::make('created_at')
    ->since()
    ->isoDateTimeTooltip() // Accepts a custom Carbon macro format string

TextEntry::make('created_at')
    ->since()
    ->isoTimeTooltip() // Accepts a custom Carbon macro format string

TextEntry::make('created_at')
    ->dateTime()
    ->sinceTooltip()

Text entry with a date tooltip on relative dates

为格式化设置时区

上述每个日期格式化方法同时也接受一个 timezone 参数，该参数允许你将状态中的时间设置转换到不同的时区：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->dateTime(timezone: 'America/New_York')

你也可以将时区传递给条目的 timezone 方法，以一次性将时区应用到所有日期时间格式化方法中：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')
    ->timezone('America/New_York')
    ->dateTime()

除了允许静态值之外，timezone() 方法也接受一个函数来动态计算时区。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

如果你未传递时区给条目，它将使用 Filament 默认的时区。你可以在服务提供者(如 AppServiceProvider) 的 boot() 方法中使用 FilamentTimezone::set() 方法设置默认时区：

use Filament\Support\Facades\FilamentTimezone;

public function boot(): void
{
    FilamentTimezone::set('America/New_York');
}

这对于设置适用于应用中所有文本条目的默认时区非常有用。它同时对 Filament 中用到时区的其他地方有效。

NOTE

Filament 的默认时区只有在条目保存时间时适用。如果条目只保存日期(实用 date() 而非 dateTime())，那么时区将不适用。这是为了避免保存日期而未保存时间时产生时区转换。

数字格式化

numeric() 方法允许你将 Entry 格式化为数字，而不必通过传入函数到 formatStateUsing():

use Filament\Infolists\Components\TextEntry;

TextEntry::make('stock')
    ->numeric()

如果你想自定义用于格式化数字的小数位数，你可以使用 decimalPlaces 参数：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('stock')
    ->numeric(decimalPlaces: 0)

除了允许静态值之外，decimalPlaces 参数也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

默认情况下，你的应用的本地化语言将被用于格式化数字。如果你想要自定义本地化语言，你可以使用 locale 参数：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('stock')
    ->numeric(locale: 'nl')

除了允许静态值之外，locale 参数也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

货币格式化

money() 方法允许你轻松格式化任何货币的金额值：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('price')
    ->money('EUR')

除了允许静态值之外，money() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

money() 也有一个 divideBy 参数，允许你在格式化之前将原始值除以一个数字。如果你的数据库将价格以分的形式存储，这很有用，比如：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('price')
    ->money('EUR', divideBy: 100)

除了允许静态值之外，divideBy 参数也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

默认情况下，应用的本地化语言将用于格式化金额，如果你想自定义使用的本地化语言，你可以将其传递给 locale 参数：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('price')
    ->money('EUR', locale: 'nl')

除了允许静态值之外，locale 参数也接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

如果你想要自定义用于格式化数字的小数位数，可以使用 decimalPlaces 参数：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('price')
    ->money('EUR', decimalPlaces: 3)

除了允许静态值之外，decimalPlaces 参数也可以接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

渲染 Markdown

如果你的 Entry 值是 Markdown，你可以使用 markdown() 对其进行渲染：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->markdown()

此外，你也可以传入一个布尔值，控制文本是否以 Markdown 渲染：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->markdown(FeatureFlag::active())

除了允许静态值之外，markdown() 方法也接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

渲染 HTML

如果你的 Entry 值是 HTML，你可以使用 html() 对其进行渲染：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->html()

或者，你也可以传入布尔值以控制文本是否以 HTML 渲染：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->html(FeatureFlag::active())

除了允许静态值之外，html() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

NOTE

Filament’s built-in HTML sanitizer permits inline style attributes in order to support rich text formatting features such as font colors, text highlighting, and image sizing. This means that CSS properties like background: url(...) or position: fixed will not be stripped from sanitized HTML. If your content comes from untrusted users, you should consider restricting the default configuration. See the security documentation for details on how to customize the sanitizer.

渲染无净化的原始 HTML

如果使用此方法，则 HTML 将在渲染之前进行净化，以删除任何潜在的不安全内容。如果你想退出这种行为，你可以通过格式化将 HTML 包装在一个 HtmlString 对象中：

use Filament\Infolists\Components\TextEntry;
use Illuminate\Support\HtmlString;

TextEntry::make('description')
    ->formatStateUsing(fn (string $state): HtmlString => new HtmlString($state))

NOTE

渲染原始 HTML 时要小心，因为它可能包含恶意内容，这可能会导致应用中的安全漏洞，如跨站脚本(XSS)攻击。在使用此方法之前，请始终确保正在渲染的 HTML 是安全的。

或者，你也可以从 formatStateUsing() 方法返回一个 view() 对象，该对象不会被净化：

use Filament\Infolists\Components\TextEntry;
use Illuminate\Contracts\View\View;

TextEntry::make('description')
    ->formatStateUsing(fn (string $state): View => view(
        'filament.infolists.components.description-entry-content',
        ['state' => $state],
    ))

展示多个值

如果文本条目的 state 是数组，那么该文本条目可以渲染多个值。如果你的 Eloquent 属性使用了 array 强制转换(cast)，或者 Eloquent 关联有多个结果，又或者你将一个数组传入到 state() 方法中，就会出现这种情况。如果你的文本条目中有多个值，那么它们会使用逗号隔开。你可以使用 listWithLineBreaks() 方法将其显示为多行：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('authors.name')
    ->listWithLineBreaks()

或者，你也可以传入布尔值以控制是否应该以多行显示每一项：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('authors.name')
    ->listWithLineBreaks(FeatureFlag::active())

除了允许静态值之外，listWithLineBreaks() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

列表中添加点号

使用 bulleted() 方法，你可以为每个列表项添加点号：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('authors.name')
    ->bulleted()

Text entry with multiple values and bullet points

此外，你也可以传入一个布尔值，控制文本是否添加点号：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('authors.name')
    ->bulleted(FeatureFlag::active())

除了允许静态值之外，bulleted() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

限制列表中值的数量

使用 limitList() 方法，你可以限制列表中值的数量：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('authors.name')
    ->listWithLineBreaks()
    ->limitList(3)

除了允许静态值之外，limitList() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

展开限制列表

使用 expandableLimitedList() 方法，你可以允许受限制项目展开或者折叠：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('authors.name')
    ->listWithLineBreaks()
    ->limitList(3)
    ->expandableLimitedList()

NOTE

请注意这只是 listWithLineBreaks() 或 bulleted() 的一个功能，其中的每一项都由自己的功能。

或者，你也可以传入布尔值以控制文本是否可展开：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('authors.name')
    ->listWithLineBreaks()
    ->limitList(3)
    ->expandableLimitedList(FeatureFlag::active())

除了允许静态值之外，expandableLimitedList() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

Text entry with an expandable limited list

使用列表分隔符

如果你想将模型中的文本字符串打散(explode)成多个列表项，你可以使用 separator() 方法。这对于将以逗号分隔的标签以徽章的方式显示很有用。比如：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('tags')
    ->badge()
    ->separator(',')

Text entry with badges from comma-separated values

除了允许静态值之外，separator() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

聚合关联

Filament 提供了几种聚合关联字段的方法，包括 avg()、max()、min() 和 sum()。例如，如果你想在所有关联记录上显示一个字段的平均值，你可以使用 avg() 方法：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('users_avg_age')->avg('users', 'age')

上例中，users 是关联名，age 是求平均值的字段。该条目的名称必须是 users_avg_age，因为这是 Laravel 用来保存结果的规范。

如果你想在计算前限定关联的查询范围，你可以传入数组到该方法中，其中键为关联名，值是 Eloquent 查询限定的函数：

use Filament\Infolists\Components\TextEntry;
use Illuminate\Database\Eloquent\Builder;

TextEntry::make('users_avg_age')->avg([
    'users' => fn (Builder $query) => $query->where('is_active', true),
], 'age')

自定义文本大小

文本条目默认使用小号字体，你可以将其修改为 TextSize::ExtraSmall、TextSize::Medium 或者 TextSize::Large。

比如，你可以使用 size(TextEntrySize::Large) 让文本变大：

use Filament\Infolists\Components\TextEntry;
use Filament\Support\Enums\TextSize;

TextEntry::make('title')
    ->size(TextSize::Large)

自定义字体粗细

文本条目(TextEntry)默认情况下使用常规字体粗细，不过你可以将其修改为以下选项：FontWeight::Thin、FontWeight::ExtraLight、FontWeight::Light、FontWeight::Medium、FontWeight::SemiBold、FontWeight::Bold、FontWeight::ExtraBold 或 FontWeight::Black。

比如，你可以使用 weight(FontWeight::Bold) 让字体变粗：

use Filament\Infolists\Components\TextEntry;
use Filament\Support\Enums\FontWeight;

TextEntry::make('title')
    ->weight(FontWeight::Bold)

除了允许静态值之外，weight() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

自定义字体

你可以将字体(font family)修改为以下选项：FontFamily::Sans、FontFamily::Serif 或 FontFamily::Mono。

比如，使用 fontFamily(FontFamily::Mono) 你可以将字体设为 Monospaced 字体：

use Filament\Support\Enums\FontFamily;
use Filament\Infolists\Components\TextEntry;

TextEntry::make('apiKey')
    ->label('API key')
    ->fontFamily(FontFamily::Mono)

除了允许静态值之外，fontFamily() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

处理长文本

限制文本长度

你可以使用 limit() 方法限制该条目值的长度：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->limit(50)

除了允许静态值之外，limit() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

默认情况下，当文本被截断时，省略号 (...) 会附加到文本末尾。你可以通过向 end 参数传递自定义字符串来对此进行自定义：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->limit(50, end: ' (more)')

除了允许静态值之外，end 参数也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

你也可以通过使用 getCharacterLimit() 方法获取传递给函数 limit() 的值，从而重用该值：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->limit(50)
    ->tooltip(function (TextEntry $component): ?string {
        $state = $component->getState();

        if (strlen($state) <= $component->getCharacterLimit()) {
            return null;
        }

        // Only render the tooltip if the entry contents exceeds the length limit.
        return $state;
    })

限制字数

使用 words()，你可以限制 Entry 中展示的字数：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->words(10)

除了允许静态值之外，words() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

默认情况下，当文本被截断时，省略号 (...) 会附加到文本末尾。你可以通过向 end 参数传递自定义字符串来对此进行自定义：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->words(10, end: ' (more)')

除了允许静态值之外，end 参数也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

将文本限制为指定行数

你可以将文本限制到指定的行数，而不是限制成固定长度。将文本行数锁定到指定行数在响应式界面中很有用，这样可以确保在所有屏幕中都有一致性体验。使用 lineClamp() 方法可以达成此效果：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->lineClamp(2)

除了允许静态值之外，lineClamp() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

防止文本换行

默认情况下，如果文本超过容器的宽度，它将自动换行到下一行。你可以使用 wrap(false) 方法来防止这种行为：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('description')
    ->wrap(false)

除了允许静态值之外，wrap() 方法也允许接受一个函数来动态计算其值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

允许将文本复制到剪切板

你可以使文本可复制(copyable)，比如点击 Entry 将文本复制到剪切板，且可选地指定自定义确认消息及持续时长(以毫秒计)：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('apiKey')
    ->label('API key')
    ->copyable()
    ->copyMessage('Copied!')
    ->copyMessageDuration(1500)

此外，你也可以传入一个布尔值，控制文本是否可复制：

use Filament\Infolists\Components\TextEntry;

TextEntry::make('apiKey')
    ->label('API key')
    ->copyable(FeatureFlag::active())

除了允许静态值之外，copyable()、copyMessage() 和 copyMessageDuration() 方法也接受通过函数来动态计算值。你可以将多个 utility 作为参数注入到该函数中。

了解更多 utility 注入详情。

Utility	类型	参数	描述
Entry	`Filament\Infolists\Components\Entry`	`$component`	The current entry component instance.
Get function	`Filament\Schemas\Components\Utilities\Get`	`$get`	A function for retrieving values from the current schema data. Validation is not run on form fields.
Livewire	`Livewire\Component`	`$livewire`	The Livewire component instance.
Eloquent model FQN	`?string<Illuminate\Database\Eloquent\Model>`	`$model`	The Eloquent model FQN for the current schema.
Operation	`string`	`$operation`	The current operation being performed by the schema. Usually `create`, `edit`, or `view`.
Eloquent record	`?Illuminate\Database\Eloquent\Model`	`$record`	The Eloquent record for the current schema.
State	`mixed`	`$state`	The current value of the entry.

NOTE

该特性只有在应用启用 SSL 时有效。

Adding suffix and prefix actions

You may place an action before and after the entry using the prefixAction() and suffixAction() methods:

use Filament\Actions\Action;
use Filament\Infolists\Components\TextEntry;
use Filament\Support\Icons\Heroicon;

TextEntry::make('cost')
    ->prefix('€')
    ->suffixAction(
        Action::make('copyCostToPrice')
            ->icon(Heroicon::Clipboard),
    )

Edit on GitHub

Still need help? Join our Discord community or open a GitHub discussion

#简介

#自定义颜色

#添加图标

#显示成”徽章”

#格式化

#日期格式化

#使用 Carbon 的 macro 格式格式化日期

#格式化相对日期

#在 Tooltip 中展示格式化日期

#为格式化设置时区

#数字格式化

#货币格式化

#渲染 Markdown

#渲染 HTML

#渲染无净化的原始 HTML

#展示多个值

#列表中添加点号

#限制列表中值的数量

#展开限制列表

#使用列表分隔符

#聚合关联

#自定义文本大小

#自定义字体粗细

#自定义字体

#处理长文本

#限制文本长度

#限制字数

#将文本限制为指定行数

#防止文本换行

#允许将文本复制到剪切板

#Adding suffix and prefix actions

简介

自定义颜色

添加图标

显示成”徽章”

格式化

日期格式化

使用 Carbon 的 macro 格式格式化日期

格式化相对日期

在 Tooltip 中展示格式化日期

为格式化设置时区

数字格式化

货币格式化

渲染 Markdown

渲染 HTML

渲染无净化的原始 HTML

展示多个值

列表中添加点号

限制列表中值的数量

展开限制列表

使用列表分隔符

聚合关联

自定义文本大小

自定义字体粗细

自定义字体

处理长文本

限制文本长度

限制字数

将文本限制为指定行数

防止文本换行

允许将文本复制到剪切板

Adding suffix and prefix actions