Link
Text hyperlink
Security Warning
The href prop will be rendered directly to an <a> tag. If you pass a value such as javascript:alert(1) or a malicious URL, it may cause XSS or open redirect vulnerabilities.
Always validate and sanitize the URL before use. For example:
Show code example
function sanitizeUrl(url) {
const allowedProtocols = ['http:', 'https:']
try {
const parsed = new URL(url, window.location.origin)
return allowedProtocols.includes(parsed.protocol) ? parsed.href : '#'
} catch {
return '#'
}
}Basic
Basic text link
Disabled
Disabled state of link
Underline
Controlling when underlines should appear
WARNING
The boolean value has been deprecated, and will be removed in 3.0.0 , consider switching to new values.
TIP
Starting from 2.9.9 , you can use 'always' | 'hover' | 'never' to control when underlines should appear. The examples in the document all use these values. If you are using a version less than 2.9.9 , please refer to:
<template>
<!-- works before 2.9.9, use 'hover' after, removed in 3.0.0 -->
<el-link underline>link</el-link>
<!-- works before 2.9.9, use 'never' after, removed in 3.0.0 -->
<el-link :underline="false">link</el-link>
</template>Icon
Link with icon
TIP
Use the icon attribute to add icon. You can pass either string for the component name (registered in advance) or the component itself which is a SVG Vue component. Element Plus has provided a set of icon that you can find at icon
API
Attributes
| Name | Description | Type | Default |
|---|---|---|---|
| type | type | enum | default |
| underline | when underlines should appear | enum | hover |
| disabled | whether the component is disabled | boolean | false |
| href | same as native hyperlink's href | string | — |
| target | same as native hyperlink's target | enum | _self |
| icon | icon component | string / Component | — |
Slots
| Name | Description |
|---|---|
| default | customize default content |
| icon | customize icon component |
Source
Contributors
