Tutorial/portfolio

포트폴리오 사이트 만들기 - Vue

by @webs 2023. 08. 01.

포트폴리오 사이트 만들기 : 라우팅 및 컴퍼넌트

난이도 중간

소스 다운로드

완성 화면 완성 코드 영상 보기

소개

안녕하세요! 웹스토리보이입니다. 이제 본격적으로 뷰에 대해서 셋팅을 하고 작업을 시작해보겠습니다. 기존에 했던 방식과 많이 다르지 않습니다. 하지만 겉모습은 다를 수 있습니다. 그렇다고 어렵진 않습니다. 중요한건 흐름 및 방식을 이해하는 것이 좋습니다. 원리는 비슷하기 때문에 문법이 다르다고 해서, 구현을 못하지 않기 때문에 이런식으로 작동하는구나! 이런 느낌만 받는다면 크게 문제 없을 것입니다. 그럼 시작해볼까요? 고고 😜

포트폴리오 사이트 만들기

VITE SITE

1. 셋팅하기
- 1_1. vite 설치하기
- 1_2. vite 폴더 정리하기
- 1_3. gsap/lenis 설치하기
- 1_4. git 연동하기
2. 레이아웃
- 2.1 레이아웃 구조 만들기
- 2.2 메인 레이아웃 구조 만들기
- 2.3 CSS 셋팅하기
- 2.4 JavaScript 셋팅하기
3. 헤더 영역
- 3.1 헤더 구조 잡기
- 3.2 헤더 디자인 설정
- 3.3 반응형 작업하기
- 3.4 메뉴 자바스크립트 설정
4. 인트로 영역
- 4.1 인트로 구조 잡기
- 4.2 인트로 디자인 설정
- 4.3 반응형 작업하기
5. 스킬 영역
- 5.1 스킬 구조 잡기
- 5.2 스킬 디자인 설정
- 5.3 반응형 작업하기
6. 사이트 영역
- 6.1 사이트 구조 잡기
- 6.2 사이트 디자인 설정
- 6.3 반응형 작업하기
7. 포트폴리오 영역
- 7.1 사이트 구조 잡기
- 7.2 사이트 디자인 설정
- 7.3 반응형 작업하기
- 7.4 스크립트 작업하기
8. 연락처 영역
- 8.1 연락처 구조 잡기
- 8.2 연락처 디자인 설정
- 8.3 반응형 작업하기
9. 푸터 영역
- 9.1 푸터 구조 잡기
- 9.2 푸터 디자인 설정
- 9.3 반응형 작업하기
10. 마무리
- 10.1 스무스 효과주기
- 10.2 링크 연결하기
- 10.3 netlify에 배포하기

REACT SITE

1. 셋팅하기
- 1_1. React 설치하기
- 1_2. React 폴더 정리하기
- 1_3. 라이브러리 설치하기
- 1_4. git 연동하기
2. 라우팅 및 컴퍼넌트
- 2_1. 라우팅 설정하기
- 2_2. 컴퍼넌트 설정하기
- 2_3. SCSS 설정하기
3. 헤더 영역
- 3_1. 헤더 구조잡기
- 3_2. 헤더 디자인 설정
- 3_3. 헤더 데이터 작업
- 3_4. 헤더 토글 메뉴 작업하기
4. 인트로 영역
- 4_1. 인트로 구조잡기
- 4_2. 인트로 디자인 설정
- 4_3. 인트로 데이터 작업
5. 스킬 영역
- 5_1. 스킬 구조잡기
- 5_2. 스킬 디자인 설정
- 5_3. 스킬 데이터 작업
6. 사이트 영역
- 6_1. 사이트 구조잡기
- 6_2. 사이트 디자인 설정
- 6_3. 사이트 데이터 작업
7. 포트폴리오 영역
- 7_1. 포트폴리오 구조잡기
- 7_2. 포트폴리오 디자인 설정
- 7_3. 포트폴리오 데이터 작업
8. 연락처 영역
- 8_1. 연락처 구조잡기
- 8_2. 연락처 디자인 설정
- 8_3. 연락처 데이터 작업
9. 푸터 영역
- 9_1. 푸터 구조잡기
- 9_2. 푸터 디자인 설정
- 9_3. 푸터 데이터 작업
10. 마무리
- 10_1. 데이터 통합하기
- 10_2. 스무스 효과 넣어주기
- 10_3. 가로모드 구현하기
- 10_4. netlify에 배포하기

VUE SITE

