更新记录

0.1.2（2026-07-31） 下载此版本

• 修复 Android 端 inject(..., null) 将注入类型推断为 Void，导致 ComputedRef cannot be cast to java.lang.Void 并使表单项无法渲染：父表单统一提供 Ref 状态，子项使用同类型默认值与空函数兜底。
• 补充 APP-ANDROID 下表单、表单项、内容区、控件行和分隔线的 flex 拉伸与宽度约束。iOS、鸿蒙、Web 与小程序行为保持不变。

平台兼容性

uni-app x(4.25)

其他

nax-form

uni-app x 表单 / 表单项，功能覆盖常用场景。

依赖

• nax-icon（表单项左右图标）
• nax-ui-theme（CSS 变量 --nax-*，安装时依赖 / 运行时弱依赖）

基础用法

<template>
  <nax-form ref="formRef" :model="form" :rules="rules" label-width="80" error-type="message">
    <nax-form-item label="姓名" prop="name" required>
      <nax-input v-model="form.name" border placeholder="请输入姓名"></nax-input>
    </nax-form-item>
    <nax-form-item label="简介" prop="intro">
      <nax-input v-model="form.intro" border placeholder="请输入简介"></nax-input>
    </nax-form-item>
  </nax-form>
  <nax-button type="primary" label="提交" @click="onSubmit"></nax-button>
</template>

<script setup lang="uts">
const formRef = ref(null)
const form = reactive({
  name: '',
  intro: ''
} as UTSJSONObject)

const rules = {
  name: [
    { required: true, message: '请输入姓名', trigger: ['blur', 'change'] }
  ],
  intro: [
    { min: 3, max: 50, message: '简介 3-50 字' }
  ]
} as UTSJSONObject

function onSubmit() {
  const comp = formRef.value
  if (comp == null) {
    return
  }
  // 通过 defineExpose 暴露的 validate
  comp.validate().then((_ok: boolean) => {
    uni.showToast({ title: '校验通过', icon: 'none' })
  }).catch((_err: any) => {
    // 字段错误已展示
  })
}
</script>

小程序端若对象里的函数规则被过滤，请在 onReady 中调用 setRules(rules)。

nax-form Props

nax-form Methods（ref）

规则字段（常用）

未内置 validator 异步自定义函数（蒸汽模式 / 小程序传函数限制）；复杂逻辑可在提交前自行判断。

nax-form-item Props

插槽

主题 Token

平台说明

• Android 端的 provide/inject 使用明确 Ref 与函数默认类型，避免 null 被推断成 Void；同时通过 APP-ANDROID 为表单及表单项补充原生 flex 拉伸与宽度约束。
• 控件需自行 v-model 绑定到 model 字段；提交时调用 validate()。
• 字段事件触发（blur/change）需业务侧调用 validateField(prop, 'blur')；后续可与输入类组件深度集成。