시작하기
이 명확하고 종합적인 튜토리얼은 페이지에 완전한 기능의 Kanban을 구현하기 위해 거쳐야 할 단계들을 안내합니다.
1단계. 소스 파일 포함하기
먼저 index.html이라는 HTML 파일을 생성하세요. 그런 다음 생성한 파일에 Kanban 소스 파일을 포함합니다.
필수 파일은 두 가지입니다:
- Kanban의 JS 파일
- Kanban의 CSS 파일
<!DOCTYPE html>
<html>
<head>
<title>How to Start with Kanban</title>
<script src="./dist/kanban.js"></script>
<link href="./dist/kanban.css" rel="stylesheet">
</head>
<body>
<script>
// your code will be here
</script>
</body>
</html>
npm 또는 yarn을 통한 Kanban 설치
yarn 또는 npm 패키지 관리자를 사용하여 JavaScript Kanban을 프로젝트에 가져올 수 있습니다.
npm 또는 yarn을 통한 평가판 Kanban 설치
Kanban의 평가판을 사용하려면 trial Kanban package를 다운로드하고 README 파일에 안내된 단 계를 따르세요. 평가판 Kanban은 30일 동안만 사용 가능합니다.
npm 또는 yarn을 통한 PRO Kanban 설치
Client's Area에서 npm용 로그인과 비밀번호를 생성하여 DHTMLX의 프라이빗 npm에 직접 접근할 수 있습니다. 자세한 설치 가이드도 그곳에서 확인할 수 있습니다. 프라이빗 npm 접근은 Kanban 라이선스가 활성화된 기간 동안만 제공됩니다.
2단계. Kanban 생성하기
이제 페이지에 Kanban을 추가할 준비가 되었습니다. 먼저 Kanban과 Toolbar를 위한 DIV 컨테이너를 만듭니다. 다음 단계를 따라주세요:
- index.html 파일에 두 개의 DIV 컨테이너를 지정합니다.
- kanban.Kanban 및 kanban.Toolbar 생성자를 사용해 Kanban과 Toolbar를 초기화합니다.
Toolbar는 Kanban 인터페이스의 선택적 요소입니다. Toolbar 없이 Kanban을 만들고 싶다면, 단 하나의 DIV 컨테이너만 지정하고 kanban.Kanban 생성자를 통해 위젯을 초기화하면 됩니다.
생성자는 Kanban과 Toolbar가 배치될 HTML 컨테이너의 ID와 관련 설정 객체를 매개변수로 받습니다.
<!DOCTYPE html>
<html>
<head>
<title>How to Start with Kanban</title>
<script src="./dist/kanban.js"></script>
<link href="./dist/kanban.css" rel="stylesheet">
</head>
<body>
<div id="toolbar"></div>
<div id="root"></div>
<script>
const board = new kanban.Kanban("#root", {
// configuration properties
});
new kanban.Toolbar("#toolbar", {
// configuration properties
});
</script>
</body>
</html>
3단계. Kanban 설정하기
이제 Kanban 컴포넌트가 초기화될 때 적용할 설정 속성을 지정할 수 있습니다.
Kanban을 사용하려면 먼저 cards와 columns(그리고 rows)에 대한 초기 데이터를 제공해야 합니다. 초기 데이터 외에도 cards, editor, toolbar의 외관을 설정할 수 있습니다.
const board = new kanban.Kanban("#root", {
cards,
columns,
rows,
rowKey: "row",
cardShape,
editorShape
});
new kanban.Toolbar("#toolbar", {
api: board.api,
items: [
"search",
"spacer",
"sort",
"addColumn",
"addRow"
]
});
다음 단계
이제 끝입니다. 세 단계만 거치면 시각적으로 워크플로우를 관리할 수 있는 편리한 도구를 갖추게 됩니다. 이제 작업을 시작하거나 JavaScript Kanban의 다양한 기능을 더 탐색해 볼 수 있습니다.