Link 链接
文字超链接,也可以不带地址,当作文字样式的操作按钮。
引入
ts
import { NsLink } from '@ns/ui'
基础用法
传了 href 是普通链接,点击跳转;不传 href 时当作文字样式的按钮使用。
vue
<template>
<NsSpace wrap>
<NsLink href="https://example.com">默认链接</NsLink>
<NsLink type="primary" href="https://example.com">主要链接</NsLink>
<NsLink type="primary">不带地址</NsLink>
</NsSpace>
</template>
类型
type 决定颜色,可选 default、primary、success、warning、danger、info、help。default 是正文颜色,悬停时变成主色;其他类型悬停时变浅,按下时变深。
vue
<template>
<NsSpace wrap size="large">
<NsLink href="https://example.com">默认(default)</NsLink>
<NsLink type="primary" href="https://example.com">主要(primary)</NsLink>
<NsLink type="success" href="https://example.com">成功(success)</NsLink>
<NsLink type="warning" href="https://example.com">警告(warning)</NsLink>
<NsLink type="danger" href="https://example.com">危险(danger)</NsLink>
<NsLink type="info" href="https://example.com">信息(info)</NsLink>
<NsLink type="help" href="https://example.com">帮助(help)</NsLink>
</NsSpace>
</template>
下划线
underline 可选 hover(默认,悬停时显示)、always(一直显示)、never(不显示);也可以传布尔值,true 等于 hover,false 等于 never。下面每一行是一种取值,鼠标移上去看区别:
vue
<template>
<NsSpace direction="vertical" align="start">
<NsSpace wrap size="large">
<span class="row-label">hover</span>
<NsLink href="https://example.com">默认</NsLink>
<NsLink type="primary" href="https://example.com">主要</NsLink>
<NsLink type="danger" href="https://example.com">危险</NsLink>
</NsSpace>
<NsSpace wrap size="large">
<span class="row-label">always</span>
<NsLink underline="always" href="https://example.com">默认</NsLink>
<NsLink type="primary" underline="always" href="https://example.com">主要</NsLink>
<NsLink type="danger" underline="always" href="https://example.com">危险</NsLink>
</NsSpace>
<NsSpace wrap size="large">
<span class="row-label">never</span>
<NsLink underline="never" href="https://example.com">默认</NsLink>
<NsLink type="primary" underline="never" href="https://example.com">主要</NsLink>
<NsLink type="danger" underline="never" href="https://example.com">危险</NsLink>
</NsSpace>
<NsSpace wrap size="large">
<span class="row-label">true</span>
<NsLink :underline="true" href="https://example.com">等于 hover</NsLink>
<span class="row-label">false</span>
<NsLink :underline="false" href="https://example.com">等于 never</NsLink>
</NsSpace>
</NsSpace>
</template>
<style scoped>
.row-label {
display: inline-block;
width: 56px;
color: var(--ns-text-color-secondary);
font-size: var(--ns-font-size-sm);
}
</style>
禁用
disabled 后链接变淡,去掉 href,点击不跳转,也不触发 click 事件,不能用 Tab 选中。每种类型都有禁用样式。
vue
<template>
<NsSpace wrap size="large">
<NsLink disabled href="https://example.com">默认</NsLink>
<NsLink type="primary" disabled href="https://example.com">主要</NsLink>
<NsLink type="success" disabled href="https://example.com">成功</NsLink>
<NsLink type="warning" disabled href="https://example.com">警告</NsLink>
<NsLink type="danger" disabled href="https://example.com">危险</NsLink>
<NsLink type="info" disabled href="https://example.com">信息</NsLink>
<NsLink type="help" disabled href="https://example.com">帮助</NsLink>
<NsLink type="primary" icon="edit" disabled>带图标</NsLink>
</NsSpace>
</template>
图标
icon 传图标名,显示在文字前面,颜色跟着链接变。
vue
<template>
<NsSpace wrap size="large">
<NsLink icon="search" type="primary">搜索</NsLink>
<NsLink icon="edit" type="primary">编辑</NsLink>
<NsLink icon="download" type="success" href="https://example.com">下载</NsLink>
<NsLink icon="trash" type="danger">删除</NsLink>
<NsLink icon="link" href="https://example.com" underline="always">查看原文</NsLink>
</NsSpace>
</template>
打开方式
target 是原生的打开方式。target="_blank" 时自动加 rel="noopener noreferrer",自己传了 rel 时以自己的为准。download 等其他原生属性也会加到 <a> 上。
vue
<template>
<NsSpace wrap size="large">
<NsLink type="primary" href="https://example.com" target="_blank">新窗口打开(_blank)</NsLink>
<NsLink type="primary" href="https://example.com" target="_self">当前窗口打开(_self)</NsLink>
<NsLink type="primary" href="https://example.com" target="_blank" rel="noopener">
自定义 rel
</NsLink>
</NsSpace>
</template>
嵌在文字里
链接的字号和行高跟着外面的文字,可以直接放在段落里。
vue
<template>
<p style="margin: 0; line-height: 1.8">
提交前请先阅读<NsLink type="primary" href="https://example.com" target="_blank"
>《用户协议》</NsLink
>和<NsLink type="primary" href="https://example.com" target="_blank">《隐私政策》</NsLink
>,有问题可以<NsLink type="primary" underline="always">联系客服</NsLink>。
</p>
</template>
操作链接
不传 href 时当作按钮使用:带 role="button" 和 tabindex="0",可以用 Tab 选中,按回车或空格触发 click。
vue
<script setup lang="ts">
import { ref } from 'vue'
import { NsLink, NsMessage, NsSpace } from '@ns/ui'
const count = ref(0)
const edit = () => {
count.value += 1
NsMessage.info('点了编辑')
}
const remove = () => {
count.value += 1
NsMessage.warning('点了删除')
}
</script>
<template>
<NsSpace wrap size="large">
<NsLink type="primary" icon="edit" @click="edit">编辑</NsLink>
<NsLink type="danger" icon="trash" @click="remove">删除</NsLink>
<NsLink type="primary" disabled @click="edit">禁用时不触发</NsLink>
</NsSpace>
<p style="margin-top: 12px">已触发 {{ count }} 次 click</p>
</template>
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| type | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'help' | 'default' | 'default' | 类型(颜色) |
| underline | boolean | 'always' | 'hover' | 'never' | 'hover' | 下划线显示方式 |
| disabled | boolean | false | 禁用 |
| href | string | — | 链接地址。不传时当作按钮使用 |
| target | string | — | 原生 target |
| icon | string | — | 文字前面的图标名,见 Icon 组件 |
Events
| 事件 | 参数 | 说明 |
|---|---|---|
| click | (event: MouseEvent) | 点击时触发,禁用时不触发 |
Slots
| 插槽 | 说明 |
|---|---|
| default | 链接文字 |
类型
ts
import type { LinkProps, LinkType, LinkUnderline } from '@ns/ui'
注意事项
underline传布尔值时,true等于'hover',false等于'never'。- 禁用时去掉
href、带aria-disabled="true",点击不跳转、不触发click,也不能用 Tab 选中。 - 不带
href的链接是按钮式链接,可以用键盘操作;带href时回车由浏览器按普通链接处理。 - 其他原生属性(如
rel、download)会透传到<a>上。