Fragmentsiya is a robust JavaScript library that splits text into unique fragments, providing fine-grained control and customization over individual characters with unique and randomized indexing capabilities.
To install Fragmentsiya, you can use npm:
npm install @penev_palemiya/fragmentsiya
First, import the Fragmentsiya library in your file:
import { Fragmentsiya } from '@penev_palemiya/fragmentsiya';
Create an instance of Fragmentsiya:
const fragmentsiya = Fragmentsiya.getInstance();
Then, use the split
function to split your text into fragments. Here's an example:
spliter.split({
text: "Your text goes here",
processor: (span, charIndex, totalChars) => {
// Your custom logic here
},
randomize: true
});
The split
function accepts a configuration object with the following properties:
text
(String) - The text to split into fragments.processor
(Function) - A callback function that gets executed on each character. This function gets three arguments:span
(HTMLElement): The span element that wraps the character.charIndex
(Number): The index of the current character in the word.totalChars
(Number): The total number of characters in the word.
randomize
(Boolean) - If set totrue
, assigns each character a unique random index. Default isfalse
.
Contributions are welcome. Please fork this repository and submit your PR.
Fragmentsiya is MIT licensed.
Penev Vladislav
For any inquiries, you can reach out to Penev at [email protected]