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.

Examples

Basic

By specifying a value in the To property, a standard link (<a>) element will be rendered.
<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 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.
<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.

Placeholder image

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="3">
            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.

This is an example of a disabled link.

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

API

Parameters

Parameter Description TypeDefault
ChildContent

Specifies the content to be rendered inside this Link.

RenderFragmentnull
Disabled

Makes the link look inactive by adding the disabled boolean attribute.

boolfalse
Match

URL matching behavior for a link.

Possible values:Prefix, All, Custom

MatchMatch.Prefix
Stretched

Makes any HTML element or component clickable by “stretching” a nested link.

boolfalse
Target

The target attribute specifies where to open the linked document.

TargetTarget.Default
Title

Specify extra information about the element.

string
To

Denotes the target route of the link.

string
Unstyled

Removes default color styles from the link.

boolfalse

Events

Event Description Type
Clicked

Occurs when the link is clicked.

EventCallback<MouseEventArgs>
CustomMatch

A callback function that is used to compare current uri with the user defined uri. If defined, the Link.Match parameter will be ignored.

Func<string, bool>
On this page