Built on WIX Headless

文件 小工具 Form 小工具

Form 小工具

使用 CMS for Harmony Form 元素,將訪客提交內容收集到 CMS 集合——包含 Contacts、Members、Automations,以及 Pro 的 pay-on-submit(經由 Wix Checkout)。

Form 小工具是單一元素:連接集合、選擇欄位與標籤,讓訪客提交——包含圖片、影片與 Media Gallery 上傳。你可以把長表單拆成步驟、只在條件成立時顯示欄位、建立 Wix 聯絡人、註冊網站會員,並觸發 Wix Automations。在 Pro 上,你也可以在提交時經由 Wix Checkout 收款。

影片教學

在 YouTube 觀看

你可以做什麼

  • AI setup — 用平易的語言描述欄位與提交文案;請見 AI setup
  • 文字、Number、URL、下拉選單、電話(含國碼的 E.164)、Color(原生色彩選擇器;儲存 HEX)、Date/Date & time/Time 選擇器、圖片、Video 上傳,以及 Media Gallery 多檔上傳
  • 文字欄位的 Radio buttons 與 Checkbox(多選),可自訂選項
  • Multi-step form — 以 Next/Back 與進度拆成多頁;編輯器的 Preview step
  • Show only when — 直到另一欄位為空、非空,或符合所選值才顯示
  • Autosave — 輸入時即儲存;會員會繼續集合中的草稿,其他人則在此瀏覽器保留草稿直到提交
  • 在同一個面板設定提交標籤(取代早期版本中分開的 Text Input/Dropdown/Submit Button/Form Dataset 小工具)
  • Update displays on this page — 成功提交後,同一頁面上使用相同集合的 Table、Repeater、Slideshow、Media Gallery、Calendar、Chart 與 Dynamic Page 小工具會自動重新載入
  • Contacts — Create contact、Update existing contact、Assign contact labels(Pro)
  • Members — Create member,以及 Assign Badges / Add to groups(Pro)
  • Spam & bot protection(Pro)— Use reCAPTCHA、Honeypot field、Limit submission rate
  • Wix Automations — 每次成功提交後觸發 Form submitted
  • Payments(Pro)— pay-on-submit:儲存提交、開啟 Wix Checkout,再把訂單詳情寫回提交紀錄

設定

在面板使用 AI setup 以平易語言開始,再於 Manual 微調。詳情:AI setup。

  1. 從 Add → Elements → Installed Apps → CMS for Harmony 新增 Form(可新增多次)。
  2. 連接應接收提交內容的集合。
  3. 挑選訪客要填寫的欄位與標籤(Number 與 URL 欄位會取得對應的輸入類型)。
  4. 可選擇在 Steps 開啟 Multi-step form 並在 Field setup 指派欄位;為各欄位設定 Show only when。
  5. 可選擇開啟 Update displays on this page、Create contact、Create member、Spam & bot protection(Pro)和/或 Enable payments(Pro)——見下方。
  6. 發佈並在正式(或預覽)網站測試一次提交。付款結帳在正式網站上執行。

提交內容會進入你的集合,之後若需要,可用 Table 或 Repeater 顯示。使用 Update displays on this page 時,同一頁面上的清單會在提交成功後立即更新。

Steps

  1. 在 Steps 開啟 Multi-step form。
  2. 新增步驟並設定每個 Step title。
  3. 在 Field setup 將每個欄位指派到一個 Step。
  4. 在編輯器使用 Preview step,一次預覽一頁畫布。
  5. 正式表單上訪客使用 Next/Back;提交在最後一步執行。

Field setup

為每個欄位設定 Label、Placeholder、Required 與 Input type。文字欄位支援自訂 Options 的 Radio buttons 與 Checkbox(多選)。啟用多步驟時指派 Step。Show only when 會在另一欄位為空、非空,或 Equals any of 所選值之前隱藏該欄——Required 只在顯示時生效。

