Vue 3 스코프드 스타일에서 하위 컴포넌트 스타일을 깊게 적용하는 ::v-deep 선택자

Vue 컴포넌트에서 scoped 스타일을 사용할 때, CSS 선택자는 기본적으로 해당 컴포넌트의 DOM 요소에만 적용됩니다. 이는 하위 컴포넌트의 내부 DOM에 직접 스타일을 적용하는 것을 제한합니다. 이러한 제약을 극복하고 하위 컴포넌트의 구조에 스타일을 적용할 수 있도록 Vue는 깊이 선택자(deep selector) 기능을 제공합니다.

깊이 선택자란?

깊이 선택자는 scoped 스타일 내에서 하위 컴포넌트의 스타일 유효 범위를 벗어나 내부 요소에 스타일을 적용할 수 있게 해주는 메커니즘입니다. Vue 2와 Vue 3에서는 이 깊이 선택자를 표현하는 방식에 차이가 있습니다.

Vue 2의 >>> 문법

Vue 2에서는 scoped 스타일 내에서 >>>를 깊이 선택자로 사용했습니다.

<style scoped>
.parent >>> .child {
  color: red;
}
</style>

이 >>> 문법은 빌드 시점에 다양한 CSS 전처리기(preprocessor)에 호환되는 /deep/와 같은 형태로 변환됩니다.

Vue 3의 ::v-deep 문법

Vue 3에서는 ::v-deep이 깊이 선택자의 표준 표기법으로 권장됩니다.

<style scoped>
::v-deep(.child) {
  color: red;
}
</style>

빌드 과정에서 Vue는 이 스타일을 자동으로 조정하여 하위 컴포넌트의 해당 요소에 올바르게 적용되도록 처리합니다.

깊이 선택자 사용 사례

1. 서드파티 컴포넌트 스타일 수정

예를 들어, Element Plus의 el-input 컴포넌트를 사용할 때 내부의 .el-input__inner 요소의 스타일을 조정해야 할 수 있습니다.

<style scoped>
::v-deep(.el-input__inner) {
  border: 2px solid red;
}
</style>

이 방식을 통해 scoped 스타일 범위 내에서 el-input 컴포넌트 내부의 input 요소 스타일을 효과적으로 수정할 수 있습니다.

2. 중첩된 하위 컴포넌트 적용

때로는 부모 컴포넌트에서 깊숙이 중첩된 하위 컴포넌트의 특정 스타일을 수정해야 할 때가 있습니다.

<style scoped>
.parent ::v-deep(.child) {
  font-size: 20px;
}
</style>

이렇게 하면 .child 요소가 해당 하위 컴포넌트에 속해 있더라도 스타일이 올바르게 적용되는 것을 보장할 수 있습니다.

깊이 선택자의 대안

경우에 따라 ::v-deep 사용을 피하고 다음과 같은 대안적인 방법을 고려할 수 있습니다.

1. 하위 컴포넌트에서 class 또는 props 노출

하위 컴포넌트가 class 속성 전달(prop passing)을 지원한다면, 해당 컴포넌트에 직접 class를 추가하여 스타일을 수정할 수 있습니다.

<child-component class="custom-style" />

<style scoped>
.custom-style {
  color: blue;
}
</style>

또는, 하위 컴포넌트가 내부 스타일 수정을 허용하는 props를 제공할 수도 있습니다.

2. 전역 CSS 선택자 사용

만약 특정 컴포넌트의 스타일을 전역적으로 수정해야 한다면, 전역 스타일 또는 :global 선택자(Sass/Less 등에서 사용 가능)를 활용할 수 있습니다.

:global(.child) {
  font-weight: bold;
}

::v-deep은 Vue 3에서 >>>를 대체하는 scoped 스타일 내에서 하위 컴포넌트의 스타일을 깊게 적용하는 데 사용됩니다. 유용하지만, 컴포넌트화 원칙에 더 부합하는 props 전달이나 class 전달과 같은 다른 방법을 우선적으로 고려하는 것이 컴포넌트의 유지보수성과 재사용성을 높이는 데 도움이 됩니다.

태그: Vue.js vue3 CSS scoped deep selector

10월 23일 07:09에 게시됨