1. 셋팅하기
- 1_1. Vue 설치하기
- 1_2. Vue 폴더 정리하기
- 1_3. 라이브러리 설치하기
- 1_4. git 연동하기
2. 라우팅 및 컴퍼넌트
- 2_1. 라우팅 설정하기
- 2_2. 컴퍼넌트 설정하기
- 2_3. SCSS 설정하기

2. 라우팅 및 컴퍼넌트

2.1 라우팅 설정하기

라우팅(Routing)은 단일 페이지 애플리케이션(Single Page Application, SPA)에서 다른 페이지로 이동하는 방법을 관리하는 기능을 말합니다. SPA는 페이지를 새로 로드하지 않고, 동적으로 콘텐츠를 변경하여 사용자 경험을 향상시키는데, 이때 라우팅이 중요한 역할을 합니다.

SPA(단일 페이지 애플리케이션)는 웹 애플리케이션의 설계 패턴 중 하나로, 하나의 HTML 페이지를 기반으로 동적으로 콘텐츠를 변경하여 사용자와 상호작용하는 웹 애플리케이션을 구현하는 방법입니다. SPA는 전통적인 다중 페이지 애플리케이션(MPA, Multi-Page Application)과는 다른 웹 애플리케이션 구조를 가지고 있습니다.

단일 페이지 : SPA는 하나의 HTML 페이지로 시작하고, 페이지 전환 시에도 새로운 HTML을 서버로부터 불러오지 않습니다. 대신, 필요한 데이터와 콘텐츠를 비동기적으로 불러와서 동적으로 페이지를 업데이트합니다. 이로 인해 초기 로딩 속도가 빨라지고, 사용자 경험이 향상됩니다.
동적 로딩 : SPA는 초기에 필요한 모든 리소스(스크립트, 스타일시트 등)를 불러온 후, 필요한 데이터만을 요청하여 동적으로 페이지를 구성합니다. 이는 필요한 리소스를 미리 불러와 사용자가 다른 페이지로 이동할 때 렌더링 지연을 최소화하고, 부분적인 페이지 업데이트를 수행할 수 있게 합니다.
클라이언트 측 렌더링 : SPA는 주로 클라이언트 측에서 페이지를 렌더링합니다. 서버 측에서는 데이터만을 전달하며, 클라이언트에서 페이지의 구조와 렌더링을 처리합니다. 이로 인해 서버 부하가 줄어들고, 클라이언트 측에서 유연한 UI를 구성할 수 있습니다.
상태 관리 : SPA는 클라이언트 측에서 상태를 관리하기 쉽습니다. 주로 리액트와 같은 라이브러리나 프레임워크를 사용하여 상태 관리를 용이하게 처리할 수 있습니다.
빠른 UIUX : SPA는 페이지 전환 시 화면이 깜박이지 않고, 새로운 페이지가 빠르게 로딩되는 등 사용자 경험이 좋습니다.
루트 URL : SPA는 주로 루트 URL 하나로 시작하며, 이후 URL의 경로에 따라 다른 컴포넌트나 뷰를 렌더링합니다. 이로 인해 라우팅(Routing)이 중요한 역할을 합니다.
모바일 앱과 유사한 경험: SPA는 네이티브 모바일 앱과 유사한 사용자 경험을 제공할 수 있습니다. 이를 통해 웹 앱을 모바일 환경에서도 자연스럽게 사용할 수 있습니다.

Router 폴더에 index.js 는 다음과 같이 설정합니다. 리액트와 문법이나 스타일은 다르지만, 기본 흐름은 같습니다. 메인 페이지 하나밖에 없기 때문에 이런식으로 작업하면 되고, 메인 페이지에서 HomeView라는 컴퍼넌트를 불러오는 구조입니다.

import { createRouter, createWebHistory } from 'vue-router'
import HomeView from '../views/HomeView.vue'

const router = createRouter({
    history: createWebHistory(import.meta.env.BASE_URL),
    routes: [
        {
            path: '/',
            name: 'home',
            component: HomeView
        }
    ]
})

export default router

App.vue에는 다음과 같이 작업합니다. RouterView는 현재 경로에 해당하는 라우팅 컴포넌트를 자동으로 매핑하고 렌더링해 줍니다. 이를 통해 각 페이지에 대한 컴포넌트를 자동으로 스위칭하게 됩니다. 이부분이 없으면 페이지가 생성되지 않으니, 꼭 확인바랍니다.

