기본 콘텐츠로 건너뛰기

history 객체를 사용한 client router 구현

지난 Meteor Meetup에서 iron-router를 써야하냐 말아야하냐에 대한 논의가 있었는데
MDG(Meteor Development Group)에서 딱히 router에 대한 명확한 입장이 없어
SPA(Single Page Application)에서 클라이언트쪽 라우터에 대해 정리해 보려고 한다.
전반적인 내용은 여기에 -> http://html5.clearboth.org/history.html

기존의 Web과 다르게 SPA에선 화면간 이동시 전체 화면을 다시 그리지 않는다.
그래서 기존 독립 실행 어플리케이션(데스크톱 프로그램/모바일 앱 등)처럼 부드럽고 빠른 기능 전환이 가능한데 대신 기존의 뒤로 가기 버튼을 무심코 눌렀을 때 해당 어플리케이션에서 이탈하곤 한다.

그래서 실제로 URL이동을 하지 않아도 기능상 다른 화면으로 이동하였을 경우 임의로 URL을 생성하여 history 객체에 넣는 방식으로 구현한다.
전체적인 그림은 아래와 같은데

단순한 전략이다. push 와 pop.
이동이 일어나는 시점에 history.pushState( <state>, "<title>", "<url>"); 로 쌓아두고 뒤로 가기/앞으로 가기를 브라우저에서 실행할 경우 popstate 이벤트를 처리하면 된다.
window.addEventListener("popstate", function (event) {
  // event.state 를 참조
  // 이 시점은 이미 pop을 완료한 상태이므로 location을 살펴보면 이미 이동한 경로를 가져온다.
});
여기에서 잠시 주목할 것은 popstate는 가장 마지막에 pushState 상태를 가져오는데 최초 페이지 로딩 후 History 객체를 보면
> history
  length: 1
  state: null
}
이와 같이 length는 1이고 state가 null인것을 볼 수 있다.
우리는 원하는 곳으로 보내야하기 때문에 이 부분을 바꿔줘야한다.
미리 pushState를 해놓으면 불필요한 history가 생기므로 같은 문법이지만 history를 생성하지 않는 replaceState( <state>, "<title>", "<url>"); 로 대치해준다.

요약하면 이렇다.

  1. 최초 진입시 URL과 상태를 history.replaceState 로 초기화한다.
  2. 화면 이동시 history.pushState 로 이력을 저장한다.
  3. back/forward 시 popstate 이벤트를 받아서 화면 이동을 구현한다.
여기까지는 사실 쉽다.
나머지는 URL Parsing 부분인데
이쪽에 구현해 놓았다.

가상 경로명을 Session에 넣어서 다루었다.

router.routes = {
  "home": /^\/$/,
  "view": /^\/view\/([^/]*)$/,
};
라우터는 이렇게 만들어 놓고 location.pathname 을 정규식으로 매칭해서 같은 패턴이면 template이름을 key로 사용하게 하였다.
만일 매치에 실패하면 router.notfound 를 사용하도록 하고 정의해주도록 하면 좋다.

Template 구조는 이렇게 구성했다.
홈에서 두 개의 하위 링크로 이동을 구성하는 아주 단순한 구조로

초기화면
Home
A
B
View
A
home

