更新记录

1.0.0(2025-02-25) 下载此版本

一、组件概述

本组件是一个用于校准的前端组件,支持多种单位和自定义刻度,可在移动应用开发中方便地集成使用,为用户提供直观的校准操作界面。

组件效果展示

Snipaste_2025-02-24_13-58-12

二、安装与使用

1. 安装

本组件为 Vue 3 组件,确保你的项目是基于 Vue 3 开发的。将组件的代码文件(.vue 文件)复制到你的项目对应的组件目录下即可。

2. 使用示例

<template>
  <div>
    <!-- 引入校准组件 -->
    <Calibrate 
      :defaultValue="10"
      :unit="'mm'"
      :scaleNum="200"
      @hide="handleHide"
      @confirm="handleConfirm"
    />
  </div>
</template>

<script setup lang="ts">
import Calibrate from './path/to/calibrate.vue';

const handleHide = () => {
  console.log('组件隐藏');
};

const handleConfirm = (value) => {
  console.log('确认的值:', value);
};
</script>

三、组件属性

属性名 类型 默认值 说明
title String ' 编辑' 组件标题,显示在组件顶部
defaultValue Number 0 校准的默认值
unit String 'cm' 校准值的单位,可自定义,如 'cm'、'mm' 等
scaleNum Number 330 刻度总数,单位为最小刻度单位,例如若单位为 'cm',则默认有 330 个刻度
cancelText String ' 取消' 取消按钮的显示文案
confirmText String ' 确定' 确定按钮的显示文案
showCloseBtn Boolean true 是否显示关闭按钮
showTitle Boolean true 是否显示标题

四、组件事件

事件名 说明 回调参数
hide 当点击取消按钮或关闭按钮时触发,用于隐藏组件
confirm 当点击确定按钮时触发,返回当前校准的值 当前校准的值(字符串类型)

五、注意事项

  • 确保项目中使用的 Vue 版本为 3.x,否则可能会出现兼容性问题。
  • 刻度总数 scaleNum 应根据实际需求合理设置,避免刻度过多或过少影响用户体验。
  • 组件的样式可根据项目整体风格进行调整,修改 <style scoped> 部分的 CSS 代码即可。

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
× × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

一、组件概述

本组件是一个用于校准的前端组件,支持多种单位和自定义刻度,可在移动应用开发中方便地集成使用,为用户提供直观的校准操作界面。

组件效果展示

Snipaste_2025-02-24_13-58-12

二、安装与使用

1. 安装

本组件为 Vue 3 组件,确保你的项目是基于 Vue 3 开发的。将组件的代码文件(.vue 文件)复制到你的项目对应的组件目录下即可。

2. 使用示例

<template>
  <div>
    <!-- 引入校准组件 -->
    <Calibrate 
      :defaultValue="10"
      :unit="'mm'"
      :scaleNum="200"
      @hide="handleHide"
      @confirm="handleConfirm"
    />
  </div>
</template>

<script setup lang="ts">
import Calibrate from './path/to/calibrate.vue';

const handleHide = () => {
  console.log('组件隐藏');
};

const handleConfirm = (value) => {
  console.log('确认的值:', value);
};
</script>

三、组件属性

属性名 类型 默认值 说明
title String ' 编辑' 组件标题,显示在组件顶部
defaultValue Number 0 校准的默认值
unit String 'cm' 校准值的单位,可自定义,如 'cm'、'mm' 等
scaleNum Number 330 刻度总数,单位为最小刻度单位,例如若单位为 'cm',则默认有 330 个刻度
cancelText String ' 取消' 取消按钮的显示文案
confirmText String ' 确定' 确定按钮的显示文案
showCloseBtn Boolean true 是否显示关闭按钮
showTitle Boolean true 是否显示标题

四、组件事件

事件名 说明 回调参数
hide 当点击取消按钮或关闭按钮时触发,用于隐藏组件
confirm 当点击确定按钮时触发,返回当前校准的值 当前校准的值(字符串类型)

五、注意事项

  • 确保项目中使用的 Vue 版本为 3.x,否则可能会出现兼容性问题。
  • 刻度总数 scaleNum 应根据实际需求合理设置,避免刻度过多或过少影响用户体验。
  • 组件的样式可根据项目整体风格进行调整,修改 <style scoped> 部分的 CSS 代码即可。

隐私、权限声明

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

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

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

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问