Link

ironhtml_elements

Struct Link

pub struct Link;

Expand description

The <link> element - external resource link.

§Purpose

The <link> element specifies relationships between the current document and external resources. Most commonly used to link to stylesheets, but also used for favicons, alternate versions, preloading resources, and more.

§Content Categories

Metadata Content

§Permitted Content Model

None (void element)

§Common Use Cases

Linking to external CSS stylesheets
Specifying favicons and touch icons
Defining alternate language versions of a page
Preloading or prefetching resources
Linking to RSS/Atom feeds

§Key Attributes

rel: Relationship type (e.g., "stylesheet", "icon", "preload", "canonical")
href: URL of the linked resource
type: MIME type of the linked resource
media: Media query for conditional loading (mainly for stylesheets)
as: Type of content being preloaded (when rel="preload")

§Example

<head>
  <link rel="stylesheet" href="styles.css">
  <link rel="icon" type="image/png" href="/favicon.png">
  <link rel="preload" href="font.woff2" as="font" type="font/woff2" crossorigin>
  <link rel="alternate" hreflang="es" href="https://example.com/es/">
</head>

§WHATWG Specification

4.2.4 The link element

Trait Implementations§

impl HtmlElement for Link

const TAG: &'static str = "link"

The HTML tag name (e.g., “div”, “span”, “img”).

const VOID: bool = true

Whether this is a void element (self-closing, no children allowed).

impl CanContain<Link> for Head

impl MetadataContent for Link

Auto Trait Implementations§

impl Freeze for Link

impl RefUnwindSafe for Link

impl Send for Link

impl Sync for Link

impl Unpin for Link

impl UnwindSafe for Link

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.