576bcf554f
I originally planned to add component documentation, but as this dragged on and I found that JSDoc-to-Markdown sometimes needed hand-tuning, I decided to skip it and focus on replicating what was already present in Freestyle. Adding documentation is a finite task that can be revisited in the future.
My goal was to migrate everything from Freestyle with as few changes as possible. Some adaptations that I found necessary:
• the DelayedArray and DelayedTruth utilities that delay component rendering until slightly after initial render because without them:
◦ charts were rendering with zero width
◦ the JSON viewer was rendering with empty content
• Storybook in Ember renders components in a routerless/controllerless context by default, so some component stories needed changes:
◦ table pagination/sorting stories access to query params, which necessitates some reaching into Ember internals to start routing and dynamically generate a Storybook route/controller to render components into
◦ some stories have a faux controller as part of their Storybook context that hosts setInterval-linked dynamic computed properties
• some jiggery-pokery with anchor tags
◦ inert href='#' had to become href='javascript:;
◦ links that are actually meant to navigate need target='_parent' so they don’t navigate inside the Storybook iframe
Maybe some of these could be addressed by fixes in ember-cli-storybook but I’m wary of digging around in there any more than I already have, as I’ve lost a lot of time to Storybook confusion and frustrations already 😞
The STORYBOOK=true environment variable tweaks some environment settings to get things working as expected in the Storybook context.
I chose to:
• use angle bracket invocation within stories rather than have to migrate them soon after having moved to Storybook
• keep Freestyle around for now for its palette and typeface components
85 lines
2.5 KiB
JavaScript
85 lines
2.5 KiB
JavaScript
import hbs from 'htmlbars-inline-precompile';
|
|
import productMetadata from '../../app/utils/styleguide/product-metadata';
|
|
|
|
export default {
|
|
title: 'Components|Accordion',
|
|
};
|
|
|
|
export let Standard = () => {
|
|
return {
|
|
template: hbs`
|
|
<h5 class="title is-5">Accordion</h5>
|
|
<ListAccordion @source={{products}} @key="name" as |ac|>
|
|
<ac.head @buttonLabel="details">
|
|
<div class="columns inline-definitions">
|
|
<div class="column is-1">{{ac.item.name}}</div>
|
|
<div class="column is-1">
|
|
<span class="bumper-left badge is-light">{{ac.item.lang}}</span>
|
|
</div>
|
|
</div>
|
|
</ac.head>
|
|
<ac.body>
|
|
<h1 class="title is-4">{{ac.item.name}}</h1>
|
|
<p>{{ac.item.desc}}</p>
|
|
<p><a href="{{ac.item.link}}" target="_parent">Learn more...</a></p>
|
|
</ac.body>
|
|
</ListAccordion>
|
|
`,
|
|
context: {
|
|
products: productMetadata,
|
|
},
|
|
};
|
|
};
|
|
|
|
export let OneItem = () => {
|
|
return {
|
|
template: hbs`
|
|
<h5 class="title is-5">Accordion, one item</h5>
|
|
<ListAccordion @source={{take 1 products}} @key="name" as |a|>
|
|
<a.head @buttonLabel="details">
|
|
<div class="columns inline-definitions">
|
|
<div class="column is-1">{{a.item.name}}</div>
|
|
<div class="column is-1">
|
|
<span class="bumper-left badge is-light">{{a.item.lang}}</span>
|
|
</div>
|
|
</div>
|
|
</a.head>
|
|
<a.body>
|
|
<h1 class="title is-4">{{a.item.name}}</h1>
|
|
<p>{{a.item.desc}}</p>
|
|
<p><a href="{{a.item.link}}">Learn more...</a></p>
|
|
</a.body>
|
|
</ListAccordion>
|
|
`,
|
|
context: {
|
|
products: productMetadata,
|
|
},
|
|
};
|
|
};
|
|
|
|
export let NotExpandable = () => {
|
|
return {
|
|
template: hbs`
|
|
<h5 class="title is-5">Accordion, not expandable</h5>
|
|
<ListAccordion @source={{products}} @key="name" as |a|>
|
|
<a.head @buttonLabel="details" @isExpandable={{eq a.item.lang "golang"}}>
|
|
<div class="columns inline-definitions">
|
|
<div class="column is-1">{{a.item.name}}</div>
|
|
<div class="column is-1">
|
|
<span class="bumper-left badge is-light">{{a.item.lang}}</span>
|
|
</div>
|
|
</div>
|
|
</a.head>
|
|
<a.body>
|
|
<h1 class="title is-4">{{a.item.name}}</h1>
|
|
<p>{{a.item.desc}}</p>
|
|
<p><a href="{{a.item.link}}">Learn more...</a></p>
|
|
</a.body>
|
|
</ListAccordion>
|
|
`,
|
|
context: {
|
|
products: productMetadata,
|
|
},
|
|
};
|
|
};
|