@bostonuniversity/bulib-wc/src/footer/footer.stories.mdx

collection of web components and styles used at Boston University Libraries

import { Story, Preview, Meta, Props, html, withKnobs, withWebComponentsKnobs } from '@open-wc/demoing-storybook';
import '../index.js';

<Meta 
  title="Branding|bulib-footer"
  decorators={[withKnobs, withWebComponentsKnobs]}
  parameters={{
    component: "bulib-footer",
    options: { selectedPanel: "storybookjs/knobs/panel" }
  }}
/>

# Footer Component

Wrap the bottom of the page with important copywright/branding info, site-specific list of links, 
  and context-sensitive location, social media, and contact information (via `bulib-locoso`).

## Usages 

### Default (generic)

Without being given any information, the footer speaks generically about the BU Libraries
  and displays the sitemap for the `about` (wordpress) site.

<Preview withToolbar>
  <Story name="default">
    {html`<bulib-footer></bulib-footer>`}
  </Story>
</Preview>

### Known Library, Unknown Site

Here the library is specified to Pickering (`pel`) but we've not set any for this particular site, 
  so we can display hours and particular contact/location info, but still default to the sitemap 
  for the `about` section.

<Preview withToolbar>
  <Story name="known-library">
    {html`<bulib-footer curr_url="http://bu.libcal.com/booking/Pickering-quietstudy"></bulib-footer>`}
  </Story>
</Preview>


### Known Site, Unknown Library

Here the `library` is unspecified (so we don't display any hours or particular info), but the
  `main_site` is known, so the sitemap is customized for askalibrarian (`help`).

<Preview withToolbar>
  <Story name="known-site">
    {html`<bulib-footer curr_url="https://askalibrarian.com/"></bulib-footer>`}
  </Story>
</Preview>

### Known Library, Known Site

At this url, we know both the `library` and the `main_site` (`help`), so we can display 
  library-specific information (`pardee`) as well as the sitemap for the askalibrarian site (`help`).

<Preview withToolbar>
  <Story name="known-site-library">
    {html`<bulib-footer curr_url="https://askalibrarian.bu.edu/businessFAQs/"></bulib-footer>`}
  </Story>
</Preview>

## Customizing with Slots

If you'd like a particular item inside of the middle part of the footer, you can use the `sitemap` slot:

### Basic Slot 

You can recreate the style of the existing with something like the following...

<Preview withToolbar>
  <Story name="slotted-basic">
    {html`
      <bulib-footer>
        <div slot="sitemap">
          <h3>[Name of the Website]</h3>
          <ul class="no-bullet">
            <li><a href="" class="white-link">first link</a></li>
            <li><a href="" class="white-link">second link</a></li>
            <li><a href="" class="white-link">third link</a></li>
          </ul>
        </div>
      </bulib-footer>
    `}
  </Story>
</Preview>


### Customized (slotted)

Without being given any information, the footer speaks generically about the BU Libraries
  and displays the sitemap for the `about` (wordpress) site.

<Preview withToolbar>
  <Story name="slotted-custom">
    {html`
      <bulib-footer>
        <div slot="sitemap" style="height: 100%;" class="secondary-menu flexw space-evenly mvs">
          <h2>Customized Sitemap/Footer</h3>
          <bulib-color var="--color-primary-background" white></bulib-color>
          <bulib-card icon="view_compact" title="bulib-card"
            description="you really can put anything in here" link="https://bu.edu/library/help/visiting-the-libraries"></bulib-card>
        </div>
      </bulib-footer>`}
  </Story>
</Preview>


## API - Properties 

<Props of="bulib-footer" />