Link 链接

文字超链接

安全警告

href 属性会直接渲染到 <a> 标签上。如果你传递了诸如 javascript:alert(1) 或恶意 URL 之类的值,可能会导致 XSS开放式重定向漏洞

在使用之前,请务必对 URL 进行验证和清理。例如

显示代码示例
js
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 '#'
  }
}

基础用法

基础文字链接

禁用状态

链接的禁用状态

下划线

控制下划线出现时机

警告

布尔 类型的值已经被 废弃,并将在 3.0.0 中被 移除,请考虑切换到新的值。

提示

2.9.9 开始,您可以使用 'always' | 'hover' | 'never' 来控制下划线的显示时机。文档中的示例均使用这些值。如果您使用的版本 低于 2.9.9,请参考

vue
<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 属性添加图标。你可以传递组件名称(需提前注册)的字符串,或者 SVG Vue 组件本身。Element Plus 提供了一套图标,你可以在图标中找到。

API

属性

名称描述类型默认值
typetype枚举default
下划线何时应出现下划线枚举悬浮时
disabled是否禁用booleanfalse
原生 href 属性同原生超链接的 hrefstring
target同原生超链接的 target枚举_self
icon图标组件string / Component

插槽

名称描述
default自定义默认内容
icon自定义图标组件

来源

组件样式文档

贡献者