@ilo-org/react 0.1.1 → 0.2.0

package/src/components/Footer/Footer.args.ts

@@ -0,0 +1,105 @@
+import { FooterProps } from "./Footer.props";
+import ilo_logo_white from "@ilo-org/brand-assets/logo_en_horizontal_white.svg";
+
+const basic: FooterProps = {
+  className: "footer",
+  logo: ilo_logo_white,
+  tagline: "Advancing social justice, promoting decent work",
+  subtagline: "ILO is a specialized agency of the United Nations",
+  address: [
+    "International Labour Organization",
+    "4 route des Morillons",
+    "CH-1211 Genève 22",
+    "Switzerland",
+  ],
+  linkgroup: [
+    {
+      links: [
+        {
+          label: "Link One",
+          url: "https://www.ilo.org",
+        },
+        {
+          label: "Link Two",
+          url: "https://www.ilo.org",
+        },
+        {
+          label: "Link Three",
+          url: "https://www.ilo.org",
+        },
+        {
+          label: "Link Four",
+          url: "https://www.ilo.org",
+        },
+        {
+          label: "Link Five",
+          url: "https://www.ilo.org",
+        },
+        {
+          label: "Link Six",
+          url: "https://www.ilo.org",
+        },
+      ],
+    },
+  ],
+  socials: {
+    headline: "Social Links Headline",
+    links: [
+      {
+        type: "instagram",
+        url: "https://www.instagram.com/iloinfo/",
+      },
+      {
+        type: "facebook",
+        url: "https://www.facebook.com/ILO.ORG/",
+      },
+      {
+        type: "twitter",
+        url: "https://twitter.com/ILO/",
+      },
+      {
+        type: "youtube",
+        url: "https://youtube.com/@ILO/featured/",
+      },
+    ],
+  },
+  subscribe: {
+    label: "Subscribe",
+    url: "https://www.ilo.org",
+  },
+  legal: "© 1996-2023 International Labour Organization (ILO)",
+  secondarylinks: [
+    {
+      label: "Link One",
+      url: "https://www.ilo.org",
+    },
+    {
+      label: "Link Two",
+      url: "https://www.ilo.org",
+    },
+    {
+      label: "Link Three",
+      url: "https://www.ilo.org",
+    },
+    {
+      label: "Link Four",
+      url: "https://www.ilo.org",
+    },
+    {
+      label: "Link Five",
+      url: "https://www.ilo.org",
+    },
+    {
+      label: "Link Six",
+      url: "https://www.ilo.org",
+    },
+  ],
+  anchorlink: {
+    label: "Back to Top",
+    url: "#anchor",
+  },
+};
+
+const FooterArgs = { basic };
+
+export default FooterArgs;

package/src/components/Footer/Footer.props.ts

@@ -0,0 +1,84 @@
+import { LinkGroupProps } from "../LinkList/LinkList.props";
+import { LinkProps } from "../LinkList/LinkList.props";
+import { SocialTypes } from "../../types";
+
+export interface FooterProps {
+  /**
+   * Specify an optional className to be added to your Footer.
+   */
+  className?: string;
+
+  /**
+   * Props for the logo of the Footer
+   */
+  logo?: string;
+
+  /**
+   * Specify the tagline for the Footer
+   */
+  tagline?: string;
+
+  /**
+   * Specify the subtagline for the Footer
+   */
+  subtagline?: string;
+
+  /**
+   * Specify the address for the Footer, in multiple lines
+   */
+  address?: string[];
+
+  /**
+   * Specify the linkgroup for the Footer's links
+   */
+  linkgroup?: Required<Array<LinkGroupProps>>;
+
+  /**
+   * Specify the links to be displayed in this link group
+   */
+  socials?: FooterSocialProps;
+
+  /**
+   * Specify the legal statement for the Footer
+   */
+  subscribe?: LinkProps;
+
+  /**
+   * Specify the legal statement for the Footer
+   */
+  legal?: string;
+
+  /**
+   * Specify the secondary links for the Footer
+   */
+  secondarylinks?: LinkProps[];
+
+  /**
+   * Specify the anchor link for the Footer
+   */
+  anchorlink?: LinkProps;
+}
+
+interface FooterSocialProps {
+  /**
+   * Specify the headline for social links
+   */
+  headline?: Required<string>;
+
+  /**
+   * Specify the social links
+   */
+  links?: Required<SocialLinkProps>[];
+}
+
+interface SocialLinkProps {
+  /**
+   * Specify the type for social link
+   */
+  type?: Required<SocialTypes>;
+
+  /**
+   * Specify the url for social link
+   */
+  url?: Required<string>;
+}

