ting: A Swift repository from sayyidisal

Overview

🍞 Flexible and customizable React toast notifications with support for positioning, custom rendering, click handlers, and duration control.

Video Demo 📺

		Modal
Ting_iOS.mp4	Ting_Android.mp4	Modal.mp4

Installation

yarn add @baronha/ting
or
npm i @baronha/ting

If you want to use Expo. Burnt is the solution for you.

New Architecture

cd ios && RCT_NEW_ARCH_ENABLED=1 bundle exec pod install --verbose

Older

cd ios && pod install --verbose

Usage

import { toast } from '@baronha/ting';
// ...
const options = {
  title: 'Done 😎',
  message: 'Successful!!',
};

toast(options); // easy to use

Customize Icon

import { toast } from '@baronha/ting';
// ...
const options = {
  // ...
  title: 'Vietnamese Gangz 😎',
  message: 'Anh em tao là Vietnamese Gangz',
  titleColor: '#D60A2E',
  icon: {
    uri: require('./vietnam.png'), // or remote
    size: 24,
  },
};

toast(options); // icon is 🇻🇳

import { alert } from '@baronha/ting';
// ...
const options = {
  title: 'Done 😎',
  message: 'Successful!!',
};

alert(options); // easy to use

Initialization

Instead of using too many options like this:

const options = {
  // ...
  messageColor: '#D60A2E',
  titleColor: '#D60A2E',
  icon: {
    uri: require('./vietnam.png'), // or remote
    size: 24,
  },
  shouldDismissByTap: true,
  position: 'bottom',
  // ... bla bla bla
};

toast(options);

You want to initialize the default options for all subsequent use of toast or alert. You can use the setup function that is called when the application is initialized. Do the following:

import { setup } from '@baronha/ting';

const initOption = {
  toast: {
    messageColor: '#D60A2E',
    titleColor: '#D60A2E',
    backgroundColor: '#ffffff',
    // ... more and more
  },
  alert: {
    // ... alert's option
  },
};

setup(initOption);

// Use it next time. You can completely override it on subsequent calls
toast({
  title: 'Ting!',
  message: 'Easy toast for React Native',
});

alert({
  title: "What's up bruhhh!",
  message: 'Easy Alert for React Native',
});

Options

Property	Type	Default value	Toast	Alert	Description
`title`	string	null	✅	✅
`message`	string	null	✅	✅
`titleColor`	string	null	✅	✅	The color of the title text in hexadecimal format (e.g., #FF0000)
`messageColor`	string	null	✅	✅	The color of the message text in hexadecimal format (e.g., #00FF00)
`icon`	`object`	null	✅	✅	See Icon
`preset`	string	`done`	✅	✅	`done, error, none, spinner`
`duration`	number	`3`	✅	✅	The lifetime of the toast (seconds)
`titleColor`	string	null	✅	✅
`shouldDismissByDrag`	boolean	true	✅		The behavior on `Android` is click
`position`	string	`top`	✅		Toast is displayed from `top` or `bottom`
`haptic`	string	null	✅		`success, warning, error, none`
`shouldDismissByTap`	boolean	true		✅
`borderRadius`	number	null		✅
`blurBackdrop`	number	null		✅
`backdropOpacity`	number	null		✅
`backgroundColor`	string	#ffffff	✅	✅	The background color of the toast in hexadecimal format (e.g., #0000FF)

Icon

icon	Type	Default value
`uri`	string	null
`size`	number	null
`tintColor`	string	null

To Do

Initialize for the first time (v.1.0.5)
tintColor for icon (v.1.0.5)
backgroundColor (v.1.0.3)
spinner preset for toast (v.1.1.0)
custom color like StyleSheet (e.g. #fff, red, rgba(0, 0, 0, .8))
shouldDismissByDrag on Android
callback

Performance

We're trying to improve performance. If you have a better solution, please open a issue or pull request. Best regards!

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT AlertKit SPIndicator EasyWindow

sayyidisal/ting