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 bug
in VisualStudio tooling you should write
<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>
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 |
Clicked |
Occurs when the link is clicked. | EventCallback |