package/src/components/Footer/Footer.tsx

@@ -0,0 +1,107 @@
+import { FC } from "react";
+import useGlobalSettings from "../../hooks/useGlobalSettings";
+import classnames from "classnames";
+import { FooterProps } from "./Footer.props";
+import { LinkList } from "../LinkList";
+import { Button } from "../Button";
+
+const Footer: FC<FooterProps> = ({
+  className,
+  logo,
+  tagline,
+  subtagline,
+  address,
+  linkgroup,
+  socials,
+  subscribe,
+  legal,
+  secondarylinks,
+  anchorlink,
+}) => {
+  const { prefix } = useGlobalSettings();
+
+  const baseClass = `${prefix}--footer`;
+  const footerClasses = classnames(className, baseClass);
+
+  return (
+    <footer className={footerClasses}>
+      <div className={`${baseClass}--main`}>
+        <div className="site--info">
+          <img className={`${baseClass}--logo`} src={logo} alt="ILO Logo" />
+          <h3 className={`${baseClass}--headline`}>{tagline}</h3>
+          <h4 className={`${baseClass}--subhead`}>{subtagline}</h4>
+        </div>
+        {address && (
+          <div className="address">
+            {address.map((line, i) => (
+              <p key={i} className="address--line">
+                {line}
+              </p>
+            ))}
+          </div>
+        )}
+        {linkgroup && (
+          <nav className="links">
+            <LinkList linkgroup={linkgroup} theme="dark"></LinkList>
+          </nav>
+        )}
+        {(socials || subscribe) && (
+          <div className="connect">
+            {socials && (
+              <>
+                <h5 className="social--headline">{socials?.headline}</h5>
+                <ul className="social--links">
+                  {socials.links &&
+                    socials.links.map((link, index) => (
+                      <li className="social--links--item" key={index}>
+                        <a
+                          className={`social--links--link ${link.type}`}
+                          href={link.url}
+                        >
+                          {link.type}
+                        </a>
+                      </li>
+                    ))}
+                </ul>
+              </>
+            )}
+            {subscribe && (
+              <Button
+                label={subscribe?.label}
+                url={subscribe?.url}
+                type="primary"
+                size="large"
+                target="_blank"
+              ></Button>
+            )}
+          </div>
+        )}
+      </div>
+      <div className={`${baseClass}--secondary`}>
+        <div className="legal">{legal}</div>
+        {secondarylinks && (
+          <nav className="secondarylinks">
+            <ul className="secondarylinks--list">
+              {secondarylinks.map((link, i) => (
+                <li className="secondarylinks--list--item">
+                  <a
+                    key={i}
+                    href={link.url}
+                    className="secondarylinks--list--link"
+                  >
+                    {link?.label}
+                  </a>
+                </li>
+              ))}
+            </ul>
+          </nav>
+        )}
+        <a href={anchorlink?.url} className="anchorlink">
+          {anchorlink?.label}
+        </a>
+      </div>
+    </footer>
+  );
+};
+
+export default Footer;

package/src/components/Footer/index.ts

@@ -0,0 +1 @@
+export { default as Footer } from "./Footer";

package/src/components/LinkList/LinkList.props.ts

@@ -1,6 +1,6 @@
 import { LinkListThemes } from "../../types";
 
