Translation in progress
This page hasn't been translated into English yet, so the content below is in Chinese. The code examples work the same way.
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>上。