PerformanceLinks
class PerformanceLinks extends GroupedTagBuilder
Methods
Get the builder key.
Determine whether no resource hints are defined.
Get the key used in the head array.
Get the empty resource hint groups.
Get the supported route attribute names.
Build resource hints from a route attribute.
Determine if the builder should render even when no data was set.
Resolve a string or string-backed enum value.
Normalize a route attribute value into a list of items.
Create the resource hint definitions.
Build preload hints from route values.
Build prefetch hints from route values.
Build preconnect hints from route values.
Build DNS prefetch hints from route values.
Add or replace a preload hint by URL.
Preload an asset, inferring its resource type when omitted.
Add or replace a prefetch hint by URL.
Prefetch an asset, inferring its resource type when omitted.
Add or replace a preconnect hint by origin.
Add a DNS prefetch hint.
Get ordered definitions for each resource hint group.
Infer a resource type from its file extension.
Return a boolean or string attribute value.
Details
at line 39
static string
key()
Get the builder key.
at line 242
TagBuilder
overlayOn(TagBuilder|null $base)
Overlay these resource hints onto the lower layer.
at line 259
bool
isEmpty()
Determine whether no resource hints are defined.
at line 47
static string
headArrayKey()
Get the key used in the head array.
at line 55
static mixed
headArrayDefault()
Get the empty resource hint groups.
at line 70
static array
routeAttributeKeys()
Get the supported route attribute names.
at line 78
static TagBuilder|null
fromRouteAttribute(string $key, mixed $value)
Build resource hints from a route attribute.
in
TagBuilder at line 66
static bool
rendersWhenEmpty(ResolvedHead $head)
Determine if the builder should render even when no data was set.
in
TagBuilder at line 74
TagBuilder
asDefaults()
Mark the builder's data as belonging to the defaults layer.
at line 272
mixed
toHeadArray(ResolvedHead $head)
Get the resource hints for the head array.
at line 282
array
toTags(ResolvedHead $head, TagRenderer $tags)
Render the resource hint tags.
in
TagBuilder at line 100
static protected string|null
string(mixed $value)
Return the value when it is a string.
in
TagBuilder at line 108
static protected string|null
stringOrBackedEnum(mixed $value)
Resolve a string or string-backed enum value.
in
TagBuilder at line 124
static protected bool|null
bool(mixed $value)
Return the value when it is a boolean.
in
TagBuilder at line 132
static protected int|null
int(mixed $value)
Return the value when it is an integer.
in
TagBuilder at line 142
static protected array
items(mixed $value)
Normalize a route attribute value into a list of items.
in
TagBuilder at line 153
static protected array
named(array $values)
Filter an array down to its string-keyed values.
at line 28
__construct(array $preloads = [], array $prefetches = [], array $preconnects = [], array $dnsPrefetches = [])
Create the resource hint definitions.
at line 94
static PerformanceLinks|null
fromPreloadAttributes(string|array $preloads)
Build preload hints from route values.
at line 112
static PerformanceLinks|null
fromPrefetchAttributes(string|array $prefetches)
Build prefetch hints from route values.
at line 130
static PerformanceLinks|null
fromPreconnectAttributes(string|array $preconnects)
Build preconnect hints from route values.
at line 148
static PerformanceLinks|null
fromDnsPrefetchAttributes(string|array $dnsPrefetches)
Build DNS prefetch hints from route values.
at line 166
PerformanceLinks
preload(string $href, string|null $as = null, bool|string|null $crossorigin = null, ImageType|string|null $type = null, Media|string|null $media = null)
Add or replace a preload hint by URL.
at line 182
PerformanceLinks
preloadAsset(string $path, string|null $as = null, bool|string|null $crossorigin = null, ImageType|string|null $type = null, Media|string|null $media = null)
Preload an asset, inferring its resource type when omitted.
at line 198
PerformanceLinks
prefetch(string $href, string|null $as = null)
Add or replace a prefetch hint by URL.
at line 211
PerformanceLinks
prefetchAsset(string $path, string|null $as = null)
Prefetch an asset, inferring its resource type when omitted.
at line 219
PerformanceLinks
preconnect(string $href, bool|string|null $crossorigin = null)
Add or replace a preconnect hint by origin.
at line 232
PerformanceLinks
dnsPrefetch(string $href)
Add a DNS prefetch hint.
at line 297
protected array
headArray()
Get ordered definitions for each resource hint group.
at line 310
static protected string|null
detectAs(string $path)
Infer a resource type from its file extension.
at line 331
static protected bool|string|null
boolOrString(mixed $value)
Return a boolean or string attribute value.