-interface LinkProps {
+export interface LinkProps {
   /**
    * Specify if this link should indent and have a triangle icon
    */
@@ -17,7 +17,7 @@ interface LinkProps {
   url?: Required<string>;
 }
 
-interface LinkGroupProps {
+export interface LinkGroupProps {
   /**
    * Specify an optional headline for this link group
    */

package/src/components/LocalNav/LocalNav.args.ts

@@ -0,0 +1,64 @@
+import { LocalNavProps } from "./LocalNav.props";
+import ilo_logo_white from "@ilo-org/brand-assets/logo_en_horizontal_white.svg";
+
+const basic: LocalNavProps = {
+  background: "#960A55",
+  logo: ilo_logo_white,
+  siteurl: "https://www.ilo.org/",
+  primarynav: {
+    navlabel: "Primary Nav Menu",
+    mobilecloselabel: "Close",
+    items: [
+      {
+        label: "Menu Item 1",
+        url: "https://www.ilo.org",
+      },
+      {
+        label: "Menu Item 2",
+        url: "https://www.ilo.org",
+      },
+      {
+        label: "Menu Item 3",
+        url: "https://www.ilo.org",
+      },
+      {
+        label: "Menu Item 4",
+        url: "https://www.ilo.org",
+      },
+      {
+        label: "Menu Item 5",
+        url: "https://www.ilo.org",
+      },
+    ],
+  },
+  mainlink: {
+    label: "Go to main website",
+    url: "https://www.ilo.org",
+  },
+  languagelabel: "English",
+  menucloselabel: "Close",
+  languagecontextmenu: {
+    links: [
+      {
+        label: "Français",
+        url: "https://www.ilo.org",
+      },
+      {
+        label: "Español",
+        url: "https://www.ilo.org",
+      },
+      {
+        label: "中文",
+        url: "https://www.ilo.org",
+      },
+      {
+        label: "Русский",
+        url: "https://www.ilo.org",
+      },
+    ],
+  },
+};
+
+const LocalNavArgs = { basic };
+
+export default LocalNavArgs;

package/src/components/LocalNav/LocalNav.props.ts

@@ -0,0 +1,60 @@
+import { LinkProps, ContextMenuProps } from "../ContextMenu/ContextMenu.props";
+
+export interface LocalNavProps {
+  /**
+   * Props for the background colour of the LocalNav
+   */
+  background?: string;
+
+  /**
+   * Props for the logo of the LocalNav
+   */
+  logo?: Required<string>;
+
+  /**
+   * Props for the home url of the LocalNav
+   */
+  siteurl?: Required<string>;
+
+  /**
+   * Specify the primary items for the LocalNav
+   */
+  primarynav?: Required<PrimaryNavProps>;
+
+  /**
+   * Specify the main link for the LocalNav
+   */
+  mainlink?: LinkProps;
+
+  /**
+   * Specify the menu close label for the LocalNav
+   */
+  menucloselabel?: string;
+
+  /**
+   * Specify the language label for the LocalNav
+   */
+  languagelabel?: string;
+
+  /**
+   * Specify the language context menu for the LocalNav
+   */
+  languagecontextmenu?: ContextMenuProps;
+}
+
+interface PrimaryNavProps {
+  /**
+   * Specify the label for local nav
+   */
+  navlabel?: Required<string>;
+
+  /**
+   * Specify the close label for mobile local nav
+   */
+  mobilecloselabel?: Required<string>;
+
+  /**
+   * Specify the social links
+   */
+  items?: Required<Array<LinkProps>>;
+}

package/src/components/LocalNav/LocalNav.tsx

@@ -0,0 +1,175 @@
+import { FC, useState } from "react";
+import useGlobalSettings from "../../hooks/useGlobalSettings";
+import { ContextMenu } from "../ContextMenu";
+import { LocalNavProps } from "./LocalNav.props";
+import { brand } from "@ilo-org/themes/tokens/brand/base.json";
+import classnames from "classnames";
+
+const LocalNav: FC<LocalNavProps> = ({
+  background,
+  logo,
+  siteurl,
+  primarynav,
+  mainlink,
+  menucloselabel,
+  languagelabel,
+  languagecontextmenu,
+}) => {
+  const { prefix } = useGlobalSettings();
+
+  const [toggleMenuOpen, setMenuToggleOpen] = useState(false);
+  const [toggleLanguageOpen, setLanguageToggleOpen] = useState(false);
+
+  const baseClass = `${prefix}--header`;
+  const localNavClasses = classnames(baseClass, `${baseClass}--local`, {
+    [`${prefix}--mobile--open`]: toggleMenuOpen,
+    [`${prefix}--select--open`]: toggleLanguageOpen,
+  });
+  const bg = background ? background : brand["ilo-dark-blue"].value;
+
+  const handleMenuToggle = () => {
+    setMenuToggleOpen(!toggleMenuOpen);
+  };
+
+  const handleLanguageToggle = () => {
+    setLanguageToggleOpen(!toggleLanguageOpen);
+  };
+
+  return (
+    <header className={localNavClasses}>
+      <div
+        className={`${baseClass}--utility-bar ${baseClass}--utility-bar--local`}
+        style={{ background: bg }}
+      >
+        <nav className={`${prefix}--nav--local`}>
+          <div className={`${prefix}--nav--local--logo-wrapper`}>
+            <a href={siteurl} className={`${prefix}--nav--local--logo-link`}>
+              <img
+                src={logo}
+                alt="ILO Logo"
+                className={`${prefix}--nav--local--logo`}
+              />
+            </a>
+          </div>
+          <ul className={`${prefix}--nav--local--set`}>
+            {primarynav?.items &&
+              primarynav.items.map((item, index) => (
+                <li className={`${prefix}--nav--local--item`} key={index}>
+                  <a href={item.url} className={`${prefix}--nav--local--link`}>
+                    <span>{item.label}</span>
+                  </a>
+                </li>
+              ))}
+          </ul>
+        </nav>
+        <div className={`${prefix}--language-switcher`}>
+          <div className={`${prefix}--language-switcher--wrap`}>
+            {mainlink && (
+              <span className={`${prefix}--language-switcher--link--wrap`}>
+                <a
+                  href={mainlink.url}
+                  className={`${prefix}--language-switcher--link`}
+                >
+                  {mainlink.label}
+                </a>
+              </span>
+            )}
+            <button
+              className={`${prefix}--language-switcher--button`}
+              type="button"
+            >
+              {languagelabel}
+            </button>
+            <ContextMenu links={languagecontextmenu?.links}></ContextMenu>
+          </div>
+        </div>
+        <button className={`${baseClass}--menu`} onClick={handleMenuToggle}>
+          Menu
+        </button>
+        <div className={`${baseClass}--navigation`}>
+          <div className={`${baseClass}--inner`}>
+            <div className={`${prefix}--mobile--nav`}>
+              <div className={`${prefix}--mobile--nav--logo`}>
+                <a href={siteurl} className={`${baseClass}--logo-link`}>
+                  <img
+                    className={`${baseClass}--logo`}
+                    src={logo}
+                    alt="ILO Logo"
+                  />
+                </a>
+                <button
+                  className={`${baseClass}--menu--close`}
+                  onClick={handleMenuToggle}
+                >
+                  {menucloselabel}
+                </button>
+              </div>
+              <div className={`${prefix}--mobile--nav--language--switcher`}>
+                <button
+                  className={`${prefix}--mobile--nav--language--switcher--button`}
+                  onClick={handleLanguageToggle}
+                  type="button"
+                >
+                  {languagelabel}
+                </button>
+              </div>
+              <div className={`${prefix}--mobile--nav--language--select`}>
+                <div className={`${baseClass}--inner`}>
+                  <div className={`${prefix}--mobile--subnav--menu`}>
+                    <button
+                      className={`${prefix}--mobile--subnav--back`}
+                      onClick={handleLanguageToggle}
+                      type="button"
+                    ></button>
+                    <button
+                      className={`${baseClass}--menu--close`}
+                      onClick={handleMenuToggle}
+                    >
+                      Close
+                    </button>
+                    <h6 className={`${prefix}--mobile--subnav--label`}>
+                      {languagelabel}
+                    </h6>
+                  </div>
+                  <ul className={`${prefix}--nav--set`}>
+                    {languagecontextmenu?.links &&
+                      languagecontextmenu.links.map((item, index) => (
+                        <li className={`${prefix}--nav--items`} key={index}>
+                          <a
+                            href={item.url}
+                            className={`${prefix}--nav--link ${prefix}--nav--language`}
+                          >
+                            {item.label}
+                          </a>
+                        </li>
+                      ))}
+                  </ul>
+                </div>
+              </div>
+            </div>
+            <nav
+              className={`${prefix}--nav`}
+              aria-labelledby="primary-navigation"
+            >
+              <h2 className={`${prefix}--nav--label`} id="primary-navigation">
+                {primarynav?.navlabel}
+              </h2>
+              <ul className={`${prefix}--nav--set`}>
+                {primarynav?.items &&
+                  primarynav.items.map((item, index) => (
+                    <li className={`${prefix}--nav--items`} key={index}>
+                      <a href={item.url} className={`${prefix}--nav--link`}>
+                        {item.label}
+                      </a>
+                    </li>
+                  ))}
+              </ul>
+            </nav>
+          </div>
+        </div>
+      </div>
+    </header>
+  );
+};
+
+export default LocalNav;

package/src/components/LocalNav/index.ts

@@ -0,0 +1 @@
+export { default as LocalNav } from "./LocalNav";

package/src/components/index.ts

@@ -42,3 +42,5 @@ export { Icon } from "./Icon";
 export { List } from "./List";
 export { Profile } from "./Profile";
 export { TableOfContents } from "./TableOfContents";
+export { Footer } from "./Footer";
+export { LocalNav } from "./LocalNav";

package/src/declarations.d.ts

@@ -0,0 +1,14 @@
+declare module "*.svg" {
+  const content: string;
+  export default content;
+}
+
+declare module "*.png" {
+  const content: string;
+  export default content;
+}
+
+declare module "*.jpg" {
+  const content: string;
+  export default content;
+}

package/src/types/index.ts

@@ -48,3 +48,4 @@ export type NotificationTypes = "error" | "info" | "success" | "warning";
 export type PositionTypes = "top" | "bottom" | "left" | "right";
 export type SizeTypes = "small" | "medium" | "large";
 export type TagTypes = "anchor" | "display" | "button";
+export type SocialTypes = "instagram" | "facebook" | "twitter" | "youtube";