HeropCode/Vue-Todo-app

Vue Todo list app

• 같은 테스트 환경을 위해 VueJS를 ^2 버전으로 설치하도록 문서를 수정했습니다.
  • 강의 영상의 VueJS 버전은 2.6.10 버전입니다.
• 모든 모듈의 버전은 Package.json 파일을 참고해주세요.
• 강의 영상의 NodeJS 버전은 10.15.0이며, 그 이상의 LTS 버전(짝수 버전)을 사용하시길 권장합니다.
• 강의 영상의 NPM 버전은 6.5.0이며, 역시 그 이상의 버전을 사용하시길 권장합니다.
• 버그 및 수정/건의 사항 등은 Issues 혹은 thesecon@gmail.com으로 문의 부탁드립니다.

웹팩(Webpack)을 이용해 개발 환경을 구성합니다.
Vue CLI를 사용하지 않음으로 Vue 기반 프로젝트가 기본적으로 어떻게 동작하는지 이해합니다.

Demo

각 코드에 주석이 작성되어 있으니, 완성된 코드도 꼭 참고하세요.

Chapter 1

Vue.js를 사용해 스타일 없이 기본적인 Todo App를 만듭니다.

npm install

의존성 모듈 설치

패키지의 배포 시 포함될 의존성 모듈을 지정합니다.

$ npm install --save MODULE_NAME
# or
$ npm i MODULE_NAME

개발용 의존성 모듈 설치

패키지의 개발 시 사용될 의존성 모듈을 지정합니다.(배포 시 포함되지 않습니다)

$ npm install --save-dev MODULE_NAME
# or
$ npm i -D MODULE_NAME

한 번에 설치하기

다음은 'Chapter 1'의 '한 번에 설치하기' 입니다!

$ npm i vue@^2 @babel/polyfill

$ npm i -D webpack webpack-cli webpack-dev-server webpack-merge @babel/core @babel/preset-env babel-loader vue-template-compiler vue-loader vue-style-loader css-loader node-sass sass-loader@^7 eslint@^5 babel-eslint eslint-config-standard@^12 eslint-plugin-import eslint-plugin-node eslint-plugin-promise eslint-plugin-standard eslint-plugin-vue html-webpack-plugin copy-webpack-plugin clean-webpack-plugin postcss-loader autoprefixer

Webpack

webpack은 웹팩(Webpack)의 핵심 패키지이며,
webpack-cli는 터미널에서 웹팩 명령(Commands)를 실행할 수 있게 해주는 도구입니다.

$ npm i -D webpack webpack-cli

개발용으로 실시간 Reload 서버를 실행하기 위해 webpack-dev-server를 설치합니다.

$ npm i -D webpack-dev-server

webpack-merge는 웹팩 Config 객체를 병합(merge)하기 위해 설치합니다.
웹팩을 개발용(dev)과 배포용(build)으로 구분해 실행할 수 있습니다.

$ npm i -D webpack-merge

webpack.config.js 파일을 생성합니다.
자세한 설정 내용은 완성된 파일(webpack.config.js)을 참고하세요.

Webpack 사용 시 자주 묻는 질문

터미널에서 webpack --mode production 명령이 동작하지 않아요!

우선 첫 번째 방법부터 시도해 보세요.
아래 내용으로 해결되지 않으면, 다른 문제가 있을 수 있습니다.

첫 번째 해결 방법

package.json 파일의 "scripts" 항목에 다음과 같이 내용을 추가하세요.
"scripts" 항목에 추가된 스크립트는 실행될 때 이미 설치된 패키지를 참조합니다.

{
  "scripts": {
    "build": "webpack --mode production"
  }
}

그리고 터미널에서 다음과 같이 입력하세요.

$ npm run build

두 번째 해결 방법

터미널에서 다음과 같이 npx로 시작해서 명령을 입력하세요.
npx은 해당 명령을 패키지 설치 없이도 실행할 수 있는 명령입니다.

NPX는 NPM@5.2.0 버전부터 사용할 수 있습니다.

$ npx webpack --mode production

세 번째 해결 방법

webpack 명령이 어디서나 동작할 수 있도록 다음과 같이 -g 플래그를 사용해 전역으로 설치합니다.

## 전역 설치
$ npm install -g webpack webpack-cli

## 동작
$ webpack --mode production

Babel

바벨(Babel)은 ES6 이상의 코드를 ES5 이하 버전으로 변환하기 위해 사용합니다.

• @babel/core: 바벨이 실제 동작하는 모듈입니다.
• @babel/preset-env: 바벨의 지원 스펙을 지정합니다.
• babel-loader: 웹팩(Webpack) 지원을 위해 사용합니다.

$ npm i -D @babel/core @babel/preset-env babel-loader

