更新记录
0.0.1(2025-01-02) 下载此版本
- init
平台兼容性
Vue2 | Vue3 |
---|---|
× | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 4.42 app-vue app-uvue | × | √ | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 | 鸿蒙元服务 |
---|---|---|---|---|
× | × | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
√ | × | × | × | √ | × | × | × | × |
lime-link 超链接
- lime-link 超链接标签,可在应用内跳转链接,在app还能打开外部浏览器,兼容uniapp/uniappx
- 插件依赖
lime-style
、lime-call
、lime-shared
、lime-icon
不喜勿下
安装
在插件市场导入即可,首次导入可能需要重新编译
注意
- 🔔 本插件依赖的lime-svg在 uniapp x app中是原生插件,如果购买(收费为5元)则需要自定义基座,才能使用!uniapp可忽略。
- 🔔 如果不需要lime-svg在lime-icon代码中注释掉即可
// lime-icon/components/l-icon.uvue 第4行 注释掉即可。
<!-- <l-svg class="l-icon" :class="classes" :style="styles" :color="color" :src="iconUrl" v-else :web="web" @error="imageError" @load="imageload" @click="$emit('click')"></l-svg> -->
代码演示
基础使用
通过url
可设置在应用内跳转,href
可在APP端打开外部浏览器拨号等功能。
<l-link type="primary" url="/pages/test/index">内部跳转</l-link>
<l-link href="https://www.baidu.com">外部跳转</l-link>
<l-link type="primary" href="tel://177xxxxxx">拨号</l-link>
<l-link>跳转链接</l-link>
下划线
通过underline
可设置下划线。
<l-link underline type="primary" url="/pages/test/index">跳转链接</l-link>
<l-link underline>跳转链接</l-link>
图标
通过prefix-icon
可设置前置图标,suffix-icon
可设置后置图标,图标库。
<l-link url="/pages/test/index" prefix-icon="link">跳转链接</l-link>
<l-link suffix-icon="jump">跳转链接</l-link>
尺寸
通过size
可设置文本和图标的大小,可选值:small
,large
默认为medium
,也可以设置具体的值如30px
。
<l-link type="primary" size="large" url="/pages/test/index" prefix-icon="link">跳转链接</l-link>
<l-link prefix-icon="link">跳转链接</l-link>
<l-link prefix-icon="link" size="small">跳转链接</l-link>
<l-link prefix-icon="link" size="30px">自定义大小</l-link>
颜色
通过type
可设置链接主题色,可选值:primary
、danger
、info
、warning
、success
、default
,也通过通过color
设置具体的颜色。
<l-link size="large" prefix-icon="link">跳转链接</l-link>
<l-link type="primary" prefix-icon="link">跳转链接</l-link>
<l-link type="danger" prefix-icon="link">跳转链接</l-link>
<l-link type="info" prefix-icon="link">跳转链接</l-link>
<l-link type="warning" prefix-icon="link">跳转链接</l-link>
<l-link type="success" prefix-icon="link">跳转链接</l-link>
<l-link color="#ee0a24" prefix-icon="link">自定义颜色</l-link>
打开外部链接API
在APP端,如果只想使用API打开外部链接,可以使用下面代码。该代码来源于uts-openSchema
import { openSchema, canOpenURL } from '@/uni_modules/lime-link'
// #ifdef UNI-APP-X
// 使用外部浏览器打开指定URL
openSchema('https://uniapp.dcloud.io/uni-app-x')
// #ifdef APP-ANDROID
// Android 使用应用商店打开指定App
openSchema('market://details?id=com.tencent.mm')
// Android 打开地图坐标
// 可以先用canOpenURL判断是否安装了地图软件
if (canOpenURL('androidamap://')) {
openSchema('androidamap://viewMap?sourceApplication=Hello%20uni-app&poiname=DCloud&lat=39.9631018208&lon=116.3406135236&dev=0')
} else {
console.log('未安装高德地图')
}
// #endif -->
// #ifdef APP-IOS
// 打开 AppStore 到搜索页
openSchema('itms-apps://search.itunes.apple.com//WebObjects//MZSearch.woa/wa/search?media=software<erm=')
// 打开 iOS 地图坐标
openSchema('http://maps.apple.com/?q=Mexican+Restaurant&sll=50.894967,4.341626&z=10&t=s')
// #endif -->
// #endif -->
查看示例
- 导入后直接使用这个标签查看演示效果
<!-- // 代码位于 uni_modules/lime-link/compoents/lime-link -->
<lime-link />
插件标签
- 默认 l-link 为 component
- 默认 lime-link 为 demo
关于vue2的使用方式
- 插件使用了
composition-api
, 如果你希望在vue2中使用请按官方的教程vue-composition-api配置 - 关键代码是: 在main.js中 在vue2部分加上这一段即可
// vue2 import Vue from 'vue' import VueCompositionAPI from '@vue/composition-api' Vue.use(VueCompositionAPI)
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
url | 应用内跳转的链接。 | string | - |
href | 应用外跳转的链接。 | string | - |
openType | 应用内跳转方式:navigate/redirect/switchTab/reLaunch/navigateBack/exit'。 | string | navigate |
prefixIcon | 左侧图标。 | string | - |
suffixIcon | 右侧图标。 | string | - |
type | 内置主题。可选项:info/success/warning/danger/default | string | default |
disabled | 是否为禁用态 | boolean | false |
underline | 是否显示链接下划线 | boolean | false |
size | 尺寸。可选项:small/medium/large/具体数字 | string | - |
content | 链接内容 | string | - |
color | 自定义颜色 | string | - |
navigatorProps | 与 navigator 原生组件属性保持一致,具体使用参考:navigator | Object | - |
主题定制
样式变量
组件提供了下列 CSS 变量,可用于自定义样式。uvue app无效
名称 | 默认值 | 描述 |
---|---|---|
--l-link-default-color | $text-color-1 | - |
--l-link-primary-color | $primary-color | - |
--l-link-success-color | $success-color | - |
--l-link-warning-color | $warning-color | - |
--l-link-danger-color | $error-color | - |
--l-link-info-color | $blue | - |
--l-link-icon-size | 28rpx | - |
--l-link-font-size | $font-size | - |
打赏
如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。