[][src]Struct moxie_dom::elements::text_semantics::ABuilder

#[must_use = "needs to be built"]pub struct ABuilder { /* fields omitted */ }

The HTML <a> element (or anchor element), along with its href attribute, creates a hyperlink to other web pages, files, locations within the same page, email addresses, or any other URL.

A type for initializing the element's attributes before calling build.


impl ABuilder[src]

pub fn build(self) -> A[src]

Initialize the element with all of the attributes so far.

impl ABuilder[src]

pub fn download(self, to_set: impl ToString) -> Self[src]

Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value:

  • Without a value, the browser will suggest a filename/extension, generated from various sources:
    • The Content-Disposition HTTP header
    • The final segment in the URL path
    • The media type (from the (Content-Type header, the start of a data: URL, or Blob.type for a blob: URL)
  • Defining a value suggests it as the filename. / and \ characters are converted to underscores (_). Filesystems may forbid other characters in filenames, so browsers will adjust the suggested name if necessary.


  • download only works for same-origin URLs, or the blob: and data: schemes.
  • If Content-Disposition has a different filename than download, the header takes priority. (If Content-Disposition: inline, Firefox prefers the header while Chrome prefers download.)

pub fn href(self, to_set: impl ToString) -> Self[src]

The URL that the hyperlink points to. Links are not restricted to HTTP-based URLs — they can use any URL scheme supported by browsers:

  • Sections of a page with fragment URLs
  • Pieces of media files with media fragments
  • Telephone numbers with tel: URLs
  • Email addresses with mailto: URLs
  • While web browsers may not support other URL schemes, web sites can with registerProtocolHandler()

pub fn hreflang(self, to_set: impl ToString) -> Self[src]

Hints at the human language of the linked URL. No built-in functionality. Allowed values are the same as the global lang attribute.

pub fn ping(self, to_set: impl ToString) -> Self[src]

A space-separated list of URLs. When the link is followed, the browser will send POST requests with the body PING to the URLs. Typically for tracking.

pub fn rel(self, to_set: impl ToString) -> Self[src]

The relationship of the linked URL as space-separated link types.

pub fn target(self, to_set: impl ToString) -> Self[src]

Where to display the linked URL, as the name for a browsing context (a tab, window, or