@justeat/f-cookie-banner

v4.12.2

Published

8 months ago

Fozzie Cookie Banner - Cookie Banner

Downloads

5,779

Usage

Installation

This package can be installed using npm or yarn:

yarn add @justeat/f-cookie-banner

npm install @justeat/f-cookie-banner

Vue Applications

You can import it in your Vue SFC like this (please note that styles have to be imported separately):

import CookieBanner from '@justeat/f-cookie-banner';
import '@justeat/f-cookie-banner/dist/f-cookie-banner.css';

export default {
  components: {
    CookieBanner
  }
};

If you are using Webpack, you can import the component dynamically to separate the cookie-banner bundle from the main bundle.client.js:

import '@justeat/f-cookie-banner/dist/f-cookie-banner.css';

export default {
    components: {
        ...
        CookieBanner: () => import(/* webpackChunkName: "cookie-banner" */ '@justeat/f-cookie-banner')
    }
}

Call the component in your template:

<f-cookie-banner
    :locale="$i18n.locale" />

Non-Vue Applications

A static vanilla version of f-cookie-banner is available as part of the published component. These self-contained JS & CSS files are compiled from the base Vue component using the Vue CLI pre-render plugin.

Static files are generated for each locale and added to dist/static folder. There is one JS and CSS file for each locale. For example dist/static/en-GB.js and dist/static/en-GB.css.

HTML Tag Implementation

Files can be accessed directly via CDN using unkpg.com.

By omitting the version/tag unpkg will serve the latest version automatically, you may wish to fix the version served in your application

Using the CDN the cookie banner can be added to any web page using basic tags. The page must contain a placeholder element with an id of "cookie-banner", e.g., <div id="cookie-banner"></div>.

In order for the static cookie banner to look correct, you must also link to the fozzie-utilities CSS file created by @justeat/fozzie (please see the example below on how to link to it). Whilst fozzie-reset and fozzie-typography are not required, we highly recommend linking to them as well

<html>
  <head>
    <!-- use fozzie CSS files to provide base styles and utilities classes used by the cookie banner -->
    <link rel="stylesheet" href="https://unpkg.com/@justeat/fozzie/dist/css/fozzie-reset.css" />
    <link rel="stylesheet" href="https://unpkg.com/@justeat/fozzie/dist/css/fozzie-typography.css" />
    <link rel="stylesheet" href="https://unpkg.com/@justeat/fozzie/dist/css/fozzie-utilities.css" />
    <!--  use the cookie banner CSS NOTE: It is important that you choose the correct tenant -->
    <link href="https://unpkg.com/@justeat/f-cookie-banner/dist/static/en-GB.css" rel="stylesheet" />
  </head>
  <body>
    <div id="cookie-banner"></div>
    <script
      src="https://unpkg.com/@justeat/f-cookie-banner/dist/static/en-GB.js"
      type="text/javascript"
    ></script>
  </body>
</html>

A working demo can be found on codepen.io

Bundling Tool Implementation

You can use any modern bundling tool to include this version in a project. For example using Browserify with browserify-css plugin:

/* app.css */
@import "node_modules/@justeat/f-cookie-banner/dist/static/en-GB.css";

// app.js
require("./app.css");

const cookieBanner = require("@justeat/f-cookie-banner/dist/static/en-GB.js");

(function() {
  cookieBanner();
})();

Use Browserify to bundle JS & CSS

browserify -t browserify-css app.js > bundle.js

Finally, use the generated bundle in your HTML page

<html>
  <head></head>
  <body>
    <div id="cookie-banner"></div>
    <script src="bundle.js"></script>
  </body>
</html>

Non-Vue Custom Props

The Non-Vue version is compiled using the Vue CLI pre-render plugin, which means that prop values are determined at build-time. You can configure your own custom version by simply adding the required props to the base template file used by the pre-renderer.

Props should be added to the App.vue. Remember the locale prop will be replaced by the build:static-files task.

In the code example below we add the nameSuffix prop:

<template>
    <cookie-banner
        locale="da-DK"
        :should-absolute-position-reopen-link="false"
        nameSuffix="myName"
    />
</template>

Next run yarn build followed by yarn build:static-files. The generated files will be added to the root dist/static folder.

Configuration

Props

f-cookie-banner has a number of props that allow you to customise its functionality.

The props that can be defined are as follows:

| Prop | Type | Default | Description | | ----- | ----- | ------- | ----------- | | locale | String | '' | Set the tenant for localisation ['da-DK', 'en-AU', 'en-GB', 'en-IE', 'en-NZ', 'es-ES', 'it-IT', 'nb-NO']. | | isHidden | Boolean | false | show/hide the cookie consent banner. | | shouldShowLegacyBanner | Boolean | false | Use the legacy "passive" banner markup (UK only). | | cookieExpiry | Number | 90 | Expiry time (days) of cookies written to the browser. | | shouldUseGreyBackground | Boolean | true | Use grey background for the reopen link. | | shouldAbsolutePositionReopenLink | Boolean | true | Adds a ResizeObserver and absolutely positions the re-open link to the bottom when the content is smaller than the window | | isFirstInTabOrder | Boolean | true | Whether or not the cookie banner should appear first in the page's tab order. | | nameSuffix | String | '' | Add a suffix to the cookie name. This allows the cookie banner to create a cookie with a different name to be able to handle multiple sub-domains. | | domain | String | null | Specifies which hosts can receive a cookie. If unspecified, the attribute defaults to the same host that set the cookie, excluding subdomains. If it is specified, then subdomains are always included. Therefore, passing the prop is less restrictive than omitting it. For example, if you specify just-eat.co.uk, the cookie will be used in any subdomain of just-eat.co.uk |

Important

Please, be mindful of the amount of cookies your app will be generating when using the nameSuffix prop above. If you have questions, please, contact the code owners.
The Non Vue version uses default prop values with the exception of shouldAbsolutePositionReopenLink which is set to false to avoid any conflicts with consuming applications. A seperate version is generated for each locale. It is possible to generate a custom build and use your own prop values, see on Vue Custom Props above.

CSS Classes

f-cookie-banner has its own styles which are scoped to the component using CSS modules to prevent conflicts with existing styles on the page.

The component is also using utility css styles from fozzie package. You need to make sure to @include trumps-utilities(); mixin to your application styles if you use beta version of fozzie package (>= v5.0.0-beta.0). If you are using main version (v4.X.X) styles should come out of the box.

Development

Start by cloning the repository and installing the required dependencies:

$ git clone [email protected]:justeat/fozzie-components.git
$ cd fozzie-components
$ yarn

Change directory to the f-cookie-banner package:

$ cd packages/components/organisms/f-cookie-banner

Running storybook

Storybook can be used to develop new and existing components.

To start storybook:

Please ensure you are in the f-cookie-banner directory as outlined in the above instructions.

# cd to the storybook package
$ cd ../../../storybook

# Run storybook
$ yarn storybook:serve

This will build and serve storybook at http://localhost:8080.

Static Vanilla Files

Static file generation is controlled by the gulp task ./f-cookie-banner-static/gulpfile.js. This includes the array of language codes that determine which locale versions are compiled.

The task can be manually executed using yarn build:static-files from f-cookie-banner. You will need to ensure that you run yarn build to generate the dist folder and files used by ./f-cookie-banner-static/

The build task is chained to the main publish task and will run automatically when publishing to NPM or using Yalc.