作者[系统]
看板PttCurrent
标题[开发资讯] 介面调整: 表单式输入界面
时间Tue Oct 27 11:31:13 CST 2026
PTT 终端机画面解析注意事项
全新宣告式表单框架 (vform) 与相关功能互动流程 (新使用者注册、个人
资料修改、看板管理选单、板主设定等) 即将上线。
若有透过终端机文字、固定座标、逐行问答 (Prompt) 或按键脚本进行
画面解析 (Screen Scraping) 与自动化操作的 App / Client 开发者,
请及早测试并更新状态机逻辑。
上线时间: PTT2 - 10/27
PTT1 - 11/1
影响范围: 所有依赖多条行式问答 (getdata / getfield) 进行注册、修改资料、
心情点播,以及依赖看板管理选单 (E) 连锁问答或解析板主名单格式
的 Client / 自动化脚本。
多数 App 并不支援这些功能。
说明:
为了提升输入体验、降低长表单误填率,并让看板资料结构更严谨,我们引进了新
的宣告式表单框架 (vform),逐步淘汰站内分散各处的旧式「逐行问答 (getdata)」,
并对看板设定与板主管理系统进行了模组化重构。
主要异动与画面行为说明如下:
1. 全新表单框架 (vform) 与互动行为变更
全站表单全面由逐行换行输入,升级为两大标准化互动模式:
(a) 全萤幕就地编辑表单 (In-place Form)
- 画面排版:顶端为标题与说明列,中央区块条列栏位:
` > 栏位名称: [ 栏位内容 ]`
游标所在列前方以黄色 ` > ` 指示并高亮栏位,末端附有该栏位详细说明。
- 游标移动:支援 方向键、`Tab` / `Shift-Tab` 移动焦点,
支援 `Home` / `End` 快速跳至首尾栏位。
- 栏位编辑:
* 文字 / 帐号:按 `Enter` 进入栏位编辑;若该栏为空,游标移入时会自动
进入编辑流程。使用者帐号栏位支援按「空白键」自动补完。
* 开关 (Bool):按「空白键」直接切换,或按 `y`/`n` 设定。
* 选单 (Select):按「空白键」轮播切换选项,或直接输入数字键。
- 储存送出:
* 填写完毕随时可按 `Ctrl-X` 直接储存表单。
* 若一路按 `Enter` 依序编辑到最後一个栏位,送出时亦会触发储存。
- 离开与放弃 (重要!状态机请注意):
* 按 `q`、`Q` 或 `Esc` 离开表单。
* 若表单内容【未被修改】,直接退出回到前一层。
* 若表单内容【已有变更】,底部会弹出确认列防呆:
`[Y/S]储存 (N/A/Q)放弃 (E)继续编辑`
`确定要储存变更吗? `
此时可按 `y` 确认储存、按 `n` 放弃离开,或按 `e` 继续编辑。
(b) 步骤精灵向导 (Wizard Form)
- 适用於流程较长、需依序审阅说明档 (notes file) 的表单(如注册审核)。
- 顶端提示 ` [ 项目 X / Y ] 栏位名称 (提示说明)` 与当前设定值。
- 支援回溯:填写过程中可随时按方向键或 `Shift-Tab` 回到上一项重新填写。
- 取消流程:按 `Ctrl-C` 会提示 `确定要放弃填写吗?[y/N]: `。
- 审查确认:全部填写完成後会显示总结清单(Summary Review),并提示
`以上资料是否正确?(Y/n/q) [Y]: `。
2. 核心功能画面迁移至 vform
(a) 新使用者注册流程 (New User Registration)
- 建立帐密後的「填写个人基本资料」由原本萤幕下方第 17 列起逐行提问
(绰号昵称:、真实姓名:、服务单位:、联络地址:、年满十八岁...),
全面改为表单【填写个人资料】。
- 表单包含:「绰号昵称」、「真实姓名」、「服务单位」、「联络地址」、
「年满 18 岁」。全部填写完成後需按 `Ctrl-X`(或在最後一栏Enter)储存。
(b) 注册单人工审核 (u_manual_verification)
- 由旧版逐行提问改为 Wizard 精灵表单【注册单人工审核】。
- 包含:「是否现在住在台湾」、「真实姓名」、「服务单位」、「目前住址」,
每步皆附有规范说明档,填完後有资料总结清单供确认。
(c) 个人偏好与个人资料修改 ((U) Customize -> (I) Info -> 1 修改个人资料)
- 由逐行输入改为 In-place 表单【修改个人资料】。
- 一般使用者提供「昵称」与「年满 18 岁」设定;管理员模式下才会动态展开
真实姓名、居住地址、学历职业等栏位。
(d) 心情点播留言 ((E) 休闲游乐 -> (O) 点歌留言)
- 改为 In-place 表单【心情点播留言】。
- 栏位包含:「留言者」、「留言给」、「想说的话 (必填)」、「转寄信箱」。
- 转寄信箱输入时会即时检查是否为站内有效 ID 及对方是否拒收。
(e) 投票记录选项设定 (发起投票 / 投票设定维护)
- 改为 In-place 表单【投票记录选项设定】(记录帐号/IP/时间/选项)。
- 若设定为记名投票(同时记录帐号与选项),会在储存时跳出警示确认。
* 给第三方程式开发者的建议
1. 自动注册与个人资料填写脚本更新:
若您的 Client 提供自订注册介面,请注意新使用者注册已不再出现旧版的
`绰号昵称:` 等逐行提示字串。请调整状态机辨识顶端标题【填写个人资料】,
送入资料後请务必【送出 Ctrl-X (ASCII 0x18)】以储存并完成注册。
2. 表单离开与防呆流程:
若脚本需要放弃或跳出表单,若曾更动过栏位,在送出 `q` 或 `Esc` 後,画面会停在
`确定要储存变更吗?`。请确认您的状态机能够处理该确认提示(送出 `a` 或 `q`
放弃,或送出 `s` 储存),避免流程卡死在表单退出画面。
--
※ 发信站: 批踢踢实业坊(ptt.cc)