<script setup>
import { RouterView } from "vue-router";
</script>

<template>
    <RouterView />
</template>

2.2 컴퍼넌트 설정하기

기본 구조는 다음과 같이 작업하겠습니다. 뷰는 컴퍼넌트 이름을 만들때 두개의 단어를 결합하고 앞 글자는 대문자로 써야 합니다.

src
- assets
- components
  - ContactSection.jsx
  - FooterSection.jsx
  - HeaderSection.jsx
  - IntroSection.jsx
  - PortSection.jsx
  - SiteSection.jsx
  - SkillSection.jsx
  - SkipSection.jsx
- constants
  - index.js
- router
  - index.js
- views
  - HomeView.jsx

페이지를 나타내는 HomeView.jsx에는 다음과 같이 작성하겠습니다. 이렇게 HomeView 컴포넌트를 사용하여 홈 페이지의 UI를 구성합니다. 각 컴포넌트들은 기능별로 분리되어 관리되므로, 코드의 가독성과 유지보수성이 좋아집니다. 이렇게 구성된 컴포넌트들을 조합하여 리액트 애플리케이션을 구축할 수 있습니다.

컴퍼넌트를 불러오는 방식은 동일합니다. script setup Vue 3에서 도입된 새로운 기능으로, setup() 함수를 사용하여 컴포넌트 옵션을 정의합니다. 이를 통해 템플릿에서 자동으로 해결되고 제공되는 종속성을 가져올 수 있습니다

@ 기호는 주로 모듈 번들러에서 사용되는 특별한 경로 별칭(alias)입니다. 웹 애플리케이션을 번들링하기 위해 사용되는 도구로, 여러 개의 자바스크립트 파일 및 리소스를 하나의 번들 파일로 결합하여 웹페이지 로딩 속도를 최적화하는데 도움을 줍니다. vue도 번들러 기능이 있기 때문에 이런 @ 기호를 사용해서 쓸 수 있습니다.

<script setup>
import HeaderSection from "@/components/HeaderSection.vue";
import FooterSection from "@/components/FooterSection.vue";
import IntroSection from "@/components/IntroSection.vue";
import SkillSection from "@/components/SkillSection.vue";
import SiteSection from "@/components/SiteSection.vue";
import PortSection from "@/components/PortSection.vue";
import ContactSection from "@/components/ContactSection.vue";
import SkipSection from "@/components/SkipSection.vue";
</script>

<template>
    <SkipSection />
    <HeaderSection />
    <main id="main" role="main">
        <IntroSection />
        <SkillSection />
        <SiteSection />
        <PortSection />
        <ContactSection />
    </main>
    <FooterSection />
</template>

ContactSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다. 기본 소스는 매우 간단합니다.

<template>
    ContactSection
</template>

FooterSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다.

<template>
    FooterSection
</template>

HeaderSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다.

<template>
HeaderSection
</template>

IntroSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다.

<template>
IntroSection
</template>

PortSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다.

<template>
PortSection
</template>

SiteSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다.

<template>
SiteSection
</template>

SkillSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다.

<template>
SkillSection
</template>

SkipSection.vue 파일에는 다음과 같이 기본 소스만 넣어주겠습니다.

<template>
    <div id="skip">
        <a href="#header">헤더 영역</a>
        <a href="#intro">소개 영역</a>
        <a href="#skill">스킬 영역</a>
        <a href="#site">사이트 영역</a>
        <a href="#port">포트폴리오 영역</a>
        <a href="#contact">연락처 영역</a>
        <a href="#footer">푸터 영역</a>
    </div>
</template>

2.3 SCSS 설정하기

SCSS는 CSS의 확장 버전으로, CSS의 단점을 보완하고 개발자들에게 더 편리한 방식으로 스타일 시트를 작성할 수 있도록 도와주는 전처리기(preprocessor)입니다. SCSS는 SASS(Syntactically Awesome Style Sheets)라는 원래 버전의 상위집합(superset)으로, CSS와 거의 동일한 구문을 사용하면서도 추가적인 기능과 유용한 문법을 제공합니다.

