Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SDuck4/type-hangul
⌨️ 한글 타이핑 효과 라이브러리
https://github.com/SDuck4/type-hangul
hangul javascript korean typing
Last synced: about 1 month ago
JSON representation
⌨️ 한글 타이핑 효과 라이브러리
- Host: GitHub
- URL: https://github.com/SDuck4/type-hangul
- Owner: SDuck4
- License: mit
- Created: 2020-06-15T05:11:57.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-07-18T22:37:24.000Z (over 1 year ago)
- Last Synced: 2024-11-06T14:54:08.522Z (about 2 months ago)
- Topics: hangul, javascript, korean, typing
- Language: JavaScript
- Homepage: https://sduck4.github.io/type-hangul/
- Size: 1.93 MB
- Stars: 87
- Watchers: 1
- Forks: 5
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - type-hangul
- awesome-hangul - type-hangul - 한글 타이핑 효과 라이브러리 (Programming Languages / JavaScript)
README
# type-hangul
⌨️ 한글 타이핑 효과 라이브러리
https://sduck4.github.io/type-hangul/
## 개요
> 윤동주, *서시*
한글 두벌식 자판에서 한 글자씩 타이핑되는 과정을 보여줄 수 있는 라이브러리입니다.
## 설치
### CDN
한글 자모음 처리에 [Hangul-js](https://github.com/e-/Hangul.js)를 사용하고 있습니다.
**Hangul-js**와 **type-hangul**을 따로 로드하려면 아래 코드를 사용하세요.
```html
```
**Hangul-js**를 번들링한 **type-hangul**을 로드하려면 아래 코드를 사용하세요.
```html
```
### 직접 다운로드
[GitHub Releases](https://github.com/SDuck4/type-hangul/releases)에서 최신 릴리즈를 직접 다운로드 받아 사용하실 수 있습니다.
## 사용법
```html
안녕하세요.
TypeHangul.type('#target');
```
### `TypeHangul.type(selector [, options])`
- `selector`: 타이핑 효과를 출력할 DOM의 CSS Selector, 필수
- `options`: 효과 옵션, 생략 가능
## 옵션
### `text`
- 타입: `string`
- 기본값: `null`
출력할 텍스트를 설정합니다. 설정하지 않을 경우, `selector`로 선택한 DOM의 텍스트를 출력합니다.
### `append`
- 타입: `boolean`
- 기본값: `false`
기존 텍스트 뒤에 이어서 출력할 지 여부를 설정합니다. `true`로 설정할 경우, `selector`로 선택한 DOM의 텍스트 뒤에 이어서 출력합니다.
### `intervalType`
- 타입: `number`
- 기본값: `120`
타이핑 사이 시간 간격을 설정합니다.
### `humanize`
- 타입: `number|function`
- 기본값: `null`
실제 사람이 타이핑하는 것처럼 매 타이핑 마다 `intervalType`를 랜덤화합니다.
`number`을 설정할 경우, 해당 비율만큼 `intervalType`을 랜덤화합니다. 예를 들어, 다음과 같은 옵션인 경우
```js
{
intervalType: 100,
humanize: 0.5,
}
```
`intervalType`은 원래 값의 0.5배인 `50`부터 1.5배인 `150` 사이의 랜덤한 값으로 설정됩니다.
`function`을 설정한 경우, 해당 함수를 사용해 `intervalType`을 랜덤화합니다. 함수의 첫 번째 매개변수로 `intervalType` 값이 주어집니다.
## 이벤트
타이핑 진행 과정에 따라 `selector`로 선택된 DOM에 이벤트([CustomEvent](https://developer.mozilla.org/ko/docs/Web/API/CustomEvent))를 발생시킵니다. 이벤트 리스너의 첫 번째 매개변수 `e`의 `detail`로 이벤트 데이터를 전달합니다.
```html
타이핑
var $target = document.querySelector('#target');
$target.addEventListener('th.afterType', function (e) {
console.log(e.detail.progress);
});
TypeHangul.type('#target');
```
```
ㅌ
타
탕
타이
타잎
타이피
타이핑
```
### `th.startType`
- `target`: 타이핑 효과 대상 DOM
- `options`: `type()` 호출 시 옵션과 기본 옵션을 합친 객체
타이핑을 시작할 때 발생합니다.
> `th.startType` 이벤트는 `type()` 호출 직후에 이벤트가 발생합니다. 이벤트 리스너가 정상적으로 동작하기 위해서는 `type()` 호출 이전에 리스너를 추가하세요.
### `th.endType`
- `target`: 타이핑 효과 대상 DOM
- `options`: `type()` 호출 시 옵션과 기본 옵션을 합친 객체
타이핑을 종료할 때 발생합니다.
### `th.beforeType`
- `target`: 타이핑 효과 대상 DOM
- `options`: `type()` 호출 시 옵션과 기본 옵션을 합친 객체
- `progress`: 현재까지 출력한 타이핑 텍스트
- `typeChar`: 이번에 타이핑할 문자
매번 타이핑 이전에 발생합니다.
### `th.afterType`
- `target`: 타이핑 효과 대상 DOM
- `options`: `type()` 호출 시 옵션과 기본 옵션을 합친 객체
- `progress`: 현재까지 출력한 타이핑 텍스트
- `typeChar`: 이번에 타이핑한 문자
매번 타이핑 이후에 발생합니다.
## License
[MIT](https://github.com/SDuck4/type-hangul/blob/master/LICENSE)