CInputExpressCode 快递单号输入框组件

功能说明

CInputExpressCode 是一个快递单号输入框组件，集成了文本输入框和扫码功能。用户可以通过点击扫码图标调用设备的扫码功能，将扫描的快递单号自动填入输入框中。组件会验证扫描结果是否符合快递单号格式。

引用方式

import { CInputExpressCode } from '@components/forms/input';

组件参数

• itemRes (Object，必填)：表单数据资源对象，表单组件内部机制专用
• placeholder (String，可选)：输入框占位提示文本

使用示例

基础用法

<template>
  <CForm :form="form">
    <CFormItem name="expressCode" label="快递单号">
      <CInputExpressCode placeholder="请输入或扫描快递单号" />
    </CFormItem>
  </CForm>
</template>

<script>
import { CForm, CFormItem } from '@components/forms/form';
import { CInputExpressCode } from '@components/forms/input';

export default {
  components: {
    CForm,
    CFormItem,
    CInputExpressCode
  },
  data() {
    return {
      form: {
        expressCode: ''
      }
    };
  }
};
</script>

注意事项

1. 扫码功能仅在小程序环境中可用，在其他环境中不会显示扫码图标
2. 组件会验证扫描结果是否符合快递单号格式（只允许数字和字母），不符合时会提示"请扫描快递单号！"
3. 扫码过程中，扫码图标会显示加载状态
4. 扫码取消或失败时，会显示相应的提示信息
5. 此组件主要针对快递单号的输入场景进行了优化，适用于物流、快递相关的业务场景