0.9.5 • Published 5 months ago

@justeattakeaway/pie-toast v0.9.5

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
5 months ago

@justeattakeaway/pie-toast

Source Code | Design Documentation | NPM

@justeattakeaway/pie-toast is a Web Component built using the Lit library. It offers a simple and accessible toast component for web applications.

Table of Contents

Installation

To install any of our web components in your application, we would suggest following the getting started guide to set up your project.

Ideally, you should install the component using the @justeattakeaway/pie-webc package, which includes all of the components. Or you can install the individual component package.

Documentation

Properties

PropOptionsDescriptionDefault
isOpentrue, falseWhen true, the toast is set to be open and visible.false
variant"neutral", "info", "warning", "success", "error"Sets the variant of the toast."neutral"
isStrongtrue, falseWhen true, the toast is displayed with a strong visual style.false
isDismissibletrue, falseWhen true, allows dismissing the toast by clicking on the close button.false
messagestringThe message content of the toast.""
isMultilinetrue, falseAllows the message content to be displayed as multiline, limited to three rows.false
leadingAction{ text: string, ariaLabel?: string }The leading action for the toast.undefined
durationnumber, nullSets the duration of the toast in milliseconds before it auto-dismisses. null disables auto-dismiss. Defaults to 5 seconds if not specified.5000

Slots

This component does not have any slots. All content is controlled through properties.

CSS Variables

This component does not expose any CSS variables for style overrides.

Events

EventTypeDescription
pie-toast-closeCustomEventTriggered when the user interacts with the close icon or when the toast auto dismiss.
pie-toast-openCustomEventTriggered when the toast is opened.
pie-toast-leading-action-clickCustomEventTriggered when the user interacts with the leading action.

Usage Examples

⚠️ By default, the toast will auto-dismiss in five seconds. To disable the auto-dismiss functionality, you must set the duration property to null.

For HTML:

// import as module into a js file e.g. main.js
import '@justeattakeaway/pie-webc/components/toast.js'
<!-- pass js file into <script> tag -->
<pie-toast message="Message"></pie-toast>
<script type="module" src="/main.js"></script>

For Native JS Applications, Vue, Angular, Svelte etc.:

// Vue templates (using Nuxt 3)
import '@justeattakeaway/pie-webc/components/toast.js';

<pie-toast message="Message"></pie-toast>
// or with duration set to null to disable auto-dismiss
<pie-toast message="Message" duration={null}></pie-toast>

For React Applications:

import { PieToast } from '@justeattakeaway/pie-webc/react/toast.js';

<PieToast message="Message"></PieToast>
// or with duration set to null to disable auto-dismiss
<PieToast message="Message" duration={null}></PieToast>

Questions and Support

If you work at Just Eat Takeaway.com, please contact us on #help-designsystem. Otherwise, please raise an issue on Github.

Contributing

Check out our contributing guide for more information on local development and how to run specific component tests.

0.8.4

5 months ago

0.7.2

9 months ago

0.7.1

9 months ago

0.7.4

8 months ago

0.7.3

8 months ago

0.7.0

10 months ago

0.9.4

5 months ago

0.9.3

5 months ago

0.9.5

5 months ago

0.8.1

7 months ago

0.4.5

11 months ago

0.8.0

7 months ago

0.4.4

12 months ago

0.8.3

5 months ago

0.8.2

7 months ago

0.4.6

11 months ago

0.4.3

12 months ago

0.4.2

12 months ago

0.9.0

5 months ago

0.9.2

5 months ago

0.9.1

5 months ago

0.5.0

11 months ago

0.5.2

11 months ago

0.5.1

11 months ago

0.7.6

8 months ago

0.7.5

8 months ago

0.7.8

8 months ago

0.7.7

8 months ago

0.6.0

10 months ago

0.4.1

1 year ago

0.4.0

1 year ago

0.3.4

1 year ago

0.3.2

1 year ago

0.3.3

1 year ago

0.3.1

1 year ago

0.3.0

1 year ago

0.2.1

1 year ago

0.2.0

1 year ago

0.1.1

1 year ago

0.1.0

1 year ago

0.0.0

1 year ago