af-mobile-client-vue3 1.6.30 → 1.6.32

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "af-mobile-client-vue3",
   "type": "module",
-  "version": "1.6.30",
+  "version": "1.6.32",
   "packageManager": "pnpm@10.13.1",
   "description": "Vue + Vite component lib",
   "engines": {

package/src/components/core/Signature/AdaptiveSignatureField.vue

@@ -0,0 +1,172 @@
+<script setup lang="ts">
+import type { SignatureComponentExpose, SignatureComponentProps } from './signature'
+import XSignature from '@af-mobile-client-vue3/components/data/XSignature/index.vue'
+import { upload } from '@af-mobile-client-vue3/services/api/common'
+import { isNativeApp } from '@af-mobile-client-vue3/utils/environment'
+import { showFailToast, Field as VanField } from 'vant'
+import { onMounted, ref, watch } from 'vue'
+import SignatureComponent from './SignatureComponent.vue'
+
+const props = withDefaults(defineProps<SignatureComponentProps & {
+  serviceName?: string
+}>(), {
+  label: '用户签字',
+  required: false,
+  disabled: false,
+  uploadMode: 'server',
+  imageList: null,
+  formReadonly: false,
+  isAsyncUpload: false,
+  serviceName: undefined,
+})
+
+const emit = defineEmits<{
+  signatureComplete: [data: any]
+}>()
+
+// App / Flutter 壳走原生签字板；浏览器、微信等走 H5 签名
+const isApp = ref(isNativeApp())
+onMounted(() => {
+  // 部分 WebView 桥接注入略晚于首屏，挂载后再判一次
+  isApp.value = isNativeApp()
+})
+
+const nativeSignatureRef = ref<InstanceType<typeof SignatureComponent>>()
+const webSignatureImage = ref('')
+const webSignatureData = ref<any>(null)
+const webUploading = ref(false)
+
+const serviceName = props.serviceName || import.meta.env.VITE_APP_SYSTEM_NAME
+
+watch(
+  () => props.imageList,
+  (list) => {
+    if (isApp.value || !Array.isArray(list) || !list[0]?.url)
+      return
+    webSignatureImage.value = list[0].url
+  },
+  { immediate: true, deep: true },
+)
+
+async function uploadWebSignature(base64Image: string) {
+  const blob = await (await fetch(base64Image)).blob()
+  const filename = `signature_${Date.now()}.png`
+  const file = new File([blob], filename, { type: blob.type || 'image/png' })
+  const formData = new FormData()
+  formData.append('avatar', file)
+  formData.append('resUploadMode', props.uploadMode)
+  formData.append('pathKey', 'Default')
+  formData.append('formType', 'image')
+  formData.append('useType', 'Default')
+  formData.append('resUploadStock', '1')
+  formData.append('filename', filename)
+  formData.append('filesize', (file.size / 1024 / 1024).toFixed(4))
+  formData.append('f_operator', 'server')
+
+  return upload(formData, serviceName, { 'Content-Type': 'multipart/form-data' })
+}
+
+function resetWebSignature() {
+  webSignatureImage.value = ''
+  webSignatureData.value = null
+}
+
+async function handleWebSignatureSave(base64Image: string) {
+  if (props.disabled || props.formReadonly || webUploading.value)
+    return
+
+  webUploading.value = true
+  try {
+    const res: any = await uploadWebSignature(base64Image)
+    if (!res?.data?.id) {
+      showFailToast('签名上传失败')
+      resetWebSignature()
+      return
+    }
+    webSignatureData.value = res.data
+    emit('signatureComplete', { status: 'success', data: res.data })
+  }
+  catch (error) {
+    console.error('签名上传失败:', error)
+    showFailToast('签名上传失败')
+    resetWebSignature()
+  }
+  finally {
+    webUploading.value = false
+  }
+}
+
+function handleWebSignatureClear() {
+  resetWebSignature()
+  emit('signatureComplete', { base64: '', status: 'cleared' })
+}
+
+defineExpose<SignatureComponentExpose>({
+  clearSignature() {
+    if (isApp.value)
+      nativeSignatureRef.value?.clearSignature()
+    else
+      handleWebSignatureClear()
+  },
+  hasSignature() {
+    if (isApp.value)
+      return nativeSignatureRef.value?.hasSignature() ?? false
+    return !!webSignatureData.value?.id || !!webSignatureImage.value
+  },
+  getSignatureData() {
+    if (isApp.value)
+      return nativeSignatureRef.value?.getSignatureData() ?? ''
+    return webSignatureImage.value.replace(/^data:image\/\w+;base64,/, '')
+  },
+  previewSignature() {
+    nativeSignatureRef.value?.previewSignature()
+  },
+  getSignatureList() {
+    if (isApp.value)
+      return nativeSignatureRef.value?.getSignatureList() ?? []
+    if (!webSignatureData.value)
+      return []
+    return [{
+      photo_name: webSignatureData.value.f_filename,
+      id: webSignatureData.value.id,
+      f_downloadpath: webSignatureData.value.f_downloadpath,
+    }]
+  },
+})
+</script>
+
+<template>
+  <!-- App：原生签字板 -->
+  <SignatureComponent
+    v-if="isApp.value"
+    ref="nativeSignatureRef"
+    :label="label"
+    :required="required"
+    :disabled="disabled"
+    :upload-mode="uploadMode"
+    :image-list="imageList"
+    :form-readonly="formReadonly"
+    :is-async-upload="isAsyncUpload"
+    @signature-complete="emit('signatureComplete', $event)"
+  />
+  <!-- 非 App：H5 在线签名（浏览器、微信等） -->
+  <VanField
+    v-else
+    center
+    name="signature"
+    :label="label"
+    :required="required"
+  >
+    <template #input>
+      <XSignature
+        v-model="webSignatureImage"
+        button-text="点击签字"
+        :show-button-after-signed="true"
+        :show-sign-button="!formReadonly"
+        :show-preview="true"
+        @save="handleWebSignatureSave"
+        @clear="handleWebSignatureClear"
+      />
+    </template>
+  </VanField>
+</template>

package/src/components/data/XFormItem/index.vue

@@ -2,7 +2,7 @@
 import type { FieldType } from 'vant'
 import type { Numeric } from 'vant/es/utils'
 import ImageUploader from '@af-mobile-client-vue3/components/core/ImageUploader/index.vue'
-import SignatureComponent from '@af-mobile-client-vue3/components/core/Signature/SignatureComponent.vue'
+import AdaptiveSignatureField from '@af-mobile-client-vue3/components/core/Signature/AdaptiveSignatureField.vue'
 import XDatePicker from '@af-mobile-client-vue3/components/core/XDatePicker/index.vue'
 import XGridDropOption from '@af-mobile-client-vue3/components/core/XGridDropOption/index.vue'
 import XMultiSelect from '@af-mobile-client-vue3/components/core/XMultiSelect/index.vue'
@@ -1275,17 +1275,17 @@ function commChange() {
         />
       </template>
     </VanField>
-    <!-- 手机端签字 -->
-    <SignatureComponent
+    <!-- 签字：App 原生签字板，微信/浏览器 H5 在线签名 -->
+    <AdaptiveSignatureField
       v-if="attr.type === 'signature' && showItem"
       :label="labelData"
       upload-mode="server"
       :image-list="(modelData as any[])"
-      authority="admin"
-      :required="attr.rule?.required"
+      :required="attr.rule?.required === 'true'"
       :disabled="attr.disabled"
       :form-readonly="readonly"
       :is-async-upload="isAsyncUpload"
+      :service-name="serviceName"
       @signature-complete="signatureComplete"
     />
 

package/src/utils/environment.ts

@@ -44,6 +44,33 @@ function inferPlatformFromUserAgent(userAgent: string): string {
   return 'unknown'
 }
 
+/**
+ * 获取 Flutter / 原生桥接所在的 window（微前端子应用需用 rawWindow）
+ */
+export function getNativeBridgeWindow(): Record<string, any> {
+  if (typeof window === 'undefined')
+    return {}
+  const w = window as any
+  if (w.__MICRO_APP_ENVIRONMENT__ && w.rawWindow)
+    return w.rawWindow
+  return w
+}
+
+/**
+ * 是否已注入 Flutter JS Bridge（如 showSignaturePad.postMessage）
+ */
+export function hasFlutterBridge(bridgeName = 'showSignaturePad'): boolean {
+  const win = getNativeBridgeWindow()
+  return typeof win[bridgeName]?.postMessage === 'function'
+}
+
+/**
+ * 是否在 App 原生壳内（含 Flutter WebView）
+ */
+export function isNativeApp(): boolean {
+  return detectEnvironment().isApp || hasFlutterBridge()
+}
+
 /**
  * 检测当前运行环境
  */
@@ -63,10 +90,11 @@ export function detectEnvironment(): EnvironmentInfo {
   // 检测微信小程序环境
   const isMiniprogram = isWechat && /miniprogram/i.test(userAgent)
 
-  // 检测App环境 - 使用括号明确优先级
+  // 检测App环境：UA 标识 / iOS WKWebView / Flutter JS Bridge
   const isApp = (
-    /myapp|customapp|afmobileview/.test(userAgent)
+    /myapp|customapp|afmobileview|flutter/i.test(userAgent)
     || (Object.prototype.hasOwnProperty.call(window, 'webkit') && !!(window as any).webkit?.messageHandlers)
+    || hasFlutterBridge()
   )
 
   // 检测浏览器环境