@nib-components/content-link v2.3.12

Setting up your component

Delete this section after you've setup the component

Before the component is accepted into the DLS:

1. Github: Create the repository under your own username/organisation

When the component is accepted into the DLS:

1. Github: Transfer ownership of the repository to frontend
2. BuildKite: Create a New Pipeline
3. BuildKite: Enter the following settings:

• Name: content-link
• Git Repository: git@git.nib.com.au:frontend/content-link.git

4. BuildKite: Remove the default Step and add a Read steps from repository step

• And add cd deploy && bundle install && bundle update sceptre sceptre-dotnet sceptre-app && bundle exec sceptre-app pipeline upload to the Commands to run textbox
• And add os=linux to the Agent Targeting Rules textbox

5. BuildKite: Create Pipeline and follow the instructions to add the webhook to GithubEnterprise
6. BuildKite: Go to Settings

• Check Build pull requests from third-party forked repositories and click Save Github Enterprise Settings
• Copy the Markdown badge from Settings and past it below.

7. Github: Edit the readme to remove these steps and kick off a New build
8. Github: Protect the master branch

• Go to Settings > Branches
• Choose the master branch
• Check Protect this branch
• Check Require status checks to pass before merging
• Check Include administrators and Require branches to be up to date before merging
• Check all Status checks found in the last week for this repository

@nib-components/content-link

A content-link component.

Installation

npm install --save @nib-components/content-link

Usage

import ContentLink from '@nib-components/content-link';

const iconTypes = {
  imageIcon: ImageIcon
};

<ContentLink
  component={CustomLink}
  href="/"
  text="Click here"
  trackingTag="example-tag-id"
  target="_self"
  icon={icon}
  iconTypes={iconTypes}
/>

Properties

component

The Link component.

Optional. A string or function. Defaults to an a element.

href

The href for the Link.

Required. A string.

text

The text displayed href for the Link.

Required. A string.

trackingTag

The tracking tag id of the Link for site navigation analytics.

Required. A string.

target

The target of the Link, either _self or _blank.

Optional. A string. Defaults to _self.

icon

The icon to displayed with the Link.

Optional. An object.

iconTypes

The map of icon types that can be displayed with the Link e.g. imageIcon, dlsIcon.

Optional. An object.

Change log

1.0.0

Initial release.

Contributing

You can edit the files in ./src, whilst running npm run watch. This will compile for the ./dist folder.

Contentful

The link schema, mapping, decorator and tracking tag decorator can be imported from @nib-components/content-link -

import Link, {linkSchema, linkMapping, linkDecorator, trackingTagDecorator} from @nib-components/content-link;

A Link entry should be added to the relevant Contentful space with the following entries -

The icon type is site specific e.g. dlsIcon for nib icons or standard imageIcon for links with a media image icon. The standard ImageIcon component and iconBuilder can be imported from @nib-components/content-icon.

The tracking tag is transformed in the trackingTagDecorator. It is used as the id on the Link component.