.babelrc 파일을 생성하고 다음 옵션을 추가합니다.

{
  "presets": ["@babel/preset-env"]
}

구형 및 일부 브라우저에서 지원하지 않는 기능들을 지원할 수 있도록 @babel/polyfill을 의존성 모듈로 설치합니다.(-D(--save-dev)가 없어야 합니다!)

• @babel/ployfill

$ npm i @babel/polyfill

설치 후 webpack.config.js에 다음과 같이 설정합니다.

// ...
require('@babel/polyfill')

const config = {
  // ...
  entry: {
    app: [
      '@babel/polyfill',
      path.join(__dirname, 'main.js')
    ]
  }
  // ...
}

Vue

vue를 설치합니다.(-D(--save-dev)가 없어야 합니다!)

$ npm i vue@^2

웹팩에서 .vue 파일을 해석할 수 있도록 다음 모듈들을 설치합니다.

• vue-template-compiler
• vue-loader
• vue-style-loader
• css-loader

$ npm i -D vue-template-compiler vue-loader vue-style-loader css-loader

만약 CSS Preprocessor Sass(SCSS)를 사용하려면 다음 모듈을 추가로 설치합니다.
sass-loader는 8버전의 호환성 모듈(Peer Dependency) 이슈로 7버전을 설치합니다.

• node-sass
• sass-loader

$ npm i -D node-sass sass-loader@^7

.vue 파일 내에서 다음과 같이 사용할 수 있습니다.

<style lang="scss"></style>
<!-- or -->
<style lang="sass"></style>

ESLint

'ESLint'는 코드 품질과 코딩 스타일 문제를 식별하기 위한 정적 코드 분석 도구입니다.
eslint는 6버전의 호환성 모듈(Peer Dependency) 이슈로 5버전을 설치합니다.

npm i -D eslint@^5 babel-eslint eslint-config-standard@^12 eslint-plugin-import eslint-plugin-node eslint-plugin-promise eslint-plugin-standard eslint-plugin-vue

.eslintrc.js 파일을 생성하고 다음 옵션을 추가합니다.
코드 규칙을 검사하기 위한 옵션을 제공합니다.

module.exports = {
  root: true,
  parserOptions: {
    parser: 'babel-eslint',
    ecmaVersion: 2015,
    sourceType: 'module'
  },
  env: {
    browser: true,
    node: true
  },
  extends: [
    // https://github.com/standard/eslint-config-standard
    'standard',
    // https://eslint.vuejs.org/rules/
    // 'plugin:vue/base'
    'plugin:vue/essential'
    // 'plugin:vue/strongly-recommended'
    // 'plugin:vue/recommended'
  ],
  plugins: [
    'vue'
  ],
  rules: {
    // 예외 규칙을 추가할 수 있습니다
    'vue/html-self-closing': ['error', {
      'html': {
        'void': 'always',
        'normal': 'always',
        'component': 'always'
      },
      'svg': 'always',
      'math': 'always'
    }]
  }
}

.eslintignore 파일을 생성하고 다음 내용을 추가합니다.
코드 규칙을 검사할 때 무시할 파일이나 디렉터리를 지정합니다.

node_modules/
dist/
assets/

일부 'ESLint' 규칙을 비활성화해야 하는 경우 'rules' 옵션 대신 다음과 같이 작성할 수 있습니다.
자세한 사용법은 Disabling Rules with Inline Comments에서 확인할 수 있습니다.

// eslint-disable-next-line
if (true) console.log("ESLint");

기타 설치

최초 실행될 index.html을 사용하기 위해 html-webpack-plugin을 설치합니다.

$ npm i -D html-webpack-plugin

파비콘(Favicon)을 배포용으로 복사하기 위해 copy-webpack-plugin을 설치합니다.

$ npm i -D copy-webpack-plugin

clean-webpack-plugin를 사용해 빌드(build)시 발생할 수 있는 충돌을 최소화하기 위해 output.path에 설정된 디렉터리 내 기존 모든 파일 삭제합니다.

$ npm i -D clean-webpack-plugin

Autoprefixer(PostCSS)

CSS에 자동으로 공급 업체 접두사(Vendor prefix)를 적용하기 위해 autoprefixer를 설치합니다.

$ npm i -D postcss-loader autoprefixer

postcss.config.js 파일을 생성하고 다음과 같이 autoprefixer 모듈을 플러그인으로 지정합니다.

module.exports = {
  plugins: [
    require('autoprefixer')
  ]
}

package.json 파일에 다음 옵션을 추가해 대상 브라우저를 설정합니다.
설정에 대한 자세한 내용은 Browserslist에서 확인할 수 있습니다.

{
  "browserslist": [
    "last 2 versions",
    "ie >= 10"
  ]
}