이렇게 진행한다.
라우터를 담당할 템플릿에서 어떤 템플릿을 사용할지는 동적으로 결정해야하므로
{{> UI.dynamic template=getRoute}}
를 사용한다.
getRoute에 표현할 template이름을 helper로 넣으면 된다.
실제로 경로를 이동하는 이벤트가 발생하는 곳에서 preventDefault로 이동을 막고 Session.set('pathname', location.pathname') 하고 pushState를 하면 끝.




*. Meteor 에서 Subscribe 연동 (2회차로?) (https://www.discovermeteor.com/blog/template-level-subscriptions/)

Template 별 subscribe 관리는
onCreated 에  
  this.subscribe("postsView", Session.get("params"));

로 지정하면 onDestoryed 시점에 알아서 정리한다.

Template 안에서는 subscribe완료 여부는

{{#if Template.subscriptionsReady}}
{{/if}}

이렇게 체크 가능.
helpers나 events에서Template.instance().subscriptionsReady() 를 사용하면 Reactive로 사용할 수 있어서 완전 꿀.

이 블로그의 인기 게시물

vulcanJS - 10. Posts Update/Delete

마지막으로 수정과 삭제를 구현해보면 목록 조회(List), 상세 조회, 쓰기, 수정, 삭제까지 모든 필요한 요소를 아우를 수 있을 것이다.
감이 좋은 분들은 눈치 챘을지도 모르겠지만 사실 수정이란 건 UI면에서 볼때 이미 양식이 채워져있는 신규 쓰기와 별반 다르지 않다.

먼저 해야할 것은 역시나 Component를 만드는 일이다.
$ vulcan g component
? Package name spectrum-simplebb
? Component name PostsEditComponent
? Component type Class Component
? Register component Yes
   create packages/spectrum-simplebb/lib/components/PostsEditComponent.jsx
 conflict packages/spectrum-simplebb/lib/components/index.js
? Overwrite packages/spectrum-simplebb/lib/components/index.js? overwrite
    force packages/spectrum-simplebb/lib/components/index.js PostsEditComponent를 만들었다.
route도 만들자. /posts/edit/:id 이렇게 경로를 만들면 좋겠다. 그러고보니 이전 글에서 만든 상세보기도 /posts/view/:id 형식으로 만들껄 그랬다.
$ vulcan g route
? Package name spectrum-simplebb
? Route name postsEdit
? Route path /posts/edit/:_id
? Component name PostsEditComponent
? Layout name
 conflict packages/spectrum-simplebb/lib/modules/routes.js
? Overwrite packages/spectrum-simplebb/lib/modules/routes.js? overwrite
   …

VulcanJS 특징 번역

VulcanJS 특징http://docs.vulcanjs.org/features.html 의 내용입니다. GraphQL 스키마 생성 Vulcan은 SimpleSchema JSON 스키마를 기반으로 컬렉션의 GraphQL 스키마를 자동으로 생성합니다.
이렇게하면 두 가지 형식으로 스키마를 두 번 지정할 필요가 없습니다. 이 기능은 완전히 선택적이며 필요에 따라 수동으로 스키마를 지정할 수도 있습니다.

자동 생성 폼 Vulcan은 스키마를 사용하여 클라이언트 측 폼을 생성하고 적절한 Apollo Mutation을 통해 제출을 처리합니다.
예를 들어 하나의 동영상을 편집하기위한 양식을 표시하는 방법은 다음과 같습니다.
<VulcanForm
  collection={Movies}
  documentId={props.documentId}
  queryName="moviesListQuery"
  showRemove={true}
/> queryName 옵션은 작업이 완료되면 자동으로 업데이트되는 쿼리를 VulcanForm에 통지하는 한편, showRemove 옵션은 "Delete Movie' 버튼을 폼에 추가합니다.
VulcanForm 클라이언트 저장소에 아직 로드되지 않은 경우 수정할 문서를 읽어오기도 합니다.

쉬운 데이터 적재 Vulcan에는 Apollo 데이터를 쉽게 로드할 수 있도록 데이터 로딩 헬퍼 세트로 withList (복수 문서용)와 withDocument (단일 문서용)를 제공합니다.
예를 들어, withList를 사용하여 MoviesList 구성 요소에 모든 동영상을 포함하는 결과를 prop에 전달하는 방법은 다음과 같습니다.
const listOptions = {
  collection: Movies,
  queryName: 'moviesListQuery',
  fragment: fragment,
};
export default withList(listOptions)(MoviesList); …

vulcanJS - 1. vulcan-cli 설치하고 프로젝트 만들기

vulcanJS를 학습하면서 알아낸 점을 기록하는 의미의 튜토리얼을 써본다.

Telescope도 그랬지만 forum 형태의 예제에서 embedly를 사용하는 URL 요소가 글에 들어가는 점이나 일반인들에게는 익숙하지 않은 Markdown 문법 등을 걷어내고 최소형태에서부터 접근해야할 필요성을 느껴서 단순 post만 목록 열람하고 읽고 쓰는 구현을 해보기로 했다.

먼저, vulcanJS를 github를 통해 clone 하고 meteor create --package를 통해 만들수도 있지만 Vulcan-Cli(https://github.com/VulcanJS/vulcanjs-cli)가 있어서 이걸 일단 사용해보기로 한다.

대충 내용을 읽어보니 Rails 생각이 나기도 하고 재밌어 보인다.
npm install -g vulcanjs-cli 혹은 meteor 에서만 한다면
meteor npm install -g vulcanjs-cli 이런 식으로 설치하고 쓰면 된다.
npm 에 global로 설치한 첫번째 경우 기준으로 진행해보겠다.
설치하고 난 뒤 vulcan 을 실행해보면
$ vulcan
vulcan usage:
Synopsis
  vulcan <action> <object> <...>
    <action>   Operation to perform
    <object>   Asset type (contextual to action)
    <...>      Parameters. If not provided, interactively entered
Project initialisation
  vulcan create <appName>
  vulcan init <appName>
Assets creation
  vulcan (generate|g) package <packageName>
  vulcan (generate|g) model <packageName>…