1.0.2 • Published 2 months ago

@tanzhenxing/zx-contact-card v1.0.2

Weekly downloads
-
License
ISC
Repository
-
Last release
2 months ago

zx-contact-card 联系人卡片

组件介绍

zx-contact-card 联系人卡片组件以卡片的形式展示联系人信息,支持添加和编辑两种模式。该组件支持H5、小程序和App多端平台,采用Vue3 setup语法糖实现。

平台兼容性

  • H5:✓
  • 微信小程序:✓
  • 支付宝小程序:✓
  • 百度小程序:✓
  • 头条小程序:✓
  • QQ小程序:✓
  • App(Vue):✓

基础用法

添加联系人

<template>
  <zx-contact-card type="add" @click="onAdd" />
</template>

<script setup>
function onAdd() {
  console.log('添加联系人')
}
</script>

编辑联系人

<template>
  <zx-contact-card 
    type="edit" 
    name="张三" 
    tel="13000000000" 
    @click="onEdit" 
  />
</template>

<script setup>
function onEdit() {
  console.log('编辑联系人')
}
</script>

不可编辑

<template>
  <zx-contact-card 
    type="edit" 
    name="张三" 
    tel="13000000000" 
    :editable="false" 
  />
</template>

自定义文案

<template>
  <zx-contact-card 
    type="add" 
    add-text="选择联系人" 
    @click="onAdd" 
  />
</template>

自定义样式

<template>
  <zx-contact-card 
    type="add" 
    icon-size="50rpx"
    add-icon-color="#ff6b6b"
    @click="onAdd" 
  />
</template>

API

Props

参数说明类型默认值
type卡片类型,可选值为 add editStringadd
name联系人姓名String-
tel联系人手机号String-
add-text添加时的文案提示String添加联系人
editable是否可以编辑联系人Booleantrue
icon-size图标大小String40rpx
icon-color图标颜色String#666
add-icon-color添加图标颜色String#1989fa
arrow-size箭头大小String32rpx
arrow-color箭头颜色String#c8c9cc
custom-style自定义样式Object{}

Events

事件名说明回调参数
click点击时触发event: Event

主题定制

样式变量

组件提供了下列 SCSS 变量,可用于自定义样式:

名称默认值描述
$zx-contact-card-padding15px内边距
$zx-contact-card-font-size14px字体大小
$zx-contact-card-line-height20px行高
$zx-contact-card-color#333文字颜色
$zx-contact-card-background#fff背景色
$zx-contact-card-border-color#ebedf0边框颜色
$zx-contact-card-border-radius8px圆角大小
$zx-contact-card-clickable-color#f7f8fa点击态背景色
$zx-contact-card-disabled-color#c8c9cc禁用态颜色
$zx-contact-card-add-border-width2px添加模式边框宽度
$zx-contact-card-add-border-color#1989fa添加模式边框颜色
$zx-contact-card-add-border-styledashed添加模式边框样式
$zx-contact-card-title-font-size16px标题字体大小
$zx-contact-card-title-color#1989fa标题颜色
$zx-contact-card-name-font-size15px姓名字体大小
$zx-contact-card-name-color#333姓名颜色
$zx-contact-card-tel-font-size14px电话字体大小
$zx-contact-card-tel-color#666电话颜色
$zx-contact-card-icon-margin-right12px图标右边距
$zx-contact-card-arrow-margin-left12px箭头左边距

注意事项

  1. 组件依赖 zx-icon 组件,请确保已正确引入
  2. 在小程序中使用时,建议设置合适的 hover-class 样式
  3. 组件支持多端平台,无需额外配置
  4. 建议在使用前先了解 uniapp 的基本用法

更新日志

v1.0.0

  • 初始版本
  • 支持添加和编辑两种模式
  • 支持自定义样式和文案
  • 支持多端平台