b553c4e519
- API 路由统一: 移除 /api/h5/，统一 /api/pms/ 入口 - 二进制改名: api-server -> pms-api（与服务名一致） - nginx: 合并 /api/ + /pms/api/ 为 /api/pms/ - 新增 docs/API.md 接口文档 - 后端: CabinetDetail 增加 rssi/pow_fail/address/soc 等字段 - Redis 管道批量读取仓体实时数据（SOC/电压/电流/功率） - DB: 所有 TIMESTAMP 列改为 DATETIME（修复类型不匹配） - 用户管理: 新增创建时间/修改时间列，状态改用 Switch - 角色管理/用户管理: 操作按钮改为图标 - PC 设备详情: 基本信息补全 RSSI/ICCID/电源/地址 - PC 卡片: 通道统计改用 Lucide 图标，颜色统一 - PC 二维码: canvas 渲染，含编号文字，支持右键下载 - H5: 按 uni-app 规范修正导航（navigateTo 替代 reLaunch） - H5: 详情页加返回导航条 - H5: 扫码支持摄像头（jsQR）+ ?id= 参数 - H5: 底部 tabBar 在所有页面常显 - H5: 首页统计改为 6 项（设备/通道/空闲/充电/充满/故障） - H5: 下拉刷新 / 上拉加载 - 产品首页: 添加业务联系 - 文档: 清理过时文件，补充缺失规范章节
2.2 KiB
2.2 KiB
title, impact, impactDescription, type, tags
| title | impact | impactDescription | type | tags | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Textarea Interpolation is One-Way Only - Use v-model for Two-Way Binding | HIGH | Using {{ text }} inside textarea displays initial value but user input does NOT update the ref | capability |
|
Textarea Interpolation is One-Way Only - Use v-model for Two-Way Binding
Impact: HIGH - Interpolation in textarea ({{ text }}) provides one-way binding only - it displays the initial value but user input does NOT update the ref. This creates a confusing disconnect where the textarea shows content but edits are silently lost.
Unlike v-model which provides two-way binding, interpolation only renders the initial ref value into the textarea. When users type, the ref remains unchanged, making form submissions return stale data. Always use v-model for two-way binding in textareas.
Task Checklist
- Never use interpolation inside textarea tags
- Always use v-model for textarea two-way binding
- Search codebase for
<textarea>{{patterns that may be silently broken - Add linting rules to catch this pattern if possible
Incorrect:
<script setup>
import { ref } from 'vue'
const message = ref('Hello World')
</script>
<template>
<!-- WRONG: One-way binding only! Shows initial value but edits don't update ref -->
<textarea>{{ message }}</textarea>
<!-- Also WRONG: User can type but changes are lost -->
<textarea>{{ userBio }}</textarea>
<!-- The textarea displays content but ref never updates -->
</template>
Correct:
<script setup>
import { ref } from 'vue'
const message = ref('Hello World')
</script>
<template>
<!-- CORRECT: Use v-model for textarea -->
<textarea v-model="message"></textarea>
<!-- For read-only display, still use v-model or :value -->
<textarea v-model="message" readonly></textarea>
<!-- Or one-way binding with :value -->
<textarea :value="message" readonly></textarea>
</template>
<!-- With placeholder and other attributes -->
<textarea
v-model="message"
placeholder="Enter your message..."
rows="5"
maxlength="500"
></textarea>