更新记录
1.0.0(2026-11-20) 下载此版本
2026.11.19
平台兼容性
uni-app(4.66)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | - | √ | - | - | - | - | - | - |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| - | - | - | - | - | - | - | - | - | - | - | - |
LJJ2024-link 超链接组件 · 使用说明
组件名:
LJJ2024-link作者ID:LJJ2024 插件ID:LJJ2024-link版本:1.0.0 基于 DCloud 官方uni-link 超链接插件二次改造,仅供课程作业学习使用。
一、插件简介
LJJ2024-link 是一个外部网页超链接组件,按平台自动适配打开方式:
- H5 端:点击后在浏览器新标签页打开链接;
- App 端:调用外部浏览器打开链接;
- 小程序端:自动复制链接地址并弹窗提示;
- 自动识别
tel:拨号链接与mailto:邮件链接。
在原 uni-link 基础上,本插件做了如下改造:
| 改造点 | 说明 |
|---|---|
| 默认链接颜色 | 由灰色 #999999 改为主题蓝 #2979ff |
新增 bold 属性 |
控制链接文字是否加粗 |
新增 activeColor 属性 |
配置按压时的文字反馈颜色 |
新增 wrap 属性 |
控制长链接是否允许换行 |
新增 copy 事件 |
小程序端复制链接成功后触发,回传链接地址 |
| 组件标识 | 目录名、组件文件名、name 统一为 LJJ2024-link / LJJ2024Link,作者标注 @author LJJ2024 |
二、目录结构
将本目录整体放入 uni-app 工程的 uni_modules 目录下:
your-project/
└── uni_modules/
└── LJJ2024-link/
├── components/
│ └── LJJ2024-link/
│ └── LJJ2024-link.vue
├── example/
│ └── LJJ2024-link-demo.vue
├── package.json
├── readme.md
├── changelog.md
└── 插件使用说明.md
遵循 uni_modules 规范,组件放入后无需手动 import、无需在 components 中注册,可直接在页面中使用。
三、快速上手
3.1 最简用法
<template>
<view>
<LJJ2024-link
href="https://ext.dcloud.net.cn"
text="DCloud 数字天堂插件市场"
/>
</view>
</template>
3.2 完整示例
<template>
<view class="demo">
<!-- 基础链接 -->
<LJJ2024-link
href="https://ext.dcloud.net.cn"
text="DCloud 数字天堂插件市场"
/>
<!-- 自定义颜色、字号、加粗、无下划线 -->
<LJJ2024-link
href="https://uniapp.dcloud.net.cn"
text="uni-app 官方文档"
color="#e4393c"
:font-size="16"
:bold="true"
:show-under-line="false"
/>
<!-- 长链接换行 + 复制回调 -->
<LJJ2024-link
href="https://ext.dcloud.net.cn/plugin?id=1182"
text="https://ext.dcloud.net.cn/plugin?id=1182"
:wrap="true"
@copy="onCopy"
/>
<!-- 拨号 -->
<LJJ2024-link href="tel:10086" text="拨打电话 10086" />
<!-- 邮件 -->
<LJJ2024-link href="mailto:hello@example.com" text="发送邮件" />
</view>
</template>
<script>
export default {
methods: {
onCopy(url) {
console.log('已复制链接:', url)
uni.showToast({ title: '已复制:' + url, icon: 'none' })
}
}
}
</script>
3.3 使用插槽自定义内容
未传 text 时,组件默认使用默认插槽内容:
<LJJ2024-link href="https://ext.dcloud.net.cn">
<text style="color: #2979ff">点我跳转插件市场</text>
</LJJ2024-link>
四、属性(Props)
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
href |
String |
'' |
点击后打开的地址,支持 http / https / tel: / mailto: |
text |
String |
'' |
显示的文字;也可通过默认插槽传入 |
download |
String |
'' |
H5 平台下载文件名 |
showUnderLine |
Boolean / String |
true |
是否显示下划线 |
bold |
Boolean / String |
false |
是否加粗 |
copyTips |
String |
已自动复制网址,请在手机浏览器里粘贴该网址 |
小程序端复制链接后的提示语 |
color |
String |
#2979ff |
链接文字颜色 |
activeColor |
String |
#1653a8 |
按压时的文字反馈颜色 |
fontSize |
Number / String |
14 |
链接文字大小,单位 px |
wrap |
Boolean / String |
true |
是否允许长链接换行 |
说明:布尔型属性在模板中可传布尔值,也可传字符串
"true"/"false",组件内部已做兼容判断。
五、事件(Events)
| 事件名 | 回调参数 | 说明 |
|---|---|---|
copy |
(url: String) |
小程序端复制链接成功后触发,参数为被复制的地址 |
示例:
<LJJ2024-link
href="https://ext.dcloud.net.cn"
text="插件市场"
@copy="onCopy"
/>
methods: {
onCopy(url) {
console.log('复制成功:', url)
}
}
六、平台兼容性
| App(vue) | App(nvue) | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ 小程序 |
|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ |
| Vue 版本 | Vue2 | Vue3 |
|---|---|---|
| 支持 | √ | √ |
七、运行与自测
注意:插件目录本身不是独立工程,不能单独编译运行,否则会报"缺少
pages.json文件"。请在完整的 uni-app 工程中使用。
- 将
LJJ2024-link目录放入工程的uni_modules/下; - 在页面中按上面的示例引用组件;
- 运行外层工程到浏览器 / 小程序 / App 验证效果;
- 可参考插件内
example/LJJ2024-link-demo.vue演示页面。
八、常见问题
1. 运行时报"项目下缺少 pages.json 文件,编译失败"
你直接选中了插件目录运行。请打开外层 uni-app 工程目录运行;插件目录仅用于右键「发布到插件市场」。
2. 提示插件 ID 已被占用
将插件 ID 改为带区分后缀的名称,例如 LJJ2024-link-pro,并同步修改:
- 插件目录名;
components下的组件目录名与组件文件名;package.json中的id字段。
3. 如何替换为自己的作者 ID
全局搜索并替换 LJJ2024 为本人姓名拼音简写 + 2024(例:张三 → ZS2024),需保持目录名、package.json 的 id、组件名三处一致。
九、版权说明
本插件基于 DCloud 官方开源组件 uni-link 二次修改,原组件仓库:https://github.com/dcloudio/uni-ui。
原插件市场地址:https://ext.dcloud.net.cn/plugin?id=1182。
本文档与改造代码仅供课程作业学习使用。
(注:部分内容由豆包 AI 生成)

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
赞赏(0)
下载 1
赞赏 0
下载 12777094
赞赏 1960
赞赏
京公网安备:11010802035340号