변수(Variables) : $ 기호를 사용하여 변수를 선언하고, 변수를 이용하여 스타일 값을 저장하고 재사용할 수 있습니다. 이를 통해 스타일 시트를 유지보수하기 쉽고 가독성이 좋게 만들어 줍니다.
중첩(Nesting) : 스타일 규칙을 중첩하여 DOM 트리의 구조와 일치시킬 수 있습니다. 이를 통해 스타일 시트의 계층 구조를 명확하게 표현할 수 있으며, 중첩된 요소의 스타일을 쉽게 찾고 수정할 수 있습니다.
믹스인(Mixins) : @mixin 지시어를 사용하여 스타일 규칙들을 정의하고, @include 지시어를 사용하여 해당 믹스인을 적용할 수 있습니다. 이를 통해 스타일 규칙들을 재사용하거나, 여러 스타일 규칙들을 하나로 묶어 사용할 수 있습니다.
상속(Inheritance) : @extend 지시어를 사용하여 스타일 규칙을 상속할 수 있습니다. 이를 통해 비슷한 스타일들을 그룹화하고 관리할 수 있으며, 스타일 코드의 중복을 줄일 수 있습니다.
조건문(Conditionals) : @if, @else if, @else와 같은 조건문을 사용하여 특정 조건에 따라 다른 스타일 규칙을 적용할 수 있습니다.
반복문(Loops) : @for, @each, @while과 같은 반복문을 사용하여 스타일 규칙을 반복해서 생성할 수 있습니다.

이번에도 scss를 이용해서 작업해보겠습니다. npm run sass를 통해서 scss가 설치되어 있어야 합니다. SCSS 파일을 설정하고 import 할 때 앞에 언더스코어(_)를 붙이는 것은 SCSS의 부분 파일 또는 믹스인 파일을 의미합니다. 이렇게 파일명 앞에 언더스코어를 붙이면 해당 파일이 부분 파일이거나 믹스인 파일임을 나타내고, 이러한 파일들은 별도로 컴파일되지 않고 다른 SCSS 파일에서 @import 지시어를 통해 불러올 수 있습니다. 리액트와 다른점은 뷰 같은 경우는 페이지마다 style을 설정하는 부분이 있어서, 해당 컴퍼넌트의 CSS는 해당 페이지에서 작업할 것입니다.

assets
- img
- scss
  - style.css

style.scss을 설정하겠습니다. CSS 코드를 모듈화하고, 스타일 시트를 섹션별로 분리하여 관리할 수 있습니다. 이는 코드의 가독성과 유지보수성을 높여주는 방법입니다

@charset "UTF-8";

// setting
@import "fonts";
@import "vars";
@import "reset";
@import "mixin";

_fonts.scss을 설정하겠습니다.

@import url("https://fonts.googleapis.com/css2?family=Montserrat:wght@100;200;300;400;500;600;700;800;900&display=swap");
@import url("https://websfont.github.io/nanumSquareNeo/nanumSquareNeo.css");
@import url("https://websfont.github.io/gmarket/gmarket.css");

.mont {
    font-family: "Montserrat";
}
.nanum {
    font-family: "nanumSquareNeo";
}
.gmarket {
    font-family: "gmarket";
}

_vars.scss을 설정하겠습니다.

:root {
    --mainEng-font: "Montserrat";
    --mainKor-font: "nanumSquareNeo";
    --mainNum-font: "gmarket";
  
    --mainBg-color: #f3ede8;
    --subBg100: #cdc0b1;
    --subBg200: #afa395;
    --subBg300: #81887c;
    --subBg400: #afa7a2;
    --subBg500: #a6afa2;
  
    --white: #fff;
    --black: #000;
    --black100: #2b2b2b;
    --black200: #434343;
    --black300: #686868;
    --black400: #e0e0e0;
  
    font-family: var(--mainEng-font), var(--mainKor-font);
    font-size: 16px;
    line-height: 1.5;
    font-weight: 400;
  
    font-synthesis: none;
    text-rendering: optimizeLegibility;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    -webkit-text-size-adjust: 100%;
  
    @media (max-width: 800px) {
        font-size: 14px;
        line-height: 1.4;
    }
}
  
body {
    background-color: var(--mainBg-color);
}

_reset.scss을 설정하겠습니다.

// border-box 초기화
*,
*:before,
*:after {
    -webkit-box-sizing: border-box;
    -moz-box-sizing: border-box;
    box-sizing: border-box;
}

// 공백 초기화
body,
button,
dd,
dl,
dt,
fieldset,
form,
h1,
h2,
h3,
h4,
h5,
h6,
input,
legend,
li,
ol,
p,
select,
table,
td,
textarea,
th,
ul,
figure,
figcaption {
    margin: 0;
    padding: 0;
}

