# 화면 문구 · 버튼 · 오류 메시지

앱이나 웹에서 한 가지 일을 마쳐야 하는 사람을 위해 쓴다. 먼저 지금 어떤 화면이고, 누르면 무엇이 바뀌며, 사용자가 그 변화를 되돌릴 수 있는지 원문이나 제품 설명에서 찾는다. 문구만 주어졌고 동작이 모호하면 결과를 추측해서 버튼에 적지 않는다.

## 화면에 따라 쓰는 말

| 자리 | 독자가 알아야 할 것 | 문장에 적용하는 방법 |
| --- | --- | --- |
| 제목·라벨 | 지금 무엇을 정하는가 | 화면에서 이미 쓰는 대상의 이름을 그대로 쓴다. 같은 문서가 ‘자료’, ‘콘텐츠’, ‘파일’로 바뀌면 사용자가 서로 다른 대상으로 생각할 수 있다. |
| 입력 도움말 | 처음부터 무엇을 넣으면 되는가 | 형식, 상한, 필수 조건 가운데 입력을 실제로 제한하는 조건을 가까이 적는다. 화면에 없는 예외를 만들지 않는다. |
| 오류 | 어느 값이 왜 받아들여지지 않았는가 | 자동으로 확인한 입력 오류라면 항목과 이유를 글로 알려 준다. 사용자가 고칠 수 있는 경우에는 바꾸는 방법을 덧붙인다. 빨간 테두리나 아이콘만으로 알게 하지 않는다. |
| 진행·완료 | 이미 끝난 일은 어디까지인가 | 전송 중, 접수, 승인, 반영을 나눈다. 서버 응답을 받기 전이라면 완료 메시지를 쓰기 어렵다. |
| 버튼 | 누른 직후 어떤 일이 생기는가 | 저장하면 ‘저장’, 다음 화면에서 검토하면 ‘내용 검토’, 즉시 제출하면 ‘제출’처럼 실제 동작을 고른다. 같은 화면의 두 단추를 모두 ‘확인’으로 부르지 않는다. |
| 빈 화면 | 무엇이 비어 있고 지금 무엇을 할 수 있는가 | 전체 목록이 비었는지, 필터로 숨겨졌는지 구별한다. 버튼은 실제 기능이 있을 때만 제시한다. |

길이만 줄여 달라는 요청이면 **대상·동작·결과** 가운데 화면 문맥에서 명확한 부분부터 던다. 문구 전반을 다듬을 때는 클릭 전 라벨, 클릭 직후 상태, 성공·실패 메시지를 연이어 읽는다. 평소 해요체인 앱도 결제·삭제처럼 결과가 큰 순간에는 장난스럽게 돌려 말하지 않는다.

## 오류가 난 필드에서 바로 풀기

**제품 조건 · 만든 예문**  
신청서에 PDF 한 개를 첨부할 수 있다. 10MB까지 허용한다. 사용자가 선택한 파일은 12MB PDF이며, 같은 파일 선택 창을 다시 열 수 있다.

| 자리 | 원문 | 고친 글 |
| --- | --- | --- |
| 항목 이름 | 파일 업로드 진행 | 신청서 파일 |
| 선택 전 도움말 | 양식에 맞는 파일을 첨부해 주세요. | 10MB 이하 PDF 한 개를 첨부해 주세요. |
| 선택 후 오류 | 유효하지 않은 값입니다. 정상적인 파일을 입력해 주세요. | 선택한 PDF는 12MB예요. 10MB 이하인 파일을 선택해 주세요. |
| 버튼 | 재시도 | 파일 다시 선택 |

형식은 이미 맞는다. 형식과 용량을 모두 오류로 지적하면 사용자가 엉뚱한 부분을 고친다. 화면 속 버튼은 파일 선택 창을 다시 여는 동작까지 설명한다. 기기에서 파일을 압축하는 기능은 주어진 조건에 없다.

## 삭제 확인은 두 버튼을 함께 읽기

**제품 조건 · 만든 예문**  
초대 초안을 삭제하면 복구할 수 없다. 초안을 닫으면 내용은 남는다. 초안 단계에서는 초대를 발송하지 않았다.

| 자리 | 원문 | 고친 글 |
| --- | --- | --- |
| 대화상자 제목 | 정말 진행하시겠어요? | 초대 초안을 삭제할까요? |
| 본문 | 선택한 항목이 처리됩니다. | 삭제한 초안은 복구할 수 없어요. |
| 초안을 보존하는 버튼 | 아니요 | 초안 유지 |
| 삭제를 실행하는 버튼 | 예 | 초안 삭제 |

‘초대 취소’는 보낸 초대를 거둬들이는 동작으로 읽힐 수 있다. 기존에 정한 용어인 ‘초안’을 제목과 버튼에 남겼다.

## 결제 결과가 불확실한 순간

‘결제 중 통신이 끊겨 승인 여부를 확인할 수 없습니다’라는 상태에서 ‘결제가 실패했어요. 다시 결제해 주세요’라고 고치면 재결제를 부를 수 있다. 확인된 사실만 살리면 ‘연결이 끊겨 결제 결과를 확인할 수 없어요’가 된다. 거래 내역을 확인하는 기능이 실제로 제공된다면 그때 경로와 버튼을 함께 제시한다.

## 화면에 넣기 전

- 오류만 소리 내 읽어도 문제가 생긴 항목과 이유를 짚을 수 있는가?
- 버튼 두 개의 동사를 맞바꿔 읽어 본다. 뜻이 여전히 같아 보인다면 실제 결과가 드러나게 다시 고친다.
- 글자 수를 줄이면서 최대·최소, 포함·제외, 완료·진행 중, 복구 가능 여부가 사라지지 않았는가?
- 제품 설명이 없는 상태에서 입력 보존, 자동 재시도, 환불, 고객센터 연결 등을 새로 약속하지 않았는가?

## 복사해서 요청하기

```text
아래 화면 문구를 [해요체 / 합니다체 / 기존 말투 유지]로 고쳐 줘.
화면 상황과 실제 동작은 [설명], 유지할 제품 용어는 [목록], 길이 제한은 [있을 때만]이야.
제목·도움말·오류·버튼 중 원고에 있는 자리를 원문과 일대일로 대응해 줘. 줄인 문구와 실제 동작이 맞는지 확인하고, 알 수 없는 상태는 따로 표시해 줘.
[원문]
```

## 참고한 편집 기준

W3C는 자동 감지한 입력 오류가 어느 항목에 있는지 식별하고 그 문제를 글로 설명하도록 한다. GOV.UK는 입력 오류와 사용자가 바로잡을 수 없는 서비스 문제를 구별하고, 버튼의 문구에 실제 동작을 드러내도록 한다. 한국어 예시는 위 제품 조건에 맞춰 새로 작성했다. [W3C의 Error Identification](https://www.w3.org/WAI/WCAG21/Understanding/error-identification.html) · [GOV.UK의 Error message](https://design-system.service.gov.uk/components/error-message/) · [GOV.UK의 Button](https://design-system.service.gov.uk/components/button/)

디지털 정부서비스 디자인시스템(KRDS)은 오류를 고칠 수 있게 입력값을 유지하는 방법과 기능을 예측할 수 있는 버튼 이름을 안내한다. 실제 제품이 오류 후 값을 보존하는지는 화면에서 확인하고 문구에 반영한다. [KRDS의 오류](https://www.krds.go.kr/html/site/global/global_07.html) · [KRDS의 버튼](https://www.krds.go.kr/html/site/component/component_05_02.html)
