更新记录

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 工程中使用。

  1. 将 LJJ2024-link 目录放入工程的 uni_modules/ 下;
  2. 在页面中按上面的示例引用组件;
  3. 运行外层工程到浏览器 / 小程序 / App 验证效果;
  4. 可参考插件内 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 生成)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。