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.
<Link>
as <Blazorise.Link>
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 theTo
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 theTarget
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. OurTarget
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
<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>
API
Attributes
Name | Description | Type | Default |
---|---|---|---|
To |
Specifies that multiple files can be selected. | string |
null |
Target |
The target attribute specifies where to open the linked document. | Target |
Default |
Match |
URL matching behavior for a link. | Match |
Prefix |
CustomMatch |
A callback function that is used to compare current uri with the user defined uri. Must enable Match.Custom to be used.
|
Func<string, bool> |
null |
Title |
Defines the title of a link, which appears to the user as a tooltip. | string |
null |
Unstyled |
Removes default color styles from the link. | bool |
false |
Clicked |
Occurs when the link is clicked. | EventCallback |
|
Stretched |
Makes any HTML element or component clickable by “stretching” a nested link. | bool |
false |