// 폰트 초기화 
body,
button,
input,
select,
table,
textarea {
    font-family: var(--mainEng-font), var(--mainKor-font), "Apple SD Gothic Neo", "Malgun Gothic", "맑은 고딕", helvetica, sans-serif;
}

// 링크 초기화
a,
a:hover,
a:focus {
color: inherit;
    text-decoration: none;
}

// 스타일 초기화
h1,
h2,
h3,
h4,
h5,
h6 {
    font-weight: normal;
}

ul {
    list-style: none;
}

em,
address {
    font-style: normal;
}

strong {
    font-weight: normal;
}

img {
    vertical-align: top;
    width: 100%;
}

// 스킵메뉴
#skip a {
    position: absolute;
    left: 10px;
    top: -92px;
    z-index: 100000;
    font-size: 1rem;
    padding: 10px 30px;
    color: var(--white);
    background: var(--black);
}
#skip a:focus,
#skip a:active {
    top: 10px;
}

_mixin.scss을 설정하겠습니다. @mixin을 사용하여 스타일 규칙들을 묶어 믹스인으로 만들면, 해당 믹스인을 다른 스타일 규칙에서 @include 지시어를 사용하여 쉽게 불러와서 재사용할 수 있습니다. 간단하게 자주 사용하는 규칙을 믹스인으로 만들겠습니다.

// 가운데 정렬
@mixin flex-center {
    display: flex;
    align-items: center;
    justify-content: center;
}
    
// 양쪽 정렬
@mixin flex-between {
    display: flex;
    align-items: center;
    justify-content: space-between;
}

// 중앙 정렬
@mixin position-center {
    position: absolute;
    left: 50%;
    top: 50%;
    transform: translate(-50%, -50%);
}

// 상단 고정
@mixin position-fixed {
    position: fixed;
    left: 0;
    top: 0;
    width: 100%;
}

scss 설정도 완료가 되었습니다. 하지만 적용은 되지 않습니다. main.js에서 CSS를 연동하여야 합니다. import "./assets/scss/style.scss"; 이 코드를 추가해주세요!

import "./assets/scss/style.scss";

import { createApp } from "vue";
import App from "./App.vue";
import router from "./router";

....

3. 마무리

세번째 셋팅입니다. 점점 익숙해지고 쉬어지죠? 새로 배우는 언어는 처음에 어렵고 이해하기 힘들지만, 조금씩 반복적으로 하나씩 해보면 별거 없습니다. 아마 여러분들은 에러도 많이 발생하고 따라오기가 쉽지 않을거라고 생각이 들지만, 검색하고, 하나씩 고치고 따라하다 보면 실력을 상승되어 있을 겁니다. 안되는 만큼 실력이 많이 늡니다. 그러니 포기하지 말고 끝까지 잘 따라오시길 바랍니다. 수고하셨습니다. 😎

😘 이런 에러가 난다면...

뷰에서는 컴퍼넌트 이름을 지을 때에는 두개의 단어가 결합된 형태로 만들어야 합니다. 이런 부분은 기본 규칙이기 때문에 이 사항을 지키지 않으면 다음과 같은 에러가 발생할 수 있습니다.

Failed to reload /src/components/icons/IconCommunity.vue. This could be due to syntax errors or importing non-existent modules. (see errors above)

완성 화면 소스 보기 영상 보기

WEBSTORYBOY

재능은!
노력 끝에서 발견된다

22. 포트폴리오 사이트 만들기 : Vue-Site : 라우팅 및 컴퍼넌트

포트폴리오 사이트 만들기 - Vue

소개

포트폴리오 사이트 만들기

VITE SITE

REACT SITE

VUE SITE

2. 라우팅 및 컴퍼넌트

2.1 라우팅 설정하기

2.2 컴퍼넌트 설정하기

2.3 SCSS 설정하기

3. 마무리

😘 이런 에러가 난다면...

예제 목록

댓글

티스토리툴바

재능은!노력 끝에서 발견된다

22. 포트폴리오 사이트 만들기 : Vue-Site : 라우팅 및 컴퍼넌트

포트폴리오 사이트 만들기 - Vue

소개

포트폴리오 사이트 만들기

VITE SITE

REACT SITE

VUE SITE

2. 라우팅 및 컴퍼넌트

2.1 라우팅 설정하기

2.2 컴퍼넌트 설정하기

2.3 SCSS 설정하기

3. 마무리

😘 이런 에러가 난다면...

예제 목록

관련글

댓글

티스토리툴바

재능은!
노력 끝에서 발견된다