# Link

> Renders the HTML <link> element for relationships to external resources.

[API reference](/docs/api/index.md) › [HTML](/docs/extensions/html/reference/index.md) › [Metadata](/docs/extensions/html/reference/metadata/index.md) › Link

| final class | `UIAwesome\Html\Metadata\Link` |
| --- | --- |
| Extends | [`UIAwesome\Html\Core\Element\BaseVoid`](/docs/extensions/html-core/reference/element/basevoid/index.md) » [`UIAwesome\Html\Core\Base\BaseTag`](/docs/extensions/html-core/reference/base/basetag/index.md) |
| Implements | [`UIAwesome\Html\Contracts\Attribute\AttributesInterface`](/docs/extensions/html-contracts/reference/attribute/attributesinterface/index.md), [`UIAwesome\Html\Contracts\Element\VoidInterface`](/docs/extensions/html-contracts/reference/element/voidinterface/index.md), [`UIAwesome\Html\Contracts\RenderableInterface`](/docs/extensions/html-contracts/reference/renderableinterface/index.md) |
| Uses traits | [`UIAwesome\Html\Attribute\CanBeDisabled`](/docs/extensions/html-attribute/reference/canbedisabled/index.md), [`UIAwesome\Html\Attribute\HasAs`](/docs/extensions/html-attribute/reference/hasas/index.md), [`UIAwesome\Html\Attribute\HasBlocking`](/docs/extensions/html-attribute/reference/hasblocking/index.md), [`UIAwesome\Html\Attribute\HasCrossorigin`](/docs/extensions/html-attribute/reference/hascrossorigin/index.md), [`UIAwesome\Html\Attribute\HasFetchpriority`](/docs/extensions/html-attribute/reference/hasfetchpriority/index.md), [`UIAwesome\Html\Attribute\HasHreflang`](/docs/extensions/html-attribute/reference/hashreflang/index.md), [`UIAwesome\Html\Attribute\HasImageSizes`](/docs/extensions/html-attribute/reference/hasimagesizes/index.md), [`UIAwesome\Html\Attribute\HasImageSrcSet`](/docs/extensions/html-attribute/reference/hasimagesrcset/index.md), [`UIAwesome\Html\Attribute\HasIntegrity`](/docs/extensions/html-attribute/reference/hasintegrity/index.md), [`UIAwesome\Html\Attribute\HasMedia`](/docs/extensions/html-attribute/reference/hasmedia/index.md), [`UIAwesome\Html\Attribute\HasReferrerpolicy`](/docs/extensions/html-attribute/reference/hasreferrerpolicy/index.md), [`UIAwesome\Html\Attribute\HasRel`](/docs/extensions/html-attribute/reference/hasrel/index.md), [`UIAwesome\Html\Attribute\HasSizes`](/docs/extensions/html-attribute/reference/hassizes/index.md), [`UIAwesome\Html\Attribute\Global\CanBeHidden`](/docs/extensions/html-attribute/reference/global/canbehidden/index.md), [`UIAwesome\Html\Attribute\Global\HasAccesskey`](/docs/extensions/html-attribute/reference/global/hasaccesskey/index.md), [`UIAwesome\Html\Attribute\Global\HasAria`](/docs/extensions/html-attribute/reference/global/hasaria/index.md), [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md), [`UIAwesome\Html\Attribute\Global\HasClass`](/docs/extensions/html-attribute/reference/global/hasclass/index.md), [`UIAwesome\Html\Attribute\Global\HasData`](/docs/extensions/html-attribute/reference/global/hasdata/index.md), [`UIAwesome\Html\Attribute\Global\HasDir`](/docs/extensions/html-attribute/reference/global/hasdir/index.md), [`UIAwesome\Html\Attribute\Global\HasEvents`](/docs/extensions/html-attribute/reference/global/hasevents/index.md), [`UIAwesome\Html\Attribute\Global\HasId`](/docs/extensions/html-attribute/reference/global/hasid/index.md), [`UIAwesome\Html\Attribute\Global\HasLang`](/docs/extensions/html-attribute/reference/global/haslang/index.md), [`UIAwesome\Html\Attribute\Global\HasRole`](/docs/extensions/html-attribute/reference/global/hasrole/index.md), [`UIAwesome\Html\Attribute\Global\HasStyle`](/docs/extensions/html-attribute/reference/global/hasstyle/index.md), [`UIAwesome\Html\Attribute\Global\HasTitle`](/docs/extensions/html-attribute/reference/global/hastitle/index.md), [`UIAwesome\Html\Attribute\Global\HasTranslate`](/docs/extensions/html-attribute/reference/global/hastranslate/index.md), [`UIAwesome\Html\Core\Event\HasAfterRun`](/docs/extensions/html-core/reference/event/hasafterrun/index.md), [`UIAwesome\Html\Core\Event\HasBeforeRun`](/docs/extensions/html-core/reference/event/hasbeforerun/index.md) |
| Source | [`src/Metadata/Link.php`](https://github.com/ui-awesome/html/blob/main/src/Metadata/Link.php#L34) |

Renders the HTML `<link>` element for relationships to external resources.

See also: <https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/link> ([`BaseVoid`](/docs/extensions/html-core/reference/element/basevoid/index.md) for the base implementation.).

## Properties

| Property | Type | Description | Defined by |
| --- | --- | --- | --- |
| <span id="property-attributes"></span>[`$attributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md#property-attributes) protected | `mixed[]` | HTML attributes array used by the implementing class. Default: `[]`. | [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md) |

## Methods

| Method | Description | Defined by |
| --- | --- | --- |
| <span id="method-__construct"></span>[`__construct()`](/docs/extensions/html-core/reference/base/basetag/index.md#method-__construct) final | Initializes a new tag instance. | [`UIAwesome\Html\Core\Base\BaseTag`](/docs/extensions/html-core/reference/base/basetag/index.md) |
| <span id="method-__toString"></span>[`__toString()`](/docs/extensions/html-core/reference/base/basetag/index.md#method-__toString) | Returns the rendered tag string. | [`UIAwesome\Html\Core\Base\BaseTag`](/docs/extensions/html-core/reference/base/basetag/index.md) |
| <span id="method-accesskey"></span>[`accesskey()`](/docs/extensions/html-attribute/reference/global/hasaccesskey/index.md#method-accesskey) | Sets the `accesskey` attribute. | [`UIAwesome\Html\Attribute\Global\HasAccesskey`](/docs/extensions/html-attribute/reference/global/hasaccesskey/index.md) |
| <span id="method-addAriaAttribute"></span>[`addAriaAttribute()`](/docs/extensions/html-attribute/reference/global/hasaria/index.md#method-addAriaAttribute) | Sets an `aria-*` attribute. | [`UIAwesome\Html\Attribute\Global\HasAria`](/docs/extensions/html-attribute/reference/global/hasaria/index.md) |
| <span id="method-addAttribute"></span>[`addAttribute()`](/docs/extensions/html-mixin/reference/hasattributes/index.md#method-addAttribute) | Adds or updates a single HTML attribute for the element. | [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md) |
| <span id="method-addDataAttribute"></span>[`addDataAttribute()`](/docs/extensions/html-attribute/reference/global/hasdata/index.md#method-addDataAttribute) | Sets a `data-*` attribute. | [`UIAwesome\Html\Attribute\Global\HasData`](/docs/extensions/html-attribute/reference/global/hasdata/index.md) |
| <span id="method-addEvent"></span>[`addEvent()`](/docs/extensions/html-attribute/reference/global/hasevents/index.md#method-addEvent) | Sets an `on*` event attribute. | [`UIAwesome\Html\Attribute\Global\HasEvents`](/docs/extensions/html-attribute/reference/global/hasevents/index.md) |
| <span id="method-ariaAttributes"></span>[`ariaAttributes()`](/docs/extensions/html-attribute/reference/global/hasaria/index.md#method-ariaAttributes) | Sets multiple `aria-*` attributes. | [`UIAwesome\Html\Attribute\Global\HasAria`](/docs/extensions/html-attribute/reference/global/hasaria/index.md) |
| <span id="method-as"></span>[`as()`](/docs/extensions/html-attribute/reference/hasas/index.md#method-as) | Sets the `as` attribute. | [`UIAwesome\Html\Attribute\HasAs`](/docs/extensions/html-attribute/reference/hasas/index.md) |
| <span id="method-attributes"></span>[`attributes()`](/docs/extensions/html-mixin/reference/hasattributes/index.md#method-attributes) | Adds or updates multiple HTML attributes for the element. | [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md) |
| <span id="method-blocking"></span>[`blocking()`](/docs/extensions/html-attribute/reference/hasblocking/index.md#method-blocking) | Sets the `blocking` attribute. | [`UIAwesome\Html\Attribute\HasBlocking`](/docs/extensions/html-attribute/reference/hasblocking/index.md) |
| <span id="method-class"></span>[`class()`](/docs/extensions/html-attribute/reference/global/hasclass/index.md#method-class) | Sets the `class` attribute. | [`UIAwesome\Html\Attribute\Global\HasClass`](/docs/extensions/html-attribute/reference/global/hasclass/index.md) |
| <span id="method-config"></span>[`config()`](/docs/extensions/html-core/reference/base/basetag/index.md#method-config) | Applies application-scoped config recipes to this tag. | [`UIAwesome\Html\Core\Base\BaseTag`](/docs/extensions/html-core/reference/base/basetag/index.md) |
| <span id="method-crossorigin"></span>[`crossorigin()`](/docs/extensions/html-attribute/reference/hascrossorigin/index.md#method-crossorigin) | Sets the `crossorigin` attribute. | [`UIAwesome\Html\Attribute\HasCrossorigin`](/docs/extensions/html-attribute/reference/hascrossorigin/index.md) |
| <span id="method-dataAttributes"></span>[`dataAttributes()`](/docs/extensions/html-attribute/reference/global/hasdata/index.md#method-dataAttributes) | Sets multiple `data-*` attributes. | [`UIAwesome\Html\Attribute\Global\HasData`](/docs/extensions/html-attribute/reference/global/hasdata/index.md) |
| <span id="method-dir"></span>[`dir()`](/docs/extensions/html-attribute/reference/global/hasdir/index.md#method-dir) | Sets the `dir` attribute. | [`UIAwesome\Html\Attribute\Global\HasDir`](/docs/extensions/html-attribute/reference/global/hasdir/index.md) |
| <span id="method-disabled"></span>[`disabled()`](/docs/extensions/html-attribute/reference/canbedisabled/index.md#method-disabled) | Sets the `disabled` attribute. | [`UIAwesome\Html\Attribute\CanBeDisabled`](/docs/extensions/html-attribute/reference/canbedisabled/index.md) |
| <span id="method-events"></span>[`events()`](/docs/extensions/html-attribute/reference/global/hasevents/index.md#method-events) | Sets multiple `on*` event attributes. | [`UIAwesome\Html\Attribute\Global\HasEvents`](/docs/extensions/html-attribute/reference/global/hasevents/index.md) |
| <span id="method-fetchpriority"></span>[`fetchpriority()`](/docs/extensions/html-attribute/reference/hasfetchpriority/index.md#method-fetchpriority) | Sets the `fetchpriority` attribute. | [`UIAwesome\Html\Attribute\HasFetchpriority`](/docs/extensions/html-attribute/reference/hasfetchpriority/index.md) |
| <span id="method-getAttribute"></span>[`getAttribute()`](/docs/extensions/html-mixin/reference/hasattributes/index.md#method-getAttribute) | Returns the value of a single HTML attribute. | [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md) |
| <span id="method-getAttributes"></span>[`getAttributes()`](/docs/extensions/html-mixin/reference/hasattributes/index.md#method-getAttributes) | Returns the `array` of HTML attributes for the element. | [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md) |
| <span id="method-hidden"></span>[`hidden()`](/docs/extensions/html-attribute/reference/global/canbehidden/index.md#method-hidden) | Sets the `hidden` attribute. | [`UIAwesome\Html\Attribute\Global\CanBeHidden`](/docs/extensions/html-attribute/reference/global/canbehidden/index.md) |
| [`href()`](#method-href) | Sets the `href` attribute. | `Link` |
| <span id="method-hreflang"></span>[`hreflang()`](/docs/extensions/html-attribute/reference/hashreflang/index.md#method-hreflang) | Sets the `hreflang` attribute. | [`UIAwesome\Html\Attribute\HasHreflang`](/docs/extensions/html-attribute/reference/hashreflang/index.md) |
| <span id="method-id"></span>[`id()`](/docs/extensions/html-attribute/reference/global/hasid/index.md#method-id) | Sets the `id` attribute. | [`UIAwesome\Html\Attribute\Global\HasId`](/docs/extensions/html-attribute/reference/global/hasid/index.md) |
| <span id="method-imagesizes"></span>[`imagesizes()`](/docs/extensions/html-attribute/reference/hasimagesizes/index.md#method-imagesizes) | Sets the `imagesizes` attribute. | [`UIAwesome\Html\Attribute\HasImageSizes`](/docs/extensions/html-attribute/reference/hasimagesizes/index.md) |
| <span id="method-imagesrcset"></span>[`imagesrcset()`](/docs/extensions/html-attribute/reference/hasimagesrcset/index.md#method-imagesrcset) | Sets the `imagesrcset` attribute. | [`UIAwesome\Html\Attribute\HasImageSrcSet`](/docs/extensions/html-attribute/reference/hasimagesrcset/index.md) |
| <span id="method-integrity"></span>[`integrity()`](/docs/extensions/html-attribute/reference/hasintegrity/index.md#method-integrity) | Sets the `integrity` attribute. | [`UIAwesome\Html\Attribute\HasIntegrity`](/docs/extensions/html-attribute/reference/hasintegrity/index.md) |
| <span id="method-lang"></span>[`lang()`](/docs/extensions/html-attribute/reference/global/haslang/index.md#method-lang) | Sets the `lang` attribute. | [`UIAwesome\Html\Attribute\Global\HasLang`](/docs/extensions/html-attribute/reference/global/haslang/index.md) |
| <span id="method-media"></span>[`media()`](/docs/extensions/html-attribute/reference/hasmedia/index.md#method-media) | Sets the `media` attribute. | [`UIAwesome\Html\Attribute\HasMedia`](/docs/extensions/html-attribute/reference/hasmedia/index.md) |
| <span id="method-referrerpolicy"></span>[`referrerpolicy()`](/docs/extensions/html-attribute/reference/hasreferrerpolicy/index.md#method-referrerpolicy) | Sets the `referrerpolicy` attribute. | [`UIAwesome\Html\Attribute\HasReferrerpolicy`](/docs/extensions/html-attribute/reference/hasreferrerpolicy/index.md) |
| <span id="method-rel"></span>[`rel()`](/docs/extensions/html-attribute/reference/hasrel/index.md#method-rel) | Sets the `rel` attribute. | [`UIAwesome\Html\Attribute\HasRel`](/docs/extensions/html-attribute/reference/hasrel/index.md) |
| <span id="method-removeAriaAttribute"></span>[`removeAriaAttribute()`](/docs/extensions/html-attribute/reference/global/hasaria/index.md#method-removeAriaAttribute) | Removes an `aria-*` attribute. | [`UIAwesome\Html\Attribute\Global\HasAria`](/docs/extensions/html-attribute/reference/global/hasaria/index.md) |
| <span id="method-removeAttribute"></span>[`removeAttribute()`](/docs/extensions/html-mixin/reference/hasattributes/index.md#method-removeAttribute) | Removes a specific HTML attribute from the element. | [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md) |
| <span id="method-removeDataAttribute"></span>[`removeDataAttribute()`](/docs/extensions/html-attribute/reference/global/hasdata/index.md#method-removeDataAttribute) | Removes a `data-*` attribute. | [`UIAwesome\Html\Attribute\Global\HasData`](/docs/extensions/html-attribute/reference/global/hasdata/index.md) |
| <span id="method-removeEvent"></span>[`removeEvent()`](/docs/extensions/html-attribute/reference/global/hasevents/index.md#method-removeEvent) | Removes an `on*` event attribute. | [`UIAwesome\Html\Attribute\Global\HasEvents`](/docs/extensions/html-attribute/reference/global/hasevents/index.md) |
| <span id="method-render"></span>[`render()`](/docs/extensions/html-core/reference/base/basetag/index.md#method-render) final | Renders the tag with lifecycle hooks. | [`UIAwesome\Html\Core\Base\BaseTag`](/docs/extensions/html-core/reference/base/basetag/index.md) |
| <span id="method-replaceAttributes"></span>[`replaceAttributes()`](/docs/extensions/html-mixin/reference/hasattributes/index.md#method-replaceAttributes) | Replaces all HTML attributes for the element. | [`UIAwesome\Html\Mixin\HasAttributes`](/docs/extensions/html-mixin/reference/hasattributes/index.md) |
| <span id="method-role"></span>[`role()`](/docs/extensions/html-attribute/reference/global/hasrole/index.md#method-role) | Sets the `role` attribute. | [`UIAwesome\Html\Attribute\Global\HasRole`](/docs/extensions/html-attribute/reference/global/hasrole/index.md) |
| <span id="method-sizes"></span>[`sizes()`](/docs/extensions/html-attribute/reference/hassizes/index.md#method-sizes) | Sets the `sizes` attribute. | [`UIAwesome\Html\Attribute\HasSizes`](/docs/extensions/html-attribute/reference/hassizes/index.md) |
| <span id="method-style"></span>[`style()`](/docs/extensions/html-attribute/reference/global/hasstyle/index.md#method-style) | Sets the `style` attribute. | [`UIAwesome\Html\Attribute\Global\HasStyle`](/docs/extensions/html-attribute/reference/global/hasstyle/index.md) |
| <span id="method-tag"></span>[`tag()`](/docs/extensions/html-core/reference/base/basetag/index.md#method-tag) static | Creates and configures a new tag instance. | [`UIAwesome\Html\Core\Base\BaseTag`](/docs/extensions/html-core/reference/base/basetag/index.md) |
| <span id="method-title"></span>[`title()`](/docs/extensions/html-attribute/reference/global/hastitle/index.md#method-title) | Sets the `title` attribute. | [`UIAwesome\Html\Attribute\Global\HasTitle`](/docs/extensions/html-attribute/reference/global/hastitle/index.md) |
| <span id="method-translate"></span>[`translate()`](/docs/extensions/html-attribute/reference/global/hastranslate/index.md#method-translate) | Sets the `translate` attribute. | [`UIAwesome\Html\Attribute\Global\HasTranslate`](/docs/extensions/html-attribute/reference/global/hastranslate/index.md) |
| [`type()`](#method-type) | Sets the `type` attribute. | `Link` |
| <span id="method-afterRun"></span>[`afterRun()`](/docs/extensions/html-core/reference/event/hasafterrun/index.md#method-afterRun) protected | Post-processes rendered output. | [`UIAwesome\Html\Core\Event\HasAfterRun`](/docs/extensions/html-core/reference/event/hasafterrun/index.md) |
| <span id="method-beforeRun"></span>[`beforeRun()`](/docs/extensions/html-core/reference/event/hasbeforerun/index.md#method-beforeRun) protected | Validates state before rendering. | [`UIAwesome\Html\Core\Event\HasBeforeRun`](/docs/extensions/html-core/reference/event/hasbeforerun/index.md) |
| [`getTag()`](#method-getTag) protected | Returns the tag enumeration for the `<link>` element. | `Link` |
| <span id="method-loadDefault"></span>[`loadDefault()`](/docs/extensions/html-core/reference/base/basetag/index.md#method-loadDefault) protected | Returns class-level default definitions. | [`UIAwesome\Html\Core\Base\BaseTag`](/docs/extensions/html-core/reference/base/basetag/index.md) |
| <span id="method-run"></span>[`run()`](/docs/extensions/html-core/reference/element/basevoid/index.md#method-run) protected | Renders the void element. | [`UIAwesome\Html\Core\Element\BaseVoid`](/docs/extensions/html-core/reference/element/basevoid/index.md) |

## Method details

### href() <span id="method-href"></span>

```php
public function href(string|Stringable|UnitEnum|null $value): static
```

Sets the `href` attribute.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$value` | `string\|`[`Stringable`](https://www.php.net/manual/en/class.stringable.php)`\|`[`UnitEnum`](https://www.php.net/manual/en/class.unitenum.php)`\|null` | URL, path, or fragment, or `null` to remove the attribute. |

**Returns**

`static`: New instance with the updated `href` attribute.

### type() <span id="method-type"></span>

```php
public function type(string|Stringable|UnitEnum|null $value): static
```

Sets the `type` attribute.

Hints at the MIME type of the linked resource. Any MIME type is accepted; browsers treat the value as an
advisory hint and fetch the resource regardless.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$value` | `string\|`[`Stringable`](https://www.php.net/manual/en/class.stringable.php)`\|`[`UnitEnum`](https://www.php.net/manual/en/class.unitenum.php)`\|null` | MIME type of the linked resource, or `null` to remove the attribute. |

**Returns**

`static`: New instance with the updated `type` attribute.

**See also**

- <https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/link#type>

### getTag() <span id="method-getTag"></span>

```php
protected function getTag(): UIAwesome\Html\Interop\MetadataVoid
```

Returns the tag enumeration for the `<link>` element.

**Returns**

[`MetadataVoid`](https://github.com/ui-awesome/html-interop/blob/bbc56fa772c4b4772a6a83d4a3e602c5c27313c9/src/MetadataVoid.php): Tag enumeration instance for `<link>`. [`MetadataVoid`](https://github.com/ui-awesome/html-interop/blob/bbc56fa772c4b4772a6a83d4a3e602c5c27313c9/src/MetadataVoid.php) for valid metadata void tags.