웹 폼 오류가 여러 개일 때 요약에서 입력칸으로 이동하기

워크숍 신청 폼을 제출했는데 두 항목이 비어 있다면, 화면 위에서는 제출이 멈춘 이유를 알려 주고 입력칸 옆에서는 무엇을 고칠지 알려 주세요. 오류가 여러 개라면 요약에서 바로 해당 입력칸으로 이동할 수 있어야 합니다. 아래 예제는 표시 이름과 신청 인원 두 칸으로 이 흐름을 재현합니다.

오류 메시지가 필요한 위치를 정합니다

사용자가 겪는 상황 보여 줄 정보 확인할 동작
제출했는데 어느 칸이 틀렸는지 모름 폼 위에 남은 오류 목록과 개수 제출 실패 뒤 요약 제목에 키보드 초점이 옴
오류 링크를 찾았지만 입력칸이 멀리 있음 각 입력칸에 연결된 링크와 구체적인 수정 안내 Tab으로 링크를 찾아 Enter를 누르면 바로 입력할 수 있음
인원은 고쳤지만 원래 범위 안내가 사라짐 기본 도움말과 오류 문구의 연결을 따로 관리 오류를 지운 뒤에도 도움말은 입력칸에 연결됨

기본 입력 규칙을 사용해 오류 목록을 만듭니다

아래를 workshop-form.html로 저장해 브라우저에서 엽니다. 먼저 두 칸을 비워 두고 입력 확인을 누릅니다. 이 예제는 입력만 확인하며 신청 데이터를 전송하지 않습니다.

<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<title>워크숍 신청 폼 오류 안내 예제</title>
<form id="reservation">
  <div id="errors" hidden>
    <h2 id="error-title" tabindex="-1"></h2>
    <ul id="error-list"></ul>
  </div>
  <p>
    <label for="display-name">표시 이름</label>
    <input id="display-name" required>
    <span id="display-name-error" hidden></span>
  </p>
  <p>
    <label for="seats">신청 인원</label>
    <input id="seats" type="number" min="1" max="6" step="1" required
           aria-describedby="seats-hint">
    <span id="seats-hint">1명에서 6명까지 신청할 수 있습니다.</span>
    <span id="seats-error" hidden></span>
  </p>
  <button type="submit">입력 확인</button>
  <p id="result" role="status"></p>
</form>
<script>
  const form = document.querySelector('#reservation');
  const summary = document.querySelector('#errors');
  const heading = document.querySelector('#error-title');
  const list = document.querySelector('#error-list');
  const result = document.querySelector('#result');
  const fields = [
    {
      input: document.querySelector('#display-name'),
      hint: '',
      message: '표시 이름을 입력하세요.'
    },
    {
      input: document.querySelector('#seats'),
      hint: 'seats-hint',
      message: '신청 인원을 1에서 6 사이의 정수로 입력하세요.'
    }
  ];
  let checked = false;

  function showErrors() {
    list.replaceChildren();
    for (const { input, hint, message } of fields) {
      const error = document.getElementById(input.id + '-error');
      const invalid = !input.validity.valid;
      error.hidden = !invalid;
      error.textContent = invalid ? message : '';
      if (invalid) input.setAttribute('aria-invalid', 'true');
      else input.removeAttribute('aria-invalid');
      const descriptions = [hint, invalid ? error.id : ''].filter(Boolean);
      if (descriptions.length) {
        input.setAttribute('aria-describedby', descriptions.join(' '));
      } else {
        input.removeAttribute('aria-describedby');
      }
      if (invalid) {
        const item = document.createElement('li');
        const link = document.createElement('a');
        link.href = '#' + input.id;
        link.textContent = message;
        link.addEventListener('click', (event) => {
          event.preventDefault();
          input.focus();
        });
        item.append(link);
        list.append(item);
      }
    }
    const count = list.childElementCount;
    summary.hidden = count === 0;
    heading.textContent = count ? '고칠 항목 ' + count + '개' : '';
    return count;
  }

  form.addEventListener('submit', (event) => {
    event.preventDefault();
    checked = true;
    result.textContent = '';
    if (showErrors()) {
      heading.focus();
    } else {
      result.textContent = '입력 확인 완료';
    }
  });
  form.addEventListener('input', () => {
    result.textContent = '';
    if (checked) showErrors();
  });
  form.noValidate = true;
</script>
</html>

required와 숫자 범위는 HTML에 두고, 스크립트가 각 입력칸의 validity를 읽습니다. 제출 처리기를 등록한 뒤에 noValidate를 설정해 이 예제의 오류 요약을 표시할 수 있게 합니다. 스크립트가 실행되지 않으면 브라우저의 기본 검증이 남습니다. 실제 서비스의 서버는 브라우저 검증과 별도로 입력을 확인해야 합니다.

제출할 때만 요약 제목으로 초점을 옮깁니다. 사용자가 입력을 고치는 동안에는 해당 오류의 삭제와 요약 개수만 갱신합니다. aria-invalid는 검증에서 오류를 확인한 뒤 붙이고, aria-describedby는 기존 도움말과 현재 오류를 가리킵니다. 색만 바꾸는 대신 해결 방법을 글로 보여 주세요.

Chrome에서 키보드 이동과 오류 갱신을 확인했습니다

2026년 11월 14일 Chrome 157.0.8103.78 헤드리스로 로컬 예제를 실행했습니다.

조작 브라우저에서 확인한 결과
페이지 처음 열기 요약이 숨겨지고 표시 이름에 오류 속성이 없음
두 칸을 비워 제출 오류 두 개가 표시되고 요약 제목에 초점이 이동
요약 제목에서 Tab, 첫 오류 링크에서 Enter 첫 입력칸으로 초점 이동
표시 이름만 수정 해당 오류만 지워지고 초점은 입력칸에 유지
신청 인원에 7 입력 오류 상태와 도움말 연결 유지
신청 인원을 3으로 수정 요약이 사라지고 신청 인원 도움말 연결은 유지
유효한 값으로 다시 제출 같은 페이지에서 입력 확인 완료를 표시

검증 범위는 로컬 HTML의 키보드 초점, 브라우저 입력 검증과 화면 갱신입니다. 스크린리더의 읽기 순서와 서버 응답은 별도로 확인해야 합니다.

실제 신청 폼에서 확인할 항목

  1. 여러 오류가 생기는 입력으로 제출하고 요약에서 첫 번째와 마지막 필드로 각각 이동합니다. 수정 중에는 커서가 갑자기 바뀌지 않는지 확인하세요.
  2. 서버가 이미 마감된 시간처럼 브라우저에서 알 수 없는 조건을 돌려주면, 해당 입력칸을 찾을 수 있는 오류와 폼 전체에 적용되는 오류를 각각 표시합니다. 이미 입력한 일반 값은 가능한 범위에서 유지합니다.
  3. 대상 브라우저와 스크린리더로 요약 제목, 필드 이름, 도움말과 오류 문구가 읽히는지 확인합니다. 필드가 없는 오류는 설명만 제공하고 빈 링크를 만들지 않습니다.