-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #14 from jason89521/pnpm-workspace
- Loading branch information
Showing
47 changed files
with
393 additions
and
524 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
git-checks=false |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,193 +1,3 @@ | ||
# React Typist Component | ||
# React Components Monorepo | ||
|
||
Create typewriter effect by setting up a component's children directly. | ||
|
||
## Install | ||
|
||
```bash | ||
npm install react-typist-component | ||
# or | ||
yarn add react-typist-component | ||
``` | ||
|
||
## Example | ||
|
||
```jsx | ||
import Typist from 'react-typist-component'; | ||
|
||
const MyComponent = () => { | ||
return ( | ||
<Typist typingDelay={100} cursor={<span className='cursor'>|</span>}> | ||
This is a typo | ||
<br /> | ||
<Typist.Backspace count={5} /> | ||
<Typist.Delay ms={1500} /> | ||
react component | ||
<Typist.Paste> | ||
<div> | ||
use | ||
<div>deeper div</div> | ||
</div> | ||
</Typist.Paste> | ||
</Typist> | ||
); | ||
}; | ||
``` | ||
|
||
## API reference | ||
|
||
### `Typist` | ||
|
||
```ts | ||
export type Delay = number | (() => number); | ||
export type Splitter = (str: string) => string[]; | ||
export type TypistProps = { | ||
children: React.ReactNode; | ||
typingDelay?: Delay; | ||
backspaceDelay?: Delay; | ||
loop?: boolean; | ||
pause?: boolean; | ||
startDelay?: number; | ||
finishDelay?: number; | ||
onTypingDone?: () => void; | ||
splitter?: Splitter; | ||
cursor?: string | React.ReactElement; | ||
disabled?: boolean; | ||
restartKey?: any; | ||
}; | ||
``` | ||
|
||
#### `children` | ||
|
||
The contents that will be rendered with typewriter effect. It accepts nested elements, so you can easily style your contents. | ||
|
||
Note that `Typist` treats the element whose children is `null` or `undefined` as a single token. For example: | ||
|
||
```jsx | ||
const Foo = () => { | ||
return <div>Foo</div>; | ||
}; | ||
|
||
// The text "Foo" will be displayed after "123" immediately instead of displayed seperately | ||
const App = () => { | ||
return ( | ||
<Typist> | ||
123 | ||
<Foo /> | ||
</Typist> | ||
); | ||
}; | ||
``` | ||
|
||
#### `typingDelay` | ||
|
||
**Default**: `75` | ||
|
||
The delay after typing a token. If you pass in a function, `Typist` will call the function after typing a token and use the return value as the delay. | ||
|
||
#### `backspaceDelay` | ||
|
||
**Default**: `typingDelay` | ||
|
||
The delay after backspacing a token. If you pass in a function, `Typist` will call the function after backspacing a token and use the return value as the delay. | ||
|
||
#### `loop` | ||
|
||
**Default**: `false` | ||
|
||
`Typist` will automatically restart the typing animation if this value is `true`. | ||
|
||
#### `pause` | ||
|
||
**Default**: `false` | ||
|
||
Set to `true` if you want to pause the typing animation. | ||
|
||
#### `startDelay` | ||
|
||
**Default**: `0` | ||
|
||
`Typist` will wait for this delay before starting the typing animation. | ||
|
||
#### `finishDelay` | ||
|
||
**Default**: `0` | ||
|
||
`Typist` will wait for this delay after finishing the typing animation. | ||
|
||
#### `onTypingDone` | ||
|
||
This function will be called when the typing animation finishes. It will be called before waiting for the timeout with `finishDelay`. | ||
|
||
#### `splitter` | ||
|
||
**Default**: `(str: string) => str.split('')` | ||
|
||
`Typist` will use this function to get tokens from strings. It may be useful when you want to split your string in different way. For example, you can use [grapheme-splitter](https://github.com/orling/grapheme-splitter) to split string if your string contains emoji. | ||
|
||
```tsx | ||
import GraphemeSplitter from 'grapheme-splitter'; | ||
|
||
const splitter = (str: string) => { | ||
return new GraphemeSplitter().splitGraphemes(str); | ||
}; | ||
|
||
const App = () => { | ||
return ( | ||
<Typist splitter={splitter}> | ||
😎🗑🥵⚠😀👍✌👨👨👧👦📏💡🚀🎂😓🎈💕😘 | ||
<Typist.Backspace count={16} /> | ||
</Typist> | ||
); | ||
}; | ||
``` | ||
|
||
#### `cursor` | ||
|
||
Will be inserted after the last typed token. | ||
|
||
#### `disabled` | ||
|
||
**Default**: `false` | ||
|
||
If this value is `true`, the result will be displayed immediately without typing animation. It can be useful when you want to display the final result if a user has visited the typing animation. | ||
|
||
#### `restartKey` | ||
|
||
`Typist` will restart the typing animation whenever `restartKey` changes. | ||
|
||
### `Typist.Backspace` | ||
|
||
```ts | ||
type Props = { | ||
count: number; | ||
}; | ||
``` | ||
|
||
#### `count` | ||
|
||
The number of tokens that will be backspaced. | ||
|
||
### `Typist.Delay` | ||
|
||
```ts | ||
type Props = { | ||
ms: number; | ||
}; | ||
``` | ||
|
||
#### `ms` | ||
|
||
The duration of the delay in milliseconds. | ||
|
||
### `Typist.Paste` | ||
|
||
```ts | ||
type Props = { | ||
children: React.ReactNode; | ||
}; | ||
``` | ||
|
||
#### `children` | ||
|
||
Children inside this component will be pasted without typewriter effect. Do not wrap another `Paste` inside this component, otherwise `Typist` will produce weird behavior. | ||
- [react-typist-component](./packages/react-typist-component/README.md) |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
File renamed without changes.
Oops, something went wrong.
7a8c23c
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Successfully deployed to the following URLs:
react-typist-component – ./
react-typist-component.vercel.app
react-typist-component-git-main-jason89521.vercel.app
react-typist-component-jason89521.vercel.app