Typos
는 Typography의 어원인 "Type"와 "-술"을 의미하는 접미사 graphy의 합성어에서 그리스어의 두 단어 τύπος(typos
, 표시)와 γράφω(grapho, 쓰다)중에서 첫 단어인 typos에서 따온 이름입니다. 사용자가 직접 타이핑하는 효과를 보다 쉽게 구현하기 위해 제작되었습니다. 독특하고, 다양한 효과를 구상하고 있습니다.
v0.1.0
음소
-> 음절
[조합], 음절
-> 음소
[분해] 하며, 한글을 입력할 때 나타나는 자모의 조합 효과를 그대로 재현합니다.
npm install typoz
pnpm add typoz
<script src="https://www.unpkg.com/typoz@0.1.0/umd/typoz.min.js"></script>
import Typoz from 'typoz';
// or import { Typoz } from 'typoz';
const typoz = new Typoz();
typoz.initialize();
typoz.globalConfig(/* custom configs */);
기본적으로 제공되는 typoz
의 기능은 크게 세 가지입니다.
- 지정된 클래스명(.typoz)를 탐색하고 자동 렌더링
- 특정
id
또는class
값으로 지정하여 렌더링 - 빌더를 이용한 세부적인 타이핑 제어
<!-- 기본적으로 클래스명 typoz를 탐색하고 자동 실행합니다. -->
<div class="typoz">테스트 내용 타이핑 효과.</div>
import Typoz from 'typoz';
const typoz = new Typoz();
typoz.initialize();
typoz.globalConfig();
<!-- 기본적으로 클래스명 typoz를 탐색하고 자동 실행합니다. -->
<div class="typoz">테스트 내용 타이핑 효과.</div>
import Typoz from 'typoz';
const typoz = new Typoz();
typoz.initialize();
typoz.globalConfig({
autoRender: false,
});
typoz.render();
원하는 타이핑을 추가로 작성하고 개별/전역 설정을 할 수 있습니다.
import Typoz from 'typoz';
const typoz = new Typoz();
typoz.initialize();
typoz.globalConfig({
speed: { write: 1 },
nodes: [
{
select: '#target1',
words: ['또 다른 텍스트 입력'],
config: {
speed: { write: 5 },
},
},
],
});
원하는 타이핑을 추가로 작성하고 개별/전역 설정을 할 수 있습니다.
import Typoz from 'typoz';
const typoz = new Typoz();
typoz.initialize();
typoz.globalConfig({
autoRender: false,
speed: { write: 1 },
});
const myElements = document.querySelectorAll('.test');
typoz.render(myElements);
// or
const myElement = document.querySelector('.test');
typoz.render([myElement]);
빌더를 이용해 원하는 타이핑 효과를 제어할 수 있습니다. 빌더는 TypeNode
를 렌더링하는 방식과 달리 개별 단위로 실행합니다. 메서드 행위는 아래와 같습니다.
- createBuilder(): 빌더 인스턴스를 얻습니다.
- node(): (deprecated) 빌더 인스턴스를 얻습니다. (since v0.1.0)
- select(idOrClass: string): 타겟을 지정합니다.
- conf(config: Options): Typoz의 config와 동일한 포멧입니다.
- write(word: string): 현재 커서에서 한글, 영문, 숫자 등 모든 문자를 단일 또는 문자열을 입력합니다.
- move(value: number): value값 만큼 커서를 이동합니다.
- pause(value: number): value값 만큼 휴식합니다.
- erase(): 현재 커서에서 글자를 지웁니다.
- run(): 지정한 흐름으로 한 번 실행한 후 완료 시 멈춥니다.
- forever(skipErase: boolean = false): 지정한 흐름으로 무한 실행합니다. skipErase는 기본 false 값이며, true일 시 지우기 모션 없이 실행됩니다.
- pauseRender(): 렌더링을 일시정지합니다. (✨ since v0.1.0)
- resumeRender(): 렌더링을 재개합니다. (✨ since v0.1.0)
const typoz = new Typoz();
typoz
.createBuilder()
.select('#test')
// .conf(/* custom configs */) // deprecated
.config(/* custom configs */)
.write('Write the entire text')
.write(' ')
.write('r')
.move(-1)
.write('o')
.move(2)
.write(' ')
.write('type each character individually.')
.pause(1)
.write('지울내용')
.erase()
.erase()
.erase()
.erase()
.pause(1)
.write('여러 문자 등 작성 가능합니다.')
.run();
지우기 모션이 포함된 무한 루프 실행 예시입니다.
const typoz = new Typoz();
typoz
.createBuilder()
.select('#test')
// .conf(/* custom configs */) // deprecated
.config(/* custom configs */)
.write('Write the entire text')
.forever();
지우기 모션이 제거된 무한 루프 실행 예시입니다.
const typoz = new Typoz();
typoz
.createBuilder()
.select('#test')
// .conf(/* custom configs */) // deprecated
.config(/* custom configs */)
.write('여러 문자 등 작성 가능합니다.')
.forever(true);
devkimson |
---|