@takeshape/routing

@takeshape/routing is a module that generates urls. It is library agnostic, so it can be used with React, Vue, etc.

Installation

npm install --save @takeshape/routing

Routing

The route function is used to generate urls on the client side. It allows you to create links to your static site with content fetched from the GraphQL API. It's especially useful when building out dynamic search or taxonomy pages.

route is a curried function which consumes the following params

• config - Object - The tsg.yml config object use yaml-loader to import it
• routeName - String - The name of the desired route
• content - Object - An object containing the properties referenced in the route string

tsg.yml

templatePath: src/templates
staticPath: static
buildPath: build

routes:
  post:
    path: /blog/:title/
    template: pages/posts/individual.html

search-result-link.jsx

import {route as createRoute} from '@takeshape/routing';
import config from '../tsg.yml';

const route = createRoute(config);

export default function SearchResultLink({content}) {
  return <a href={route(content._contentTypeName, content)}>{content.title}</a>;
}

where the content prop would be:

{
  "_contentTypeName": "post",
  "title": "How Routing Works"
}

Rendered HTML:

<a href="https://www.example.com/blog/how-routing-works">How Routing Works</a>

Image URLs

getImageUrl converts asset paths into URLs suitable for use in an <img> tag.

import {getImageUrl} from '@takeshape/routing';

<img src={getImageUrl('/my/image/path')}/>

<img src={getImageUrl('/my/image/path', {w: 300, h: 250})}/> // image resized to 300x250

Pass an image manipulation object as the second argument to getImageUrl. See their docs for all the possibilites.

Asset URLs

Not all assets are images, sometimes you just want a simple download link. Use getAssetUrl in this case.

import {getAssetUrl} from '@takeshape/routing';

<a href={getAssetUrl('/my/asset/path')} download>
  Download Me
</a>;