Comments (5)
I can share the template and the gulpfile from the FamilySearch style guide https://gist.github.com/straker/6cd9923fe1282452f094755fe4be8200
from livingcss.
Awesome thanks for that!
Just out of curiosity, why did FamilySearch decide not to use Polymer when this base app uses it? (I'm trying to weigh the pros and cons of using Polymer for our style guide).
from livingcss.
The FS style guide has complete control over the layout, so it can use all the FS styles without clashing. I created both and I used Polymer in the generic output as it would guarantee that using Shadow DOM would prevent the user stylesheet from overriding global styles in the style guide, causing layout bugs.
from livingcss.
In terms of whether or not to use Polymer (or custom elements), I think there are great pros in that for a style guide. Take for example the complex code needed to use the Person styles from the FS style guide. There is a lot of DOM elements that require specific ordering and classes. And it has a lot of variations that get even more complex.
Requiring devs to have to type that out each time means they have to look at the style guide every time they need to use it (which is a lot). If devs instead just had a single element they could use, the entire process becomes much easier. The devs don't have to worry about DOM order, class names, or even how to do all the variations they need. Instead they just use the custom element, have a simple attribute API to activate the variations, and done.
from livingcss.
Oh is FamilySearch using Polymer in the actual FamilySearch app? I haven't looked at the source code there recently. Or are you using some other framework variation of web components?
from livingcss.
Related Issues (20)
- duplicate @section in different @page causes error HOT 3
- Issue compiling with @doc tag HOT 4
- Upgrade to Gulp 4 HOT 2
- User Contributed templates HOT 3
- Ability to have sub sections broken out in pages HOT 6
- @ bug HOT 2
- Whitespace on tags causing errors
- Description losing markdown HOT 5
- clarifcation please HOT 1
- Ability to create Global collection HOT 1
- Feature idea: namespaces for @examples HOT 4
- Error: The partial mainStylesheet could not be found HOT 4
- Support SCSS HOT 1
- Questions: Custom template and nav structure HOT 2
- Every section a page? HOT 18
- Style tags breaking examples. HOT 3
- Using @ symbol in <pre> code snippets. HOT 2
- Destination `dest` parameter fails due to incorrect relative stylesheet path lookup HOT 1
- Duplicate resolution of promises within util HOT 2
- File creation errors not propogated
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 livingcss.