javascript/jquery

jQuery Template

jeeyong 2012. 2. 21. 11:46
출처:  http://igna.tistory.com/21 

요전에 프로젝트 할 당시에 이런식의 코드를 많이 작성했더랬는데 많은 귀찮음이 따르는 작업이었다.
 
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
function displayItems( list )
{
    var i;
    var n = list.length;
    var table = $("#sampleTable");
 
    for( i = 0; i < n; i++ )
    {
        var html = table.html();
        html += '<tr>';
        html += '<td>';
        html += '<img src="'+ list[i].image + '" height="150" />';
        html += '</td>';
        html += '<td>';
        html += list[i].title;
        html += '</td>';
        html += '<td>';
        html += list[i].width + ' * ' + list[i].height;
        html += '</td>';
        html += '</tr>';
         
        table.html( html );
    }

저번 crossdomain 이슈를 해결한 소스에 위와 같은 코드를 넣어서 아래와 같은 화면을 만들었다.
(검색어는 '아이유')


 뭐 간간히 깨진 이미지도 있지만 뭐 링크가 깨졌으니 어쩔 수 없을듯. (그래도 아이유는 이쁘다) 지금 그게 중요한게 아니라 이런 단순히 Table에 게시판처럼 쭉 나열하는 코드를 넣었는데 영 보기도 힘들고 영 만들기도 힘들다. 게다가 코드가 맘에 안들게 지저분해진다. Flex의 ItemRenderer 같이 깔끔하게 들어가게할 방법이 없을까.. 라고 생각하고 있다면 jQuery Template 를 추천한다.

우연찮은 기회에 알게된 jQuery Template는  Flex의 ItemRenderer같이 Template을 만들어두면 자동으로 채워준다. 짧은 말로 설명하긴 어려우니까 일단 기반 지식부터 차근이 알아가자.

참고로 이야기하자면 jQuery Template는 아직 Beta버젼으로 Microsoft에서 만들어준 plug-in 이다. 소문에는 차기에 나올 jQuery에는 jQuery Template가 포함될거라는 소문도 있으나 아직은 사실 무근이며 이런 소문이 도는 까닭은 이 jQuery Template라는게 너무 잘만들어져서가 아닐까 생각된다. 어쨌든 여기저기 검색하다 보면 jQuery 홈페이지에 jQuery Template를 소개하는 페이지가 있다.(http://api.jquery.com/jQuery.template/)


 일단 jQuery Template은 plug-in이므로 jQuery.template.js 파일을 다운로드 받아야한다. jQuery Template을 소개하는 그 페이지를 잘 살펴보면 받아올 수 있는 링크를 찾을 수 있지만 영어 울렁증 및 숨은그림찾기에 능하지 않은 사람들을 위해 링크를 제공합니다.(https://github.com/jquery/jquery-tmpl)

링크를 따라가도 영어천지고 다운로드 버튼을 찾을 수 없는 분들을 위해 그림으로 설명을 이어가겠다.


 저기서 "Download.zip"을 클릭하면 다운로드 받을 수 있다. tar.gz 파일이 좋다면 그걸 받아도 된다. 뭘 받든 상관없지만 아무래도 zip이 통상 많이 쓰이는 거니 저걸 받도록 하자. 압축을 풀면 요상한것들 많은데 일단 우리에게 당장 필요한건 jquery.tmpl.js 파일이다. 간혹 파일 뒤에 "min"이라고 이름이 다른건 뭐냐고 물어보시는 분들 계시는데 그냥 jquery.tmpl.js 파일의 필요없는 공백, 변수명등등을 축약해서 파일크기를 줄여놓은거다. 그냥 jquery.tmpl.js랑 동작하는 내용은 같으니 뭘 쓰든 상관없다.



그리고 HTML코드를 이렇게 작성한다. jQuery Template은 Plug-in 이므로 jQuery를 추가한 뒤에 jQuery Template을 추가시킨다.


?
1
2
<script type="text/javascript" language="javascript" src="js/jquery1.6.js"></script>
<script type="text/javascript" language="javascript" src="js/jquery.tmpl.js"></script>

이렇게 하면 기본적으로 준비는 마쳐졌고 jQuery 홈페이지의 jQuery Template의 소개페이지에선 뭔가 javascript로만 템플릿을 만들어 처리하는 방법을 소개해놓았는데 그 방법은 다음과 같다.

template라는 명령어에 템플릿의 이름과 템플릿을 String 값으로 등록을 한다. 그 이후에 tmpl() 이라는 메서드를 이용해 화면에 렌더링하면 된다. 어떻게 하면 되는 예제를 보면서 따라해보자.
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
var movies = [
  { Name: "The Red Violin", ReleaseYear: "1998", Director: "François Girard" },
  { Name: "Eyes Wide Shut", ReleaseYear: "1999", Director: "Stanley Kubrick" },
  { Name: "The Inheritance", ReleaseYear: "1976", Director: "Mauro Bolognini" }
  ];
 
$.template(
  "detailTemplate",
  "<tr>" +
  "<td colspan='2'>${Name}</td>" +
  "<td>Released: ${ReleaseYear}</td>" +
  "<td>Director: ${Director}</td>" +
  "</tr>"
);
 
$.tmpl( "movieTemplate", movies ).appendTo( "#movieList" );

일단 JSON 형태의 Array데이터가 있고 템플릿을 등록해준 다음에 $.tmpl 메서드를 이용해 화면에 넣어준다는 이야기. 보기엔 쉬워 보이지만 템플릿을 등록하는데에는 영 맘에 안든다. 좀 더 편하게 이용할 방법은 없을까 하고 고민하고 검색을 해봤더니 javascript가 아니라 HTML로 템플릿을 적용하는 예가 나와있었다.(링크: http://blog.outsider.ne.kr/532 - Outsider님의 블로그 )

이 블로그의 설명을 들어보아하니 jQuery팀은 이미 이런것과 같은 맥락으로 Templating, Data Linking, Globalization과 같은 공식 플러그인을 발표했다고 한다;; 그것도 작년 10월에.. 크흐.. 이렇게 시대에 뒤떨어져서야.. 쓰겠냐마는.. 일단 Data Linking 같은건 나중에 다시 이야기 하고 어서 Template를 보다 편리하게 쓰는 방법을 이야기 하면 아래와 같은 방법으로도 사용이 가능하다고 한다.


HTML영역에 아래와 같이 HTML 스크립트를 작성한다.
?
1
2
3
4
5
6
7
<script id="detailTemplate" type="text/x-jquery-tmpl">
<tr>
   <td colspan='2'>${Name}</td>
   <td>Released: ${ReleaseYear}</td>
   <td>Director: ${Director}</td>
</tr>
</script>


그리고 Javascript에서는 아래와 같이 코딩한다. 
?
1
2
3
4
5
6
7
var movies = [
  { Name: "The Red Violin", ReleaseYear: "1998", Director: "François Girard" },
  { Name: "Eyes Wide Shut", ReleaseYear: "1999", Director: "Stanley Kubrick" },
  { Name: "The Inheritance", ReleaseYear: "1976", Director: "Mauro Bolognini" }
  ];
 
$.tmpl( "movieTemplate", movies ).appendTo( "#movieList" );

아까 작성한 코드와 비슷하지만 적어도 이 방법은 javascript로 문자열로 작성된것이 아니라 HTML코드로 작성되어 작성하는 것도, 편집하는 것도 수월해 졌다.

일단 jQuery Template 사용하는 방법은 여기까지. 다음 시간엔 crossdomain을 해결해 아이유 이미지들을 불러온 소스에 접목시켜 보도록하자.