Vue에서 값이 없을 때 괄호 숨기기: null·빈 문자열·0 구분
목록에 이름과 보조 정보를 함께 표시하려고 다음처럼 문자열을 만들 수 있습니다.
item.bbb + '(' + item.ddd + ')'
bbb가 '교실', ddd가 '본관'이면 교실(본관)이 됩니다. 그런데 보조 정보가 빠지면 교실()이나 교실(null)이 보입니다. 조건을 if (item.ddd)로 바꾸면 숫자 0까지 사라질 수 있습니다.
해결할 지점은 괄호 안의 값만 기본값으로 바꾸는 것이 아닙니다. 보조 값을 정규화한 다음, 표시할 내용이 있을 때만 괄호 전체를 붙이면 됩니다. 아래 예제는 문자열과 유한한 숫자를 보조 값으로 받는 Vue 3 화면을 기준으로 합니다.
1. 먼저 “값이 없다”의 범위를 정한다
이 글에서는 다음 표시 규칙을 사용합니다. 기본 이름 bbb는 문자열이며 그대로 보존합니다.
보조 값 ddd |
표시 결과: 기본 이름이 항목일 때 |
|---|---|
null, undefined |
항목 |
'' |
항목 |
' ', 탭·줄바꿈만 있는 문자열 |
항목 |
숫자 0 |
항목(0) |
문자열 '0' |
항목(0) |
' 본관 ' |
항목(본관) |
-3, 1.5 |
항목(-3), 항목(1.5) |
문자열 'null' |
항목(null) |
실제 null과 네 글자로 된 문자열 'null'은 서로 다릅니다. 서버가 문자열 'null'을 “없음”의 뜻으로 보내는 계약이라면 API 경계에서 별도로 정규화해야 합니다.
공백 처리에는 trim()을 사용합니다. 이 메서드는 문자열 양 끝의 공백을 제거한 새 문자열을 반환하며, 가운데 공백은 유지합니다. 눈에 보이지 않는 문자가 모두 제거되는 것은 아닙니다. 예를 들어 zero-width space인 \u200B는 이 예제의 trim() 처리만으로 사라지지 않습니다. MDN trim 문서
불리언·배열·객체·BigInt와 NaN·Infinity는 이 예제의 입력 범위에서 제외합니다. 업무에서 false도 표시해야 한다면 먼저 “아니오”처럼 어떤 텍스트로 나타낼지 정해야 합니다.
2. 괄호 전체를 조건부로 붙인다
다음 파일을 label.mjs로 둡니다. 정규화와 라벨 조합을 분리해 두면 다른 목록에서도 같은 규칙을 사용할 수 있습니다.
/**
* base: string (kept exactly as supplied)
* detail: string | finite number | null | undefined
*/
export function optionalDetail(detail) {
if (detail === null || detail === undefined) return '';
if (typeof detail === 'string') return detail.trim();
if (typeof detail === 'number' && Number.isFinite(detail)) {
return String(detail);
}
throw new TypeError('detail must be a string, finite number, null or undefined');
}
export function formatLabel(base, detail) {
if (typeof base !== 'string') {
throw new TypeError('base must be a string');
}
const suffix = optionalDetail(detail);
return suffix === '' ? base : `${base}(${suffix})`;
}
export function buildDisplayRows(rows) {
return rows.map(item => ({
...item,
label: formatLabel(item.bbb, item.ddd),
}));
}
직접 한 행에 적용할 때는 다음처럼 호출합니다.
const label = formatLabel(item.bbb, item.ddd);
optionalDetail()은 null·undefined를 빈 문자열로, 문자열은 공백 정리 후의 값으로, 유한한 숫자는 문자열로 바꿉니다. 따라서 숫자 0은 '0'이 되고, suffix === '' 조건에 걸리지 않습니다. MDN Number.isFinite 문서
여기서 타입 검사는 잘못된 데이터를 조용히 숨기지 않기 위한 선택입니다. 허용하지 않은 값이 들어오면 TypeError가 발생합니다. API 응답을 그대로 넣는 화면이라면 렌더링 전에 타입을 검증하고 오류 행을 어떻게 처리할지 정해야 합니다. 이 함수 자체가 네트워크 응답 검증 전체를 대신하지는 않습니다.
기본 이름은 임의로 잘라내거나 다른 문구로 바꾸지 않습니다. 기본 이름을 빈 문자열로 주고 보조 값만 0으로 주면 (0)이 됩니다. 이름이 필수인 화면은 그 조건도 입력 단계에서 검사합니다.
3. 삼항 연산자와 ??가 각각 놓치는 부분
다음 코드는 짧지만 숫자 0을 없애 버립니다.
const detail = 0;
const label = '항목' + (detail ? '(' + detail + ')' : '');
// '항목'
삼항 연산자의 조건은 참·거짓으로 평가됩니다. 이때 숫자 0은 거짓으로 취급됩니다. detail || '' 역시 0을 빈 문자열로 바꿉니다. 반면 detail ?? ''은 null과 undefined일 때만 오른쪽 기본값을 선택합니다. ECMAScript 논리·조건 연산 명세 · MDN ?? 문서
하지만 ??로 값만 바꿔도 괄호는 그대로 남습니다.
'항목' + '(' + (null ?? '') + ')'; // '항목()'
이미 문자열을 조합한 뒤의 null 글자를 지우려고 하지 말고, 조합 전에 보조 값이 비었는지 확인해야 합니다. 문자열과 +로 연결한 null·undefined는 표시 문자열의 일부가 될 수 있습니다. Vue가 문자열 안에서 이 단어들을 찾아 자동으로 지워 주지는 않습니다. MDN 덧셈·문자열 연결 문서
즉, ??는 null 계열 기본값 처리에 유용하지만, “빈 보조 값이면 괄호도 숨긴다”라는 표시 정책은 별도로 작성해야 합니다.
4. 원본 필드와 표시용 label을 분리한다
API에서 받은 bbb를 표시 문자열로 덮어쓰면, 같은 데이터를 다시 가공할 때 교실(본관)(본관)처럼 괄호가 중복될 수 있습니다. 저장 요청에도 가공된 이름이 섞일 수 있습니다.
위 파일의 buildDisplayRows()는 각 행을 펼친 새 객체에 label을 추가합니다.
const rows = [
{ id: 'a', bbb: '교실', ddd: ' 본관 ' },
{ id: 'b', bbb: '잔여 수량', ddd: 0 },
{ id: 'c', bbb: '비고', ddd: null },
];
const displayRows = buildDisplayRows(rows);
// displayRows[0].label === '교실(본관)'
// displayRows[1].label === '잔여 수량(0)'
// displayRows[2].label === '비고'
//
// rows[0].bbb === '교실'
// rows[0].ddd === ' 본관 '
map()이 새 배열을 만든다는 사실만으로 원본 객체까지 자동 복사되는 것은 아닙니다. 이 예제에서는 { ...item, label: ... }로 각 행도 새 객체로 만들고, 원본 필드에는 대입하지 않습니다. 중첩 객체가 있다면 그 내부까지 깊게 복사하는 코드는 아니라는 점도 구분해야 합니다. MDN map 문서
저장할 때는 표시용 label을 API가 요구하는 원래 필드 대신 전송하지 않도록 요청 구조를 확인합니다.
5. Vue에서는 computed로 현재 라벨을 계산한다
부모에서 반응형 배열을 rows prop으로 전달하는 경우의 자식 컴포넌트입니다. 위 label.mjs와 같은 폴더에 둡니다.
<script setup>
import { computed } from 'vue';
import { buildDisplayRows } from './label.mjs';
const props = defineProps({
rows: { type: Array, required: true },
});
const displayRows = computed(() => buildDisplayRows(props.rows));
</script>
<template>
<ul>
<li v-for="item in displayRows" :key="item.id">
{{ item.label }}
</li>
</ul>
</template>
부모에서 rows[0].ddd를 null → 0 → ' ' 순서로 바꾸면 화면 라벨은 항목 → 항목(0) → 항목 순서로 바뀝니다. 이 예제의 computed는 계산 중 읽은 반응형 데이터에 따라 표시 목록을 다시 계산합니다. 서버가 바뀌었다는 사실을 스스로 감지하는 기능은 아니므로, 재조회한 응답을 부모의 반응형 배열에 반영해야 합니다. Vue computed 공식 가이드
초기화할 때 한 번 만든 배열이 조건 변경을 따라오지 않는 문제는 Vue ref 조건을 바꿨는데 목록이 그대로일 때에서 재현 과정을 볼 수 있습니다.
item.id는 같은 목록 안에서 고유하고 행이 이동해도 유지되는 값이라는 전제입니다. 표시용 label은 바뀔 수 있으므로 key로 쓰지 않습니다. 행 삭제·정렬과 입력 상태의 관계는 Vue 동적 폼의 index key와 안정적인 ID에 정리했습니다.
라벨에는 {{ item.label }} 텍스트 보간을 사용합니다. 입력값에 <b>0</b>가 있더라도 이 예제의 목적은 그 문자열을 표시하는 것입니다. 단순 괄호 표시에 v-html은 필요하지 않습니다. Vue 템플릿 문법 공식 가이드
6. 적용할 때 확인할 결과
가장 먼저 실제 API 값의 타입을 확인합니다. 같은 0이라도 숫자 0과 문자열 '0'이 섞여 있을 수 있습니다. 이번 함수는 둘 다 표시하지만, 불리언이나 객체는 받지 않습니다.
그다음 다음 결과를 확인합니다.
null·undefined·빈 문자열·공백만 있는 문자열에서 괄호가 모두 사라지는가.- 숫자 0과 문자열 '0'은 괄호 안에 남는가.
- 보조 값을 변경하거나 목록을 재조회하면 라벨도 바뀌는가.
- 여러 번 표시 목록을 계산해도 원본 이름과 보조 값이 변하지 않는가.
- 같은 이름의 행이 있더라도 각 행의 ID가 고유하게 유지되는가.
괄호가 계속 보이면 ddd가 실제로 빈 값인지, 이미 bbb에 괄호가 포함됐는지부터 확인합니다. 이 함수는 기본 이름의 기존 괄호를 제거하지 않습니다. 데이터가 맞는데 이전 라벨이 남으면 한 번 계산한 값을 저장해 두었는지, 부모가 변경 내용을 반응형 데이터에 반영했는지를 살펴봅니다.
검증 환경과 범위
2026-11-17에 Node.js 24.22.1, Vue 3.5.45, @vue/compiler-sfc 3.5.45, jsdom 31.0.1에서 제공한 함수와 SFC를 실행했습니다. 22개 테스트가 통과했습니다.
빈 값·0·문자열 공백·지원하지 않는 타입, 원본 보존, 반복 변환, SFC 컴파일, 반응형 값 변경, 배열 교체·재정렬, HTML처럼 보이는 문자열의 텍스트 표시를 확인했습니다. 실제 서비스 API와의 통합이나 휴대전화 브라우저의 레이아웃을 검증한 결과는 아닙니다.