Comments (4)
I agree that the default style template may not be stellar, particularly in terms of a responsive presentation (and I'd be happy to pitch on a change/update), but I'd argue that from a UI/UX standpoint, that alternative is actually worse:
- a top nav is not great when you're stacking an essentially unlimited number of section links
- it's likely huge and shoves any overview content out of view
- the nav disappears entirely when you're scrolled way down into the depths of the style guide, forcing users to scroll all the way back to find a different section
- it's not practical to make it fixed at the top to overcome this problem because of it's size
- there's no visible indication of where in the style guide you are (highlighted section name, breadcrumbs, etc).
At the very least, my suggestion is that if we were to go this route, we should
a) make this nav fixed and collapsible, and/or
b) include a breakpoint and move the nav to the left at some useful (horizontal tablet/desktop-ish) width
from kss-node.
Integrating ish into the default template might be desirable as well. http://bradfrostweb.com/blog/post/ish/
from kss-node.
Made a very rough sketch of my idea. The left nav overlays the content area and drop-down with the burger menu button; it is open by default when the page is open.
from kss-node.
While fixing #150, I cleaned up the CSS in the original template. Closing this and moving "add ish" to a new issue.
from kss-node.
Related Issues (20)
- 3 level navigation
- An in-range update of twig is breaking the build 🚨 HOT 1
- How can I forward options into twig.js?
- ScrollSpy conflict
- Define styleguide components in the template directly HOT 2
- Generate example html from SASS? HOT 1
- Use different builders for different sections of the styleguide?
- Does not work if not installed globally
- v3.0.1 failing with permissions issues HOT 6
- v.3.0.0 Update may require relative path changes to projects HOT 1
- kss not recognizing handlebars code HOT 1
- v3.0.1 outputs: "Version 9 of Highlight.js has reached EOL" HOT 9
- Node versions >= 14
- Update SASS in kss-node-handlebars-builder
- Add option to load JavaScript in rendered styleguide as ES6 module HOT 1
- Extending handlebars helpers not working. v3.1.0 HOT 1
- Question: Do I need to write any javascript to extend handlebars to register partials? HOT 2
- Can I show variables with encoded SVG icons in the styleguide without hard-coding the values?
- ::selection as a modifier HOT 1
- kss-node multiple markup on page?
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from kss-node.