package.json

• npm run dev: 개발용 서버를 실행합니다.
• npm run build: 배포용 파일을 빌드할 수 있습니다.
• npm run lint: 코드 규칙을 검사합니다.
• npm run lint:fix: 코드 규칙을 검사하고 수정합니다.

{
  "scripts": {
    "dev": "webpack-dev-server --mode development",
    "build": "webpack --mode production",
    "lint": "eslint --ext .js,.vue .",
    "lint:fix": "eslint --fix --ext .js,.vue ."
  }
}

.gitignore

버전 관리 시 필요하지 않은 파일이나 디렉터리를 지정할 수 있습니다.

# 기본 디렉터리 혹은 파일
.DS_Store
node_modules
/dist

# 로컬 환경변수 파일
.env.local
.env.*.local

# 로그 파일
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# 에디터 디렉터리 혹은 파일들
.idea
.vscode
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?

Modules

개발에 필요한 각 모듈의 간단한 사용법을 정리합니다.

Lowdb

https://github.com/typicode/lowdb

JSON 형식으로 데이터를 저장하는 심플한 DB(데이터베이스)입니다.
사용자 환경의 LocalStorage를 DB로 구성하기 위해 사용합니다.
기본적으로 제공되는 몇 가지 API를 제외하면, 대부분 Lodash API를 사용할 수 있습니다.

import low from 'lowdb'
import LocalStorage from 'lowdb/adapters/LocalStorage'

const adapter = new LocalStorage(DB_NAME)
const db = low(adapter)

// Lodash API를 사용하기 때문에(Lodash chain), A, B, C는 모두 같은 결과를 가집니다.
const A = db.get('todos').value()
const B = _.get(this.db.value(), 'todos')
const C = db.getState().todos // `getState()` is Lowdb API

// Lodash `get` - https://lodash.com/docs/4.17.15#get
// Lodash `value` - https://lodash.com/docs/4.17.15#prototype-value

Crypto random string

https://github.com/sindresorhus/crypto-random-string

todo 객체에서 ID로 사용할 고유한 랜덤 문자열을 생성합니다.

import cryptoRandomString from 'crypto-random-string'

cryptoRandomString({ length: 10 })
// E.g. '2cf05d94db'

Lodash

https://lodash.com/

다양한 유틸리티 기능을 제공 하는 자바스크립트 라이브러리입니다.
필요하지 않은 기능을 추후 번들에 포함하지 않기 위해서 다음과 같이 개별적으로 가져와 사용합니다.

import _find from 'lodash/find'
import _findIndex from 'lodash/findIndex'
import _assign from 'lodash/assign'
import _cloneDeep from 'lodash/cloneDeep'
import _forEachRight from 'lodash/forEachRight'

Dayjs

https://github.com/iamkun/dayjs

날짜 및 시간을 분석, 유효성 검사, 표시 등의 기능을 제공하는 경량화된 자바스크립트 라이브러리입니다.
Momentjs를 사용하는 경우 사용 방법은 매우 쉽습니다.

dayjs().format('YYYY년 MM월 DD일')

Chapter 2

스타일을 적용하고, 그에 따라 일부 구조를 변경합니다.

Reset.css

브라우저의 기본 스타일을 초기화합니다.

<link href="https://cdnjs.cloudflare.com/ajax/libs/meyer-reset/2.0/reset.min.css" rel="stylesheet">

Google Material Icons

Google Material Design에서 제공하는 무료 아이콘을 사용합니다.

Google Material Icons(머티리얼 아이콘)은 일반적인 동작과 아이템을 위한 유쾌하고 아름답게 제작된 심볼입니다.
Apache license version 2.0.

<link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">

<i class="material-icons">done</i>
<i class="material-icons">close</i>

Google Fonts

사용할 폰트를 정의합니다.

<link href="https://fonts.googleapis.com/css?family=Noto+Sans+KR:400,700&display=swap&subset=korean" rel="stylesheet">

Default styles

scss/_style.scss을 생성하고 완성된 스타일 내용을 사용해 다음과 같이 TodoApp.vue에 적용합니다.

<!-- TodoApp.vue -->

<template>...</template>
<script>...</script>
<style lang="scss">
  @import "../scss/style";
</style>

Chapter 3

https://router.vuejs.org/kr/

SPA 라우터 구성을 위해 Vue Router를 사용합니다.

$ npm i vue-router

Chapter 4

https://vuex.vuejs.org/kr/

상태 관리 패턴(Store)을 사용하기 위해 Vuex를 설치합니다.

$ npm i vuex

Chapter 5

https://www.netlify.com/

웹 사이트 호스팅을 위해 Netlify를 사용합니다.
회원가입 후 무료로 사용할 수 있습니다.