Link 链接
用于超链接或路由跳转。
基础用法
通过组件标签 NueLink 声明一个超链接组件。
链接目标
通过属性 href 设置链接目标地址。
<template>
<nue-link href="https://www.baidu.com">百度</nue-link>
</template>链接跳转方式
通过属性 target 设置链接跳转方式。默认情况下,组件的跳转方式与 <a> 标签一致,即 _self 当前标签页跳转。
<template>
<nue-link href="https://www.baidu.com" target="_blank">百度</nue-link>
</template>禁用状态
通过属性 disabled 禁用链接组件。
<template>
<nue-link disabled href="https://www.baidu.com">百度</nue-link>
</template>链接图标
通过 icon 属性可以给链接添加图标。
<template>
<nue-link href="https://www.baidu.com/" icon="connection">百度</nue-link>
</template>路由连接
通过 route 属性实现 VueRouter 路由跳转。route 属性接收 string 或 { name: string, params?: any, query?: any } 类型的值。
当 route 属性存在时,组件渲染会使用 <RouterLink> 而非 <a> 标签;属性值会被转换为 to 用于匹配 VueRouter 的路由,此时的 href 属性将失效(即使存在)。
激活状态会在 route 属性存在时启用,主题名称为 actived。若想要修改激活状态的样式,通过 nue-link--actived 类名进行样式修改,目前不支持自定其他的激活状态类名。
<template>
<nue-div align="center">
<nue-link route="/a/b/c">路由连接</nue-link>
<nue-link route="/a/b/c" theme="actived">路由链接(激活)</nue-link>
</nue-div>
</template>链接样式
链接组件支持多种样式定制,可以通过主题或直接使用 CSS 类名进行样式修改。
默认样式
默认情况下,链接会显示为带有下划线的文本样式。
无下划线样式
可以通过自定义主题移除下划线,实现更简洁的视觉效果。
注意事项
- 路由跳转:
route属性需要项目配置了 VueRouter 才能使用,否则会导致渲染错误。 - 优先级:当同时设置
href和route属性时,route优先,href会失效。 - 激活状态:激活状态仅在
route属性存在时生效,CSS 类名为nue-link--actived。 - 禁用状态:禁用状态的链接不可点击,但仍然可以获取焦点(无障碍考虑)。
- 图标位置:图标默认显示在链接文字的前方。
组件属性与事件
下方涵盖了 NueLink 组件所有的可用属性与事件。
属性
| 属性 | Type | 默认值 | 说明 |
|---|---|---|---|
href | string | - | 链接地址 |
disabled | boolean | - | 是否禁用 |
icon | string | - | 图标名称 |
route | Record<string, unknown> | string | - | 路由对象,用于 VueRouter 跳转 |
flex | string | - | 弹性布局 |
align | string | - | 对齐方式 |
size | string | - | 尺寸 |
title | string | - | 标题(原生 title 属性) |
theme | string | string[] | Record<string, boolean> | - | 主题样式(继承自 GlobalProps) |