作者[系統]
看板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)