useActionState는 폼 액션 함수의 결과 상태, 액션, pending 여부를 제공합니다. 제출마다 이전 상태와 폼 데이터를 받아 새 결과를 계산할 수 있습니다.
데모는 idle, pending, 성공 또는 오류가 버튼과 안내문에 이어지는 모습을 보여줍니다. 결과가 실패했을 때 사용자 입력과 오류 메시지를 어떻게 유지할지 함께 설계하세요.
언제 쓰나
제출 결과와 진행 상태를 폼 UI에 직접 연결할 때 사용합니다.
액션 상태
Action state
폼 액션의 결과와 pending 여부를 하나의 상태 흐름으로 다룹니다.
···
<div class="scene"><div class="form"><span>email</span><div class="field">a@b.test</div><div class="button" id="button">SAVE</div></div><div class="steps"><span id="idle">idle</span><span id="pending">pending</span><span id="result">result</span></div><div class="message" id="message">Ready to submit</div></div>.scene{width:min(94vw,800px);height:min(86vh,320px);position:relative;overflow:hidden;display:flex;flex-direction:column;justify-content:space-between;border:1px solid var(--line);border-radius:14px;background:var(--surface);padding:clamp(9px,2.4vmin,20px);font:500 clamp(15px,4vmin,18px)/1.3 var(--font-sans,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif)}.scene b,.scene strong{font-weight:700}.label{color:var(--muted)}.code{font-family:ui-monospace,SFMono-Regular,Consolas,monospace}.pill{border:1px solid var(--line);border-radius:8px;padding:.4em .65em;background:var(--bg)}.active{border-color:var(--accent)!important;color:var(--accent)!important;background:color-mix(in srgb,var(--accent) 10%,var(--surface))!important}.form{display:grid;grid-template-columns:1fr 2fr 1fr;align-items:center;gap:7px}.field{border:1px solid var(--line);border-radius:5px;padding:.5em;overflow:hidden;white-space:nowrap;font-size:.8em}.button{background:var(--accent);color:var(--bg);border-radius:6px;text-align:center;padding:.5em;font-weight:700}.steps{display:flex;justify-content:space-between;margin:clamp(23px,8vmin,55px) 0 16px}.steps span{width:30%;padding:.4em;border:1px solid var(--line);border-radius:6px;text-align:center}.steps .on{border-color:var(--accent);color:var(--accent)}.message{text-align:center;color:var(--muted)}let n=0;function tick(){const s=n%4;["idle","pending","result"].forEach((id,i)=>document.getElementById(id).classList.toggle("on",i===Math.min(s,2)));document.getElementById("button").textContent=s===1?"SAVING…":"SAVE";document.getElementById("message").textContent=["Ready to submit","Sending action","Saved","Validation error"][s];n++}tick();setInterval(tick,850)