AI 生成的網頁可以直接上線嗎?表單、手機版與 SEO 檢查
AI 生成網站後,先確認表單真正收件、失敗提示、手機操作,以及 noindex 和 canonical 是否仍指向測試環境。
HTML欄位移到表單外就沒送出:用form指定所屬表單
重新排版表單後,有些欄位移到側欄或固定操作區,畫面仍看得到,提交資料卻少了一項。先查欄位的所屬表單。普通欄位放在form外,不會只因為靠近某個表單就自動加入;需要跨版型放置時,可以用欄位的form屬性指定表單的唯一id。 這不是把整份網頁都當成一張表單。每個欄位有自己的所屬關係,提交時再按控制項狀態和name整理資料。本文用兩個獨立表單比較FormData,讓你先確認欄位究竟連到哪裡,再回頭調整實際版型。 用form id連接外部欄位 <form id="main"> <input name="inside" value="A"> </form> <input id="outside" name="outside" value="B" form="main"> <button type="submit" form="main">送出</button> outside和送出按鈕雖然在form元素外,仍能透過form="main"連到id為main的表單。這個值是表單id,不是表單name,也不是欄位name。欄位name負責資料鍵名,form屬性則負責所屬表單,兩者不要混淆。 這種寫法可以讓版型把欄位與按鈕分放不同區域,但表單必須存在於同一份文件中,而且id唯一。它不會跨iframe去尋找另一份文件的表單,也不會因為某個遠端頁面上剛好有main就建立關聯。 先查input.form,不要只看位置 const input = document.querySelector('#outside'); console.log(input.form?.id); input的form屬性可查看瀏覽器已判定的所屬表單。如果結果是undefined或null,要查它是否真的在某個form裡、form屬性有沒有對上存在的id。若連到另一個表單,則看是否被明確的form屬性指定了其他目標。 外部欄位即使顯示在表單正下方,也不代表它會跟著提交;反過來,一個控制項也可能因明確指定form而屬於畫面上較遠的表單。重排模板時,DOM父子關係和form owner都要核對,不能只憑CSS位置判斷。 用兩個表單比較實際資料 <form id="main"> <input name="inside" value="A"> </form> <form id="other"></form> <input id="outside" name="outside" value="B"> <input id="linked" name="linked" value="C" form="main"> const main = document.querySelector('#main'); console.log([...new FormData(main).entries()]); 在Chromium154的這組獨立頁面,main的資料起初只有inside=A和linked=C。outside雖然有name和值,仍未屬於任何表單,所以沒有加入。把outside加上form="main"後,資料才多出outside=B。 接著把linked改成form="other",main就不再包含linked;other的FormData則包含linked=C。這是欄位所屬關係改變,不是資料因為空值被忽略。對多表單頁面而言,一個看似無害的form屬性就可能讓資料提交到另一段流程。 fieldset的form不會傳給子欄位 <fieldset form="main"> <input name="nested" value="D"> </fieldset> 這段fieldset在main外,給它form="main"不會讓裡面的input自動繼承所屬表單。在本例中nested的input.form仍為null,main的FormData也沒有nested。若你要讓這個外部input參與main提交,應在input本身設定form="main"。 表單不是靠一個任意外層區塊就能把資料「整包掛上去」。像把section或div加form屬性,也不能當成欄位關聯機制。應使用支援form關聯的控制項,逐一確認實際owner,再用提交資料檢查結果。 如果子欄位本來就在main內,則可以透過所在的form取得關聯;這與外部fieldset不繼承是兩回事。範例故意把fieldset放在form外,讓差異清楚。排查時要保留你實際的DOM結構,不要把欄位臨時移回form裡測通,就以為外部版型也已經修好。 有所屬表單,仍要符合提交條件 正確form owner不保證每個欄位都會出現在FormData。例如沒有name的欄位不會以你期待的鍵名提交,disabled控制項通常也不會加入;核取方塊還要看是否勾選。這些是資料收集的規則,應在所屬關係確認後再逐項排查。 required與FormData也有不同用途。new FormData整理可提交欄位,並不會替你完成整張表單的交互驗證。如果你用JavaScript自定義提交,還要確認使用者真正的送出路徑是否檢查有效性,不要只看到資料物件建立成功就判定所有欄位都合格。 後端更不能因為欄位帶有form屬性就相信它來自正確介面。使用者可以自行組織請求,所以權限、必填、允許值與資料型別仍須在後端驗證。form屬性解決的是瀏覽器裡控制項的歸屬,不能代替安全或業務規則。 避免用巢狀form包住版型 HTML不允許把form當成一般容器反覆巢狀。若為方便排版把一張form塞進另一張,瀏覽器解析出的結構可能與原始碼想像不同,控制項歸屬也容易混亂。把佈局區塊改用合適容器,表單本身保持清楚獨立,再用form屬性連接外部控制項。 元件式版型尤其要看最終DOM。父元件可能已有form,子元件又包了一張,開發者只看各自檔案時不易發現。用瀏覽器檢查實際元素樹與input.form,能看出組合後究竟是哪個表單負責欄位。 不要用JavaScript提交時遍歷全頁所有input來補漏。多表單頁面可能混入搜尋、登入與聯絡欄位,全部收集反而會把無關資料送出去。先修正每份表單的關聯,再使用那張表單的資料,範圍會比較清楚。 重排後核對兩份資料各自的內容 外部送出按鈕也要一起核對。按鈕的form指到哪一張表單,點擊時就會走那張表單的提交流程;如果版型複製後只改欄位卻漏改按鈕,畫面可能顯示一份資料,實際送出的卻是另一份。使用明確的type="submit"與form值,讓後來維護的人看得懂它的作用。 若同一份表單有「儲存草稿」與「正式提交」兩個按鈕,還要看按鈕是否使用不同的提交覆寫設定。這不是把欄位掛到表單後就自然解決的問題。先維持你原本的功能約定,再分別點擊兩個入口觀察請求;不要為了版型方便,把原本不同的操作合成一個含糊的送出事件。 對多步驟表單而言,藏起來的欄位仍可能屬於同一張表單。你應先決定每一步哪些資料可以保留、哪些要停用或重設,再核對提交結果。form owner只說明歸屬,不會按畫面是否可見替你決定哪些資料應該保留。把這些規則留在表單邏輯裡,後續改版較不容易誤刪使用者已填的內容。...
HTML點標籤卻沒選中欄位:for要對上唯一id
表單的文字放在欄位旁邊,點它卻沒有反應,常見原因是label沒有正確連到欄位。使用for時,它的值要與輸入欄位的id完全一致,而且這個id在整份文件中必須唯一。畫面位置接近、欄位的name相同,都不能代替這個關聯。 這種問題特別容易在複製聯絡表單、彈出視窗或會員資料卡後出現。原本的一組能用,第二組卻點到第一組欄位。先查標籤實際連到哪個控制項,再修id,比替每段文字加一個點擊事件更直接,也能保留原生表單的操作方式。 一組最小可用的標籤與欄位 <label for="contact-name">姓名</label> <input id="contact-name" name="name" type="text"> 把這段存成獨立HTML頁,點擊「姓名」。瀏覽器會把焦點放進輸入框,讓你開始打字。for與id負責建立關聯;name則是提交資料時使用的欄位名稱。它們可以不同,不需要為了連接標籤而把name也改成id。 假如for寫成contact-name,輸入框id卻是contact_name,一個用減號、一個用底線,便無法關聯。這裡比對的是識別字,不會依文字意思自動找「最像的欄位」。若輸入框只有name而沒有id,明確的for關聯也找不到目標。 在瀏覽器開發者工具選中label,檢查它的for值,再搜尋對應id是否存在。也可以查看label的control屬性,確認它實際關聯到哪個元素。這比只看HTML原始碼裡似乎有一個相近名稱更可靠,尤其模板會在載入後新增內容時。 實際點三組標籤,看看差在哪裡 以下片段展示正確、不匹配及重複id三種情況。重複id刻意作為錯誤範例,不能用在正式頁面。你可以點擊三段文字,觀察焦點與核取方塊的勾選位置。 <label for="contact-name">姓名</label> <input id="contact-name" name="name"> <label for="wrong-name">錯誤標籤</label> <input id="actual-name"> <label for="notify">第二份通知</label> <input type="checkbox" id="notify"> <input type="checkbox" id="notify"> 在Chromium154的這組頁面裡,點姓名後焦點到了contact-name;點錯誤標籤沒有找到對應控制項;點第二份通知時,第一個notify核取方塊被勾選,第二個仍未勾選。標籤不會猜測你想操作第二個,也不會依最近的畫面位置選目標。 同一份文件若有多個相同id,label會依第一個符合id的元素判斷關聯。如果那個元素不是可標記控制項,後面即使還有同id的input,也不能拿這種重複結構期待它自動補救。id重複是要修正的HTML問題,不是可利用的選擇策略。 複製模板時,id與for要一起改 假設桌面版與彈窗各有一份姓名欄位,可以用contact-name-main與contact-name-dialog這類清楚的id。每個label的for跟著改成對應值,name則仍按後端需要保留為name。只改input的id而漏掉label,是另一種常見的半套修正。 如果表單是在迴圈裡建立,應讓每筆資料產生穩定且唯一的id,再把同一個值傳給label。不要每次重繪隨機換識別字,導致其他描述關聯也跟著失效。框架有產生id的工具時,可以按它的規則使用,但仍要確認輸出到DOM後沒有重複。 檢查範圍要涵蓋整頁:藏起來的表單、尚未開啟的彈窗、手機與桌面兩份版型,都可能留在同一份文件中。看不到不代表id不會參與比對。因此不能只在目前可見區域搜尋,或以為用CSS隱藏後就可以重用id。 也可以把欄位放進label裡 <label> 接收更新通知 <input type="checkbox" name="notify" value="yes"> </label> 這是隱含關聯,input直接在label裡,不必使用for與id才能建立這個標記。它適合某些簡單核取方塊排版;若你的設計要把標籤和欄位分成不同欄位,明確的for/id則比較容易安排。選擇方式時也應考慮輔助工具的相容性,而不是只看少幾個字。 一個label不要包進多個需要操作的欄位,也不要用它當整張卡片的任意點擊容器。標籤要有清楚的控制項對象。如果另外有條款連結或說明按鈕,最好放在合適的位置,避免使用者原本要勾選卻打開連結,或要開連結卻切換欄位。 可見標籤與placeholder用途不同 placeholder可以提供填寫例子,但輸入後會消失,不適合單獨承擔欄位名稱。修for時也順便看看頁面是否有持續可見的標籤,讓使用者在修改已填資料時仍知道每格是什麼。不要只為了排版乾淨,把所有label都刪掉。 對輸入框而言,正確關聯有助於工具取得欄位名稱,也增加可點擊的範圍。不過單靠這組點擊測試,不能推論所有瀏覽器與螢幕閱讀器組合的表現。正式功能應再使用鍵盤走過表單,確認每個欄位有清楚名稱、焦點看得見,錯誤提示也能對應到適當欄位。 改完後先驗三件事 檢查標籤時可以再看label.control是不是你預期的欄位。如果它是null,先回到for、id與可標記元素種類;如果它指向另一個欄位,則優先查重複id和模板複製。這個屬性可用來排查關聯,不需要為了修表單在網站裡長期插入一段自動改寫所有標籤的程式。 不要把label和其他描述關聯混用。label應讓人知道欄位要填什麼,提示可以說明格式或選填規則,錯誤則應指出目前要改的內容。改了id後,若其他描述也引用同一個識別字,應一起核對,避免欄位名稱修好,補充提示卻指向了舊元素。 有些版型把「姓名」做成普通span,看起來與label相同,但span不會自動把點擊交給輸入框。若這段文字就是欄位標籤,應使用合適元素建立關聯;若是區塊標題,則保留它的用途,不要把整個標題區都改成label。 核取方塊尤其需要留意可點擊範圍。小方框本身不容易點中,正確標籤能讓文字也參與操作;但外層再套一個會跳頁的卡片連結,可能讓點擊結果混亂。先保留簡單的一組標籤和欄位確認行為,再逐步加回外層版型,較容易找到是哪個元素影響操作。 先點可見文字,確認焦點或勾選落在正確欄位;再用Tab走過表單,確認沒有為了修標籤而加入多餘的焦點停留;最後提交合成資料,核對欄位名稱仍符合後端約定。for/id修好了,不表示name與value也一定正確。 若點標籤還是沒有反應,再看是不是有覆蓋元素攔住點擊,或控制項本身被停用。這些問題與關聯錯誤不同,應分別查證。不要一律加JavaScript click來繞過,否則容易把模板裡真正的錯誤留在頁面,之後複製到其他表單時又再次出現。 參考資料 HTML label HTML id HTML checkbox label control HTML標準:label
HTML數字欄位輸入1.5卻無效:step怎麼設定
數量欄位用了input type=number,使用者輸入1.5,瀏覽器卻說不是有效值。既然是數字欄位,為什麼小數不行?常見原因是step:number欄位預設步階是1,值必須落在以步階基準開始的允許位置,而不是只要能解析為數字就有效。 需要半份、長度或小數單價時,先確定允許的精度與起點,再設定step。step不是顯示格式,也不是四捨五入工具。它參與原生約束驗證;真正的資料規則仍要在後端確認。 預設步階1,先看stepMismatch 以下input沒有min,也沒有初始value屬性,因此步階基準是0。用JavaScript設定目前值為1.5,再讀取有效狀態,可以把問題和「欄位是空的」或「超過最大值」分開。 <input id="quantity" type="number" name="quantity"> const quantity = document.querySelector('#quantity'); quantity.value = '1.5'; console.log(quantity.validity.stepMismatch); // true console.log(quantity.checkValidity()); // false quantity.step = '0.5'; console.log(quantity.validity.stepMismatch); // false console.log(quantity.checkValidity()); // true step改成0.5後,從0開始的0、0.5、1、1.5都符合這個步階。沒有max或其他限制,不代表只能在這幾個值裡選;它仍沿著相同間距延伸。若業務只能選固定幾種數量,可能使用選單或按鈕更清楚,不必把固定選項偽裝成自由數字輸入。 checkValidity會檢查其他適用的約束,不只step。看到false時,進一步看stepMismatch、rangeUnderflow、rangeOverflow等資訊,才知道是哪個條件不成立。瀏覽器顯示的驗證訊息會依語言與實作不同,不要只比對某一句錯誤文字。 min也會改變步階起點 步階是從基準起算。對number欄位,基準依序取有效的min、有效的value內容屬性,否則是0。這也是為什麼你把min加上去後,原本某個整數可能反而不符合step。 <input id="length" type="number" min="0.2" step="1"> const length = document.querySelector('#length'); length.value = '1.2'; console.log(length.validity.stepMismatch); // false length.value = '1'; console.log(length.validity.stepMismatch); // true min=0.2、step=1的允許位置是0.2、1.2、2.2等,並不是所有大於0.2的數字都可以。min限制下界,同時也提供步階起點;兩種作用需要一起考慮。若你的規則是「至少0.2,任何小數都可以」,應另外考慮step=any,而非保留預設1。 HTML裡的value屬性和使用者目前輸入的值也要分清楚。沒有min時,初始value內容屬性可能提供步階基準;之後單純改input.value,並不等於把那個HTML內容屬性一起改掉。排查時同時核對getAttribute('value')與目前value,避免只看畫面上的字就推斷起點。 step=any不檢查步階,但其他規則仍在 若業務允許不限固定間距的數值,可以用step=any停用步階不匹配的檢查。min、max、required及數字解析等條件仍各自適用。any不是「所有輸入都有效」,也不會讓文字變成數字。 <input type="number" name="length" min="0.2" max="10" step="any" required> 這個欄位可接受範圍內的小數,不必對齊固定步階;空值仍因required無效,超過10仍超出範圍。若只是想接受兩位小數,可以先評估step=0.01是否符合業務步階,但它不強制畫面永遠顯示兩位,也不會自動把三位小數四捨五入。 例如1.5與1.50的數值相同,顯示要保留尾端零則是格式呈現的需求。數字輸入、金額顯示與後端儲存可以採不同處理方式,不必要求一個step屬性完成全部工作。貨幣資料的計算與儲存也要按系統的精度規則決定,不能只因瀏覽器通過就當成計算一定精確。 把畫面提示和真正規則對齊 如果HTML一開始寫了value=0.5,且沒有min,預設步階1會從0.5起算。此時1.5可能有效,反而1不符合步階。這與本文第一個沒有value內容屬性的input不同,並不矛盾。複製別人的表單時,若只改目前值而保留原本的value屬性,可能把原作者的步階基準也一併帶過來。 需要明確起點時,使用符合業務的min通常更容易讀懂。像允許0.5份、1份、1.5份,可以設min=0.5、step=0.5;若數量至少1份但之後可半份增加,就改成min=1、step=0.5。兩個設定都接受某些小數,最低允許值卻不同。不要只為了讓某個測試數字過關而挑一個任意min。 另外,電話、郵遞區號或商品編號即使只含數字,也不一定適合type=number。它們通常是識別文字,而不是可以加減步階的數值;前置零可能有意義。遇到這類欄位應按資料用途選擇輸入類型,不能用step=any來補救所有「看起來是數字」的欄位。 資料回填也值得測一次。後端傳回字串1.50、前端設定目前value後,畫面可能呈現不同格式,但有效狀態仍要看數值與約束。若驗證失敗,保留使用者輸入並指出允許的步階,比默默改成另一個數字更清楚。需要自動調整數值時,應先讓使用者理解調整規則,再確認送出的值就是畫面最後顯示的值。 欄位旁可以直接說明「每次以0.5為單位」或「長度介於0.2至10」。比起送出後才看到瀏覽器提示,使用者在輸入前就知道允許範圍會更容易填寫。若有單位,例如公尺或份數,也應放在可理解的位置,避免1.5到底代表什麼都不清楚。 當欄位有錯誤時,不要為了讓送出按鈕能按就把所有約束移除。先確認業務到底允許1.5,還是只能輸入整份;前者要修step,後者要修提示與選擇方式。技術欄位設定應反映真正規則,不能由錯誤訊息反過來決定產品能接受什麼。 也要注意空值的處理。沒有required時,空的number欄位通常不會因step而無效;但valueAsNumber可能是NaN。需要區分未填和零,不能直接用真假判斷把0當成沒有填。範例只檢查步階,不代表已完成所有輸入資料的解析與必填檢查。 用幾個邊界值驗證,再檢查後端 number欄位不支援pattern約束,不能加一段正規表示式就要求固定小數格式。若業務需要的其實是某種文字格式,應重新評估欄位類型與解析流程;若需要的是數值步階,則使用step及範圍約束,再由後端核對同一套規則。 本機Chromium案例驗證了預設step下1.5無效、step=0.5下1.5有效,以及min=0.2、step=1時1.2有效而1無效。案例讀取的是原生validity狀態,不是憑欄位外觀推測,也沒有對正式網站提交資料。...
HTML表單欄位沒送出?分清disabled與readonly
報價表上的客戶編號明明看得到,送到後端卻沒有這個欄位。把驗證規則改了幾次,仍然收到「編號必填」。這時先看表單怎麼組成送出的資料:欄位若設成 disabled,瀏覽器會把它排除;畫面顯示的值,不一定在請求裡。 若你的意思是「讓人看得到,不能直接修改,但仍要隨表單送出」,支援唯讀的文字欄位可以用 readonly。兩個屬性外觀可能相近,處理資料的方式卻不同。先確認請求內容,才知道該修畫面、送出程式,還是後端。 先用一張小表單看出差別 以下例子有四個文字欄位:一般欄位、停用欄位、唯讀欄位,以及沒有名稱的欄位。把它放在本機 HTML 檔,用瀏覽器開啟,再從開發者工具的 Console 執行後面的 JavaScript。這個例子只建立資料,不會傳到伺服器。 <form id="quote"> <input name="customer" value="Ada"> <input name="account" value="A17" disabled> <input name="reference" value="R42" readonly> <input value="visible-but-unnamed"> <input type="hidden" name="plan" value="basic"> </form> const form = document.querySelector('#quote'); const data = new FormData(form); console.log([...data.entries()]); 結果包含 customer= Ada、reference= R42 與 plan= basic,沒有 account,也沒有最後那個未命名文字欄位。停用欄位即使有值、有名稱,仍被略過;唯讀文字欄位則照常加入。沒有 name 的控制項沒有送出鍵名,也不能靠 id 補上。 這裡的空格只是文字展示方式,實際值分別是 Ada、R42、basic。不要用肉眼看輸入框是否有字來判斷資料是否送出,直接查看 FormData 的 entries,或在 Network 面板查看真正的請求,會更可靠。 disabled表示暫時不能使用,不只是不能修改 停用的原生表單控制項通常無法取得焦點,也不參與表單約束驗證。例如停用且帶有 required 的欄位,不會因為空值而擋住表單。這符合「目前不適用這個選項」的意思,卻不適合拿來鎖住仍需要送出的訂單編號。 停用也可能來自外層的 fieldset disabled。如果單看 input 沒有發現屬性,往上檢查父層;停用 fieldset 內的控制項通常一起受影響,其第一個 legend 子元素內的控制項有規格例外。不要只靠 CSS 灰色判斷,也不要把 disabled="false" 當成啟用:這是布林屬性,只要屬性存在,就代表停用。要恢復使用,移除屬性或把 DOM 的 disabled...
HTML按鈕放進表單就跳頁:先設定正確type
聯絡表單裡新增一個「查看說明」按鈕,點下去卻重新載入頁面,甚至把還沒填好的資料送出去。先看按鈕的 type,再查腳本。一般與表單關聯的 button,如果沒有明確指定用途,可能被當成提交按鈕。 同一個畫面中,「查看說明」只需要操作介面,「送出需求」才需要提交。把用途寫進 HTML,通常比在每個 click 事件裡另外阻止送出更容易維護。 先確認這個按鈕屬於哪個表單 在開發者工具選中按鈕,看它是否位於 form 裡,以及有沒有 form 屬性指向另一份表單。按鈕不在表單標籤之內,也可能透過這個屬性成為表單的控制項,不能只看畫面位置判斷。 接著核對 type。這篇以沒有其他命令用途的普通表單按鈕為例:未指定 type 時,在瀏覽器中讀到的按鈕類型是 submit。原始 HTML 沒有這個字,不代表按鈕沒有提交行為。 <form action="/contact" method="post"> <button>查看說明</button> </form> 上面的文字叫「查看說明」,瀏覽器仍按按鈕類型處理。CSS 把它畫成問號或小圖示,也不會改變用途。先查看輸出的實際 DOM,因為模板元件可能在渲染時加入或移除屬性。 介面動作用 button,提交用 submit 展開說明、切換分類、增加欄位或預覽內容,通常應使用 type="button"。它不會因這個原生按鈕行為提交表單,但仍需要自己的腳本處理要做的事。真正送出則明確寫 type="submit"。 <button type="button" id="show-help">查看說明</button> <button type="submit">送出需求</button> type="reset" 是回復表單控制項的初始值,不是關閉說明,也不是保留內容的取消按鈕。如果真的需要清除或回復,先讓訪客理解會失去哪些修改;不要只因按鈕寫「取消」,就套上 reset。 在 Vue、React 或其他元件中,也核對 type 是否真正傳到原生 button。元件外層寫了屬性,內部卻沒有向下傳遞,瀏覽器仍可能使用另一種預設行為。以渲染後的元素為準。 本例點同一種說明入口,結果不同 我們在自建桌機頁面放入合成姓名欄位和三個按鈕。第一個說明按鈕沒有指定 type,第二個明確使用 button,第三個是正式的示範提交。表單只向本機 GET 入口發送合成資料,沒有寄信或保存任何客戶內容。 點第一個按鈕後,瀏覽器到達提交入口,網址帶有姓名查詢值。回到原頁,點第二個按鈕,則只更新「說明已開啟;姓名與頁面保留」,網址仍停在原表單。 自建桌機示範:明確使用 button 的說明入口保留表單;未指定 type 的另一個入口會提交。 這個對照核的是原生類型與請求行為。你的表單若有必填欄位,未填時可能先被瀏覽器驗證擋下,所以畫面未跳轉不代表那顆按鈕不是 submit。使用合成有效資料,再核對是否發出請求,才不會被其他條件遮住。 有 click 腳本,仍可能繼續提交 一個 click 事件先開啟說明,並不會自動取消原本的提交動作。這也是為什麼頁面可能閃過說明,接著立刻跳走。若用途本來就不是提交,先修 type,再保留需要的事件處理。 event.preventDefault() 可取消適用事件的預設行為,但要知道取消的是哪個事件。只在某一個 click 處理器阻止,可能漏掉其他提交途徑;需要自訂真正的送出流程時,通常在 form 的 submit 事件統一處理。 也要查腳本是否主動呼叫提交、改變網址或執行路由跳轉。加上 button 只移除它本身的原生提交用途,不會阻止你自己的程式呼叫其他動作。原生行為與腳本行為各自記錄,才能找出真正的跳頁原因。...
Next.js表單狀態一直顯示送出中:用pending提示與重試
訪客按送出,按鈕變成「送出中」,等了很久卻無法再按。先看請求是不是還在等待,還是已經回錯誤而畫面沒解除狀態。兩種原因的修法不同;把按鈕重新打開,只解決了表面操作,還要讓訪客知道這次送出到底到了哪一步。 以下用 Next.js 16、React 19 的 App Router 表單作例子。Client Component 以 useActionState 處理表單 action,再向自己的 Next Route Handler 發 POST;這不是 Server Action,也沒有連接正式資料庫、寄信或付款。 把等待、錯誤與完成分開顯示 等待時顯示「送出中,請稍候」,暫時停用這個送出按鈕。取得可用錯誤回應後,等待應結束,保留輸入,說明原因並提供重試;成功時則按接收端真正回傳的結果顯示,不要只因請求有回應就寫「已寄送」。 按鈕原本就因缺資料而停用,屬於送出前的條件。可先看停用按鈕旁怎麼說明原因。這篇處理的是已送出後的等待生命週期,不把欄位格式合格當成伺服器已接收。 讓第一次失敗,再用同一段文字重試 示例 Route Handler 先檢查訊息,再等待約 1.8 秒;第一個有效嘗試回 503,第二個回 200。故障次序是為了重現操作安排的,嘗試次數只控制示例,不是正式提交身分或防重複機制。 真實 Next.js 示例正在等待自己的 POST 回應;文字仍在輸入框。 第一次取得 503 後,畫面解除等待,按鈕改為「重試」,訊息仍是剛才的文字。按重試會再發一個 POST;第二次取得 200 後,示例顯示「請求已成功回應;未保存或寄送資料」。它只確認這個示例端點完成回應。 服務回錯誤後,等待結束,保留輸入並提供重試。 讓 pending 跟著真實非同步工作 在 Client Component 檔案開頭加入 'use client',從 React 匯入 useActionState 與 useState。useActionState 的 action 接收上一份 state 與這次 FormData,回傳下一份結果;不要把第一個參數誤當表單資料。 這個 action 讀取示例端點約定的 JSON message,並用 HTTP 狀態決定成功或錯誤。片段中的 /api/submit 必須有自己實際建立的 Route Handler,接收 POST JSON 並回相應狀態及 message;貼上前端函式不會自動建立接收端。...
Laravel送出同一表單兩次:讓資料庫唯一條件擋重複
訪客連按兩次送出,資料表多了兩筆相同詢問。把按鈕停用能減少誤按,但請求也可能被重試,或從另一個視窗送來。若產品要求同一次提交只保存一筆,資料庫需要有能識別這次提交的唯一條件。 Laravel 的 unique 驗證規則可以在保存前提示已有資料;資料庫的 unique constraint 則在真正寫入時阻止違反條件的紀錄。兩者處理的時點不同,不能用一次驗證通過,就保證稍後寫入時仍然沒有重複。 先定義什麼叫同一次提交 先選業務上穩定的識別方式。這篇以同一使用者、同一 submission_key 為例,要求這個組合只能存在一次。兩個不同使用者可以有相同的示例字串,但同一使用者重送同一個 key,不能新增第二筆。 實際網站應由伺服器產生或依既有協定驗證提交識別碼,讓同一次請求的重試沿用相同值。不要每次送出時都重新產生 key,否則兩次請求會被視為不同提交。也不要把「訊息文字完全一樣」直接當作重複,訪客可能隔天真的要再詢問同一個問題。 識別碼的範圍、有效期間和重試規則都要由產品決定。付款、訂單或外部 API 的重試還涉及其他副作用;這篇只處理資料表的一筆保存,不把唯一索引稱為完整冪等機制。 在資料表建立真正的唯一條件 Laravel migration 可替兩個欄位建立複合唯一索引: $table->unsignedBigInteger('user_id'); $table->string('submission_key'); $table->string('message'); $table->unique( ['user_id', 'submission_key'], 'submissions_user_key_unique' ); 這裡兩個識別欄位都不是 nullable。若允許 NULL,唯一限制對 NULL 的行為需看使用的資料庫,不能假定空值也會形成同一個提交。欄位型別、長度與比較方式,也應符合實際 key 的格式。 替已有資料表增加限制前,先盤點目前是否已存在相同組合。不能直接上線 migration,再碰到重複資料才臨時刪除。由維護者確認該保留哪筆、其他資料有沒有引用,以及備份和回復方法,再安排正式變更。 驗證規則仍然保留,條件要與資料庫一致 前置驗證可以讓訪客較早收到清楚提示。複合唯一條件的驗證也要包含使用者範圍,而不是把所有人的 key 當成全站唯一: 'submission_key' => [ 'required', Rule::unique('submissions') ->where(fn ($query) => $query->where('user_id', $request->user()->id) ), ], 這是已驗證登入身分的應用程式片段,Rule 需正確匯入。使用者 ID 應取自伺服器確認的身分,不是由表單任意指定。提交 key 本身也需依產品協定核對,不能只要有字串就認定它代表合法的提交。 驗證與資料庫的條件要一致。驗證查全站唯一,資料庫卻只限制同一使用者,會錯擋合法資料;反過來則可能讓驗證通過,寫入卻被另一個更嚴格的條件擋下。先把實際索引欄位與規則並排核對。 兩次驗證都通過,第二次仍被擋下 在隔離的 Laravel 13 與合成 SQLite 案例中,我們先建立空資料表,令請求 A、B 帶同一組 user_id=1 和 submission_key=demo-request-A。在任何寫入之前,先後執行兩次 Validator,兩次都通過。 接著保存 A,得到一筆資料。保存 B 時,SQLite 回報複合唯一條件衝突,Laravel...
WordPress 表單信件沒收到:分清送出提示、郵件記錄與收件匣
WordPress 聯絡表單顯示送出成功,信箱卻找不到信,先不要把整個表單重做。畫面提示、WordPress 寄信處理、郵件服務記錄和你的收件匣,是四個可以分開查的位置。用一筆有識別字的測試訊息往下找,才知道卡在哪裡。 下面以 Contact Form 7 為例。其他表單外掛的欄位名稱可能不同,但仍應先確認寄給誰、由誰寄出,以及寄信服務有沒有接到這一封。測試前使用自己控制的收件地址,不要拿真客戶當測試收件人。 先記下這一次送出的識別字 在主旨或訊息裡加入容易搜尋的字,例如 contact-check-A,記下送出時間與時區。只送一筆,保留當時的畫面提示。稍後查紀錄時,用同一主旨和收件地址比對;不要連續按送出,最後分不清收到了哪一封。 如果表單一直轉圈、必填欄位報錯,或顯示處理失敗,先查表單提交這一段。Contact Form 7 的錯誤可能來自寄信失敗,也可能是防垃圾機制阻擋;應按當時訊息與紀錄判斷,不只靠框線顏色猜。不要為了測試而在正式站關掉所有防垃圾保護。 查郵件頁籤,不只查表單欄位 到後台「聯絡 → 聯絡表單」,打開網站真正使用的表單,再看「郵件」頁籤。首先核對 To:它是網站收到詢問的地址,不一定是表單填寫人的 Email。舊站搬家後,這裡可能仍指向前任管理者或拼錯的地址。 From 是寄件地址。Contact Form 7 要求它屬於網站同一網域,並且要符合你使用的郵件服務已驗證、允許寄出的網域或帳號;兩個條件都要核對。要讓你按回覆時能回到填表人,可以使用 Reply-To 配合表單的 Email 標籤,而不是任意將訪客地址當成正式寄件人。 To: 你控制的收件地址 From: 與網站同網域、且郵件服務驗證允許的寄件地址 Additional headers: Reply-To: [your-email] [your-email] 必須對應你表單裡實際的欄位名稱。如果表單用別的名稱,就換成那個名稱。順便查主旨和郵件內文的標籤:畫面有新增欄位,郵件模板未必自動把它寫進信裡。不要把 SMTP 密碼或 API 金鑰放進表單內容。 成功提示告訴你什麼? WordPress 官方的 wp_mail() 文件說明,回傳成功只表示寄信處理沒有回報錯誤,不能保證收件人已收到。Contact Form 7 顯示成功後仍可能有信件被後續服務或收件過濾擋住。這時反覆調整按鈕文字,通常找不到郵件去哪了。 請維護者查看目前使用的寄信方式:主機預設寄信、SMTP,還是郵件服務 API。不要一口氣啟用多個寄信外掛;不同設定可能同時攔截 WordPress 寄信,反而看不出實際走了哪一條路。 看一筆表單提交如何到接收端 本例使用一套另建的 WordPress,Contact Form 7 接到專用的 Mailpit 郵件捕獲工具。收件人是 [email protected],寄件人是 [email protected],Reply-To 是表單填寫的 [email protected]。這些是示範地址,不是可以收正式信件的帳號。 送出主旨 contact-check-B:詢問選單設定 後,Mailpit 裡出現同一主旨的信件。打開那封信,能核對 To、From、Reply-To 和訊息內容。這讓我們追到 WordPress 表單已交給指定 SMTP 接收端;如果你的網站也有郵件記錄,可用同樣方式找出是哪一筆。 自建表單示例:專用接收端顯示同一主旨、地址與詢問內容;仍需另查外部信箱投遞。 Mailpit...
詢價表單沒人填?先把必填欄位與送出回饋說清楚
你替網站加了一個聯絡或詢價表單,卻一直收不到訊息,不一定要先換插件。先試一次:訪客是否知道要填什麼?填錯後能不能找到原因?按下送出後,畫面有沒有交代下一步?這幾個地方,比把按鈕做得更大更值得先查。 聯絡或詢價表單可以用來了解網站製作、模板挑選或改站需求。欄位應按自己網站的用途調整,不必把所有人都當成需要完整報價的客戶。 先讓對方說得清楚,你也回得了話 如果只是初次了解需求,通常可以從聯絡 Email 和需求簡述開始。例如:「想做哪一類網站?想了解哪個模板?目前卡在哪個頁面?」對方還沒決定的部分,也可以直接寫出來。 已經有網站的話,網址可以設成選填,方便你查看;尚未建站的人就不必為了送出表單而找一個網址。稱呼也可以選填。電話、預算和預計上線日期是否必填,要看你是否真的需要這些資料才能回覆,不必一開始全部收齊。 如果你的服務必須靠電話確認,或要依固定規格報價,欄位當然可以不同。重點是每個必填項都能幫助處理這次聯絡,別只因表單插件預設有這一欄就保留下來。 讓訪客說清楚建站或模板需求,也知道怎麼聯絡你。 欄位旁寫清楚,不只放一個星號 名稱留在輸入框上方或旁邊,別只用框內的提示文字。訪客開始輸入後,仍應看得到這一欄在問什麼。可以這樣寫: 聯絡 Email(必填):用於回覆這次詢問,請填可收信的地址。需求簡述(必填):說明想了解的模板或建站問題;未確定的部分也可以寫。稱呼、現有網站網址(選填):方便稱呼或查看你的頁面,沒有也能送出。 用途說明要符合你真正的處理方式。如果資料還會用於訂閱通知或其他服務,應另外說明,不能一邊寫「只用於回覆」,一邊做別的用途。 填錯時,直接告訴他改哪裡 只有「格式錯誤」四個字,對方還是得猜。改成「請填寫聯絡 Email」或「請填寫有效的 Email,例如 [email protected]」,放在對應欄位旁,並保留已填內容。 欄位較多時,可以在表單上方列出錯誤摘要,點一下回到需要修改的欄位。只把框線染紅不夠;文字要說明原因,用鍵盤也要能移到錯誤位置。 送出之後,說清楚是收到還是失敗 按鈕寫「送出詢問」或「送出詢價」,讓對方知道這一步會做什麼。處理中顯示「正在送出,請稍候」;失敗時保留內容,說明是否需要重試。不要讓訪客按了幾次都不知道結果。 成功訊息應對應真正的接收結果。後台或信箱收到資料後,才寫「已收到你的詢問」;確認信沒有寄出,就不要寫「確認信已寄送」。接下來由誰回覆、約多久回覆,按你實際能做到的方式交代,不必承諾立即回覆。 清楚的回饋,讓訪客知道目前狀態與下一步。 前端提示和後台接收功能要一起確認;畫面出現完成訊息,不代表信箱一定收到。 用一筆測試訊息,走到真正的收件端 先在自己的測試頁填一次:留白、填錯 Email,再補齊資料。用手機看看提示是否好找,再只用鍵盤修正一次,確認資料不會因錯誤而全部消失。 接好正式功能後,送一筆你認得出的測試訊息,查看後台或收件信箱;若有確認信,也查看填表人的收件端。前端正常、後台沒收到,仍可能是寄信設定或後端處理出了問題。 最後請一位沒看過這個頁面的人試填,看看他在哪裡停住。修改後可以追蹤成功提交與實際收到的有效詢問,但別把按鈕點擊當成收到訊息,也不能只因表單變簡單就斷定詢價一定增加。 參考資料 W3C WAI:Forms Tutorial W3C WAI:Form Instructions W3C WAI:User Notification GOV.UK Design System:Question pages GOV.UK Design System:Error summary GOV.UK Design System:Confirmation pages
