Blazorise Link component

Provides declarative, accessible navigation around your application.

The <Link> component allows you to easily customize anchor elements with your theme colors and typography styles. Link is the building block for most Blazorise components that offer link functionality. A Link component behaves like an <a> element, except it toggles an active CSS class based on whether its href matches the current URL.

Note: due to a Visual Studio tooling issue in VisualStudio tooling you should write <Link> as <Anchor> until the issue is resolved. Or if you prefer the alternative, you can also use the <Anchor> alias.

Examples

Basic

By specifying a value in the To property, a standard link (<a>) element will be rendered.

Link

<Link To="docs">
    Link
</Link>

Anchor Links

A # in front of a link location specifies that the link is pointing to an anchor on a page. (Anchor meaning a specific place in the middle of your page). Typically <a href="#"> will cause the document to scroll to the top of page when clicked. <Link> addresses this by preventing the default action (scroll to top) when To is set to #. If you need scroll to top behavior, use a standard <Link To="#">...</Link> tag.

Link

<Link To="#b-docs-page-title">
    Link
</Link>

Target

If you want to open link in a new tab or window you can use the Target parameter.

Blazorise

<Link To="https://github.com/Megabit/Blazorise" Target="Target.Blank">
    Blazorise
</Link>

Target iframe

By assigning a name to a frame via the name attribute, you can refer to it as the "target" of links defined by other elements. Our Target parameter can also accept string values.

<Link To="some-url" Target="@("example")">
    This link can lead to iframe
</Link>

<iframe name="example" src="init_fixed.html"></iframe>

Stretched link

Add Stretched attribute to a link to make its containing block clickable via a ::after pseudo element. In most cases, this means that an element with position: relative that contains a link with the stretched link class is clickable. Please note given how CSS position works, stretched-link cannot be mixed with most table elements.

Cards have position: relative by default, so in this case you can safely add the Stretched attribute to a link in the card without any other HTML changes.

Card with stretched link

Some quick example text to build on the card title and make up the bulk of the card's content.

Go somewhere

<Card Width="Width.Rem(18)">
    <CardImage Source="/img/gallery/2.jpg" Alt="Placeholder image" />
    <CardBody>
        <CardTitle Size="HeadingSize.Is3">
            Card with stretched link
        </CardTitle>
        <CardText>
            Some quick example text to build on the card title and make up the bulk of the card's content.
        </CardText>
        <Link To="#" Title="Link to go somewhere" Stretched>
            Go somewhere
        </Link>
    </CardBody>
</Card>

Disabled link

Make links look inactive by adding the Disabled boolean attribute to any <Link> element.

The disabled class uses pointer-events: none to try to disable the link functionality of <a>s, but that CSS property is not yet standardized. In addition, even in browsers that do support pointer-events: none, keyboard navigation remains unaffected, meaning that sighted keyboard users and users of assistive technologies will still be able to activate these links. So to be safe, add a tabindex="-1" attribute on these links (to prevent them from receiving keyboard focus) and use custom JavaScript to disable their functionality.

This is an example of a disabled link.

<Paragraph>
    This is an example of a <Link To="#" Disabled>disabled link</Link>.
</Paragraph>

Best Practices

Navigation Links

A link should take the user to another location. Use a <Button> for actions that change data or update the current interface. When navigation is unavailable, plain text or an explanation is usually clearer than a disabled-looking link that may still appear interactive.

Describe the Destination

Write link text that makes sense out of context instead of using "click here" or a bare URL. Let users know when a link opens a new window, begins a download, or leads to a substantially different experience.

API

See the API reference for the parameters, events, methods, and related types available to the components covered on this page.

<Link />