Hidden fields {#hidden-fields}

需求: Pro 方案。

適用於 Text 與 URL 集合欄位(非參考欄位或附加欄位):

  1. 在 Field setup 開啟 Hidden field。
  2. 選擇 Value source:Fixed text、URL query param 或 Page URL(提交時的完整 URL,含查詢字串)。
  3. URL query param 需設定參數名稱,可選缺少參數時的後備值。
  4. 正式網站不顯示此欄,提交時自動填入(含 Autosave)。隱藏期間無法使用 Required 與 Show only when。
  5. 編輯器顯示 Hidden 標記與斜線底紋。非 Pro 時恢復一般輸入欄位。

請勿存放機密——值在瀏覽器中可見。

After Submit {#after-submit}

在 Submit 中,After Submit 控制提交成功後的行為:

選項行為
Stay on Page(預設)顯示成功訊息,並讓訪客留在表單頁。
Navigate to Page提交後開啟另一個 URL。

選擇 Navigate to Page 時,再選 Navigate to:

  1. Dynamic page URL — 為剛建立或更新的列組出項目頁(與 Dynamic Page 連結相同的 Page path / Item slug)。適合「提交後開啟新項目頁」。
  2. Enter manually — 設定固定 URL(例如 /thank-you 或絕對連結)。

導覽會在提交成功後執行。若無法解析 Dynamic page URL,表單會留在原頁並顯示成功訊息。

Update displays on this page

在 Form 面板中,開啟 Update displays on this page。成功提交後,同一頁面上使用相同集合的 Table、Repeater、Slideshow、Media Gallery、Calendar、Chart 與 Dynamic Page 小工具會自動重新載入——訪客無需重新整理瀏覽器即可看到新增或更新的項目。

Autosave

在 Submit 開啟 Autosave,即可在訪客輸入時儲存。Editable form 與 Autosave 不能同時開啟。

  1. 開啟 Autosave。
  2. 選擇一個 Submitted field(boolean)。若集合還沒有,使用 Add submitted field 建立名為 Submitted 的欄位。該欄位不會出現在表單上。
  3. 會員需要對自己的項目具備 Read 與 Update(缺少時面板會提供 Fix)。

會員會在集合中儲存一筆草稿,submitted field 為 false。再次開啟表單會接續該草稿。Submit 會更新同一筆項目並把欄位設為 true。若要隱藏未完成的草稿,請用這個欄位篩選清單。

未登入的訪客會把草稿留在此瀏覽器,直到提交。提交後會寫入一筆新的集合項目,並清除瀏覽器草稿。

表單會顯示 Saving…、Saved 或 Couldn’t save. Keep editing — we’ll try again. 密碼不會存進草稿。

Contacts

在 Form 面板的 Contacts 區段,於有人提交時建立或更新 Wix 聯絡人。

  1. 開啟 Create contact。
  2. 對應 Email(必填)與任何選用欄位:Phone、First name、Last name、Full name、Company、Job title。
  3. 若也要把值存進 CMS,優先使用集合欄位。對不存入集合的純表單欄位使用 Add field (contact)——面板會顯示簡短說明與 Add to collection(若你改變主意)。
  4. 若要清除選用對應,請使用下拉選單旁的 X。清除 Add field (contact) 對應時,也會從表單移除該純表單欄位。Contacts 開啟期間 Email 仍為必填,因此沒有清除控制項。
  5. 可選擇開啟 Update existing contact,讓符合的電子郵件更新該聯絡人,而不是建立新的。
  6. 可選擇開啟 Assign contact labels(Pro),並從網站 Contacts CRM 選擇標籤。標籤會在 Create contact 之後套用。
  7. 發佈並提交測試項目;確認聯絡人出現在網站的 Contacts 中。

Create member 開啟時,Contacts 仍保持啟用,login email 與個人資料欄位維持對應。

Members

使用 Members 區段,讓訪客在提交時建立網站會員帳戶。

  1. 開啟 Create member(同時啟用 Contacts)。
  2. 設定 Login email(必填)——對應集合的 email 欄位或使用 Add field (member)。
  3. 對應你想放在會員/聯絡人上的其他 contact 欄位(與 Contacts 相同對應)。
  4. 在正式表單上,訪客會看到 Password 與 Confirm password(可在 Field setup 編輯標籤/placeholder)。密碼絕不寫入集合。
  5. 可選擇開啟 Assign Badges(Pro),並從 Site members 選擇徽章。
  6. 可選擇開啟 Add to groups(Pro),並選擇 Wix Groups。當會員被建立或以 login email 相符時,徽章與群組會在提交後套用。
  7. 發佈並在正式網站測試註冊。

Spam & bot protection {#spam—bot-protection}

需求: Pro 方案。沒有 Pro 時,即使先前已儲存,這些開關在正式網站上仍會保持關閉。

減少自動化提交。開啟 Spam & bot protection,並啟用任意組合:

  1. Use reCAPTCHA — 訪客以 Google reCAPTCHA(Wix Enterprise 金鑰)確認為真人。權杖在提交時驗證,也涵蓋開啟 Create member 時的註冊。選擇 When to show reCAPTCHA:
    • Always — 表單上顯示挑戰。
    • For suspected bots — 提交時隱形檢查;多數訪客不會看到挑戰。
  2. Honeypot field — 加入機器人常填寫的隱藏陷阱欄位。真人訪客看不見;填寫該欄位的提交會被拒絕。
  3. Limit submission rate — 同一訪客約 每分鐘 8 次 的軟性限制(應用程式伺服器)。

被拒絕或限速的提交會在表單顯示簡短錯誤,且不會寫入集合。

Wix Automations

每次 Form 成功提交都會向 Wix Automations 回報 Form submitted 事件(best-effort;不會阻擋儲存提交)。

在 Automations 中選擇 CMS for Harmony 的 Form submitted 觸發器。payload 包含 submission id、collection id、submitted time、payment-pending flag、欄位值的 JSON 字串,以及 Contacts 有對應時的 email、name、phone 與可用的 contact id。

可用於電郵通知、CRM 交接,或網站上既有的 Automations 動作。

Form payments (Pro)

Form 付款與目錄付款(顯示元件上的 Add to cart/Buy now)是分開的。這裡訪客在提交表單時支付固定金額或自行輸入的金額。

  1. 連接集合,然後在 Form 面板開啟 Payments 區段。
  2. 開啟 Enable payments(必要時會安裝 Wix Stores)。
  3. 設定 Item name(結帳明細名稱)。
  4. 選擇 Price:Fixed amount 或 Visitor enters amount(會在正式表單上新增必填 Amount 欄位)。
  5. 設定付款按鈕的 Label。
  6. 在 Save to submission 下,使用 Add fields(或手動對應)設定 Order ID、Total paid 與 Payment status——付款成功後的結帳完成時會填入。
  7. 發佈並在正式網站上測試。

沒有 Pro 時,付款開關維持關閉,面板會顯示升級提示。

FAQ

Can the form navigate after a successful submit?

Yes — After Submit can Stay on Page or Navigate to Page (Dynamic page URL or manual URL). See After Submit.

Can forms block spam?

Yes on Pro — reCAPTCHA, honeypot, and submit rate limit under Spam & bot protection.

Can forms create contacts or members?

Yes — Create contact / Create member, with optional labels, badges, and groups. See Contacts and Members.