更新记录

0.2.0（2026-08-27） 下载此版本

• 新增 labelSize 标签字号属性：nax-form 表单级统一（空串跟随组件默认 15px），nax-form-item 可单项覆盖（空跟随 form）

0.1.8（2026-08-21） 下载此版本

• 修复 TypeError: root.getAny is not a function（Web 端用户反馈）：对象 props（model / rules / 规则项）在部分场景下不是真实 UTSJSONObject 实例（Web 普通/响应式对象、App 渲染层桥接等），getAny/set 方法丢失导致校验与快照全部失效。

0.1.7（2026-08-18） 下载此版本

• 蒸汽模式（VUE3-VAPOR）兼容修复：nax-form-item__label-wrap--top 的下级选择器规则用 #ifndef VUE3-VAPOR 条件编译隔离，消除 "Invalid selector" 警告；VDOM/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

插槽

主题

通过 CSS 变量覆盖：

平台说明

• 控件需自行 v-model 绑定到 model 字段；提交时调用 validate()。
• 字段事件触发（blur/change）需业务侧调用 validateField(prop, 'blur')。