-
Notifications
You must be signed in to change notification settings - Fork 677
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
15 changed files
with
1,167 additions
and
250 deletions.
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -13,7 +13,8 @@ Quickly build and design new UI without writing css. | |
* It should be easy to change any interface or part of an interface without breaking any existing interfaces | ||
* Doing one thing extremely well promotes reusability and reduces repetition | ||
* Documentation helps promote reusability and shared knowledge | ||
* Css is global. Html is not. Send the smallest amount of code to the user as possible. | ||
* Css shouldn't impede accessibility or the default functionality of Html | ||
* You should send the smallest possible amount of code to the user | ||
|
||
## Features | ||
|
||
|
@@ -23,7 +24,7 @@ Quickly build and design new UI without writing css. | |
* Multiple debugging utilities to reduce layout struggles | ||
* Single-purpose class structure | ||
* Optimized for maximum gzip compression | ||
* Lightweight (~13kB) | ||
* Lightweight (~14kB) | ||
* Usable across projects | ||
* Growing open source component library | ||
* Works well with plain html, react, ember, angular, rails, and more | ||
|
@@ -40,15 +41,14 @@ The modules are generally pretty small and thus quick and easy to read. | |
The quickest and easiest way to start using tachyons is to include a reference | ||
to the minified file in the head of your html file. | ||
|
||
Currently the latest version is 4.5.4 | ||
```html | ||
<link rel="stylesheet" href="https://unpkg.com/[email protected]/css/tachyons.min.css"> | ||
``` | ||
|
||
You can always grab the latest version with | ||
```html | ||
<link rel="stylesheet" href="https://unpkg.com/tachyons/css/tachyons.min.css"> | ||
``` | ||
You can also specify a specific version. The latest version is 4.6.0 | ||
```html | ||
<link rel="stylesheet" href="https://unpkg.com/[email protected]/css/tachyons.min.css"> | ||
``` | ||
|
||
### Local Setup | ||
|
||
|
@@ -68,16 +68,27 @@ running | |
|
||
```npm start``` | ||
|
||
This will output both minified and unminified versions of the css to the css directory. | ||
|
||
If you want to recompile everything from src everytime you save a change - you can run the following command, which will compile and minify the css | ||
This will output both minified and unminified versions of the css to the css directory and watch the src directory for changes. | ||
It's aliased to the command: | ||
|
||
```npm run build:watch``` | ||
|
||
If you'd like to just build the css once without watching the src directory run | ||
|
||
```npm run build``` | ||
|
||
If you want to check that a class hasn't been redefined or 'mutated' there is a linter to check that all of the classes have only been defined once. This can be useful if you are using another library or have written some of your own css and want to make sure there are no naming collisions. To do this run the command | ||
|
||
```npm run mutations``` | ||
|
||
## Docs | ||
The tachyons docs located at http://tachyons.io are all open source and located at https://github.com/tachyons-css/tachyons-css.github.io | ||
|
||
You can clone the docs and use them as a template for documenting your own design system / patterns / components. | ||
While not everything is automated, the component library generation makes it extremely easy to | ||
generate and organize the documentation for components as demonstrated at http://tachyons.io/components | ||
|
||
|
||
## Contributing | ||
|
||
Please read our [code of conduct](https://github.com/tachyons-css/tachyons/blob/master/code-of-conduct.md) for contributors. | ||
|
@@ -88,8 +99,10 @@ Please read our [code of conduct](https://github.com/tachyons-css/tachyons/blob/ | |
* https://nicenice.co | ||
* https://coralproject.net | ||
* https://goldenstaterecord.com | ||
* http://www.sogol.co | ||
* https://segment.com | ||
* http://hicuties.com | ||
* https://urlbox.io | ||
* https://community.algolia.com/wordpress/ | ||
* http://studiocraft.cc | ||
* http://samueldregan.com | ||
|
@@ -133,7 +146,6 @@ Please read our [code of conduct](https://github.com/tachyons-css/tachyons/blob/ | |
* https://adventuretron.org | ||
* https://uptimeumbrella.com | ||
* http://www.talbs.me | ||
* https://urlbox.io | ||
* http://seanoshea.me | ||
* https://www.hiaida.com | ||
* http://maxogden.github.io/screencat/ | ||
|
@@ -149,7 +161,6 @@ Please read our [code of conduct](https://github.com/tachyons-css/tachyons/blob/ | |
* http://mrmrs.io/writing | ||
* http://mrmrs.cc | ||
* http://mn-ml.cc | ||
* http://devday-ar.com/ | ||
|
||
And of course... | ||
* http://tachyons.io | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,135 @@ | ||
/* | ||
ASPECT RATIOS | ||
*/ | ||
|
||
/* This is for fluid media that is embedded from third party sites like youtube, vimeo etc. | ||
* Wrap the outer element in aspect-ratio and then extend it with the desired ratio i.e | ||
* Make sure there are no height and width attributes on the embedded media. | ||
* Adapted from: https://github.com/suitcss/components-flex-embed | ||
* | ||
* Example: | ||
* | ||
* <div class="aspect-ratio aspect-ratio--16x9"> | ||
* <iframe class="aspect-ratio--object"></iframe> | ||
* </div> | ||
* | ||
* */ | ||
|
||
.aspect-ratio { | ||
height: 0; | ||
position: relative; | ||
} | ||
|
||
.aspect-ratio--16x9 { padding-bottom: 56.25%; } | ||
.aspect-ratio--9x16 { padding-bottom: 177.77%; } | ||
|
||
.aspect-ratio--4x3 { padding-bottom: 75%; } | ||
.aspect-ratio--3x4 { padding-bottom: 133.33%; } | ||
|
||
.aspect-ratio--6x4 { padding-bottom: 66.6%; } | ||
.aspect-ratio--4x6 { padding-bottom: 150%; } | ||
|
||
.aspect-ratio--8x5 { padding-bottom: 62.5%; } | ||
.aspect-ratio--5x8 { padding-bottom: 160%; } | ||
|
||
.aspect-ratio--7x5 { padding-bottom: 71.42%; } | ||
.aspect-ratio--5x7 { padding-bottom: 140%; } | ||
|
||
.aspect-ratio--1x1 { padding-bottom: 100%; } | ||
|
||
.aspect-ratio--object { | ||
position: absolute; | ||
top: 0; | ||
right: 0; | ||
bottom: 0; | ||
left: 0; | ||
width: 100%; | ||
height: 100%; | ||
z-index: 100; | ||
} | ||
|
||
@media (--breakpoint-not-small){ | ||
.aspect-ratio-ns { | ||
height: 0; | ||
position: relative; | ||
} | ||
.aspect-ratio--16x9-ns { padding-bottom: 56.25%; } | ||
.aspect-ratio--9x16-ns { padding-bottom: 177.77%; } | ||
.aspect-ratio--4x3-ns { padding-bottom: 75%; } | ||
.aspect-ratio--3x4-ns { padding-bottom: 133.33%; } | ||
.aspect-ratio--6x4-ns { padding-bottom: 66.6%; } | ||
.aspect-ratio--4x6-ns { padding-bottom: 150%; } | ||
.aspect-ratio--8x5-ns { padding-bottom: 62.5%; } | ||
.aspect-ratio--5x8-ns { padding-bottom: 160%; } | ||
.aspect-ratio--7x5-ns { padding-bottom: 71.42%; } | ||
.aspect-ratio--5x7-ns { padding-bottom: 140%; } | ||
.aspect-ratio--1x1-ns { padding-bottom: 100%; } | ||
.aspect-ratio--object-ns { | ||
position: absolute; | ||
top: 0; | ||
right: 0; | ||
bottom: 0; | ||
left: 0; | ||
width: 100%; | ||
height: 100%; | ||
z-index: 100; | ||
} | ||
} | ||
|
||
@media (--breakpoint-medium){ | ||
.aspect-ratio-m { | ||
height: 0; | ||
position: relative; | ||
} | ||
.aspect-ratio--16x9-m { padding-bottom: 56.25%; } | ||
.aspect-ratio--9x16-m { padding-bottom: 177.77%; } | ||
.aspect-ratio--4x3-m { padding-bottom: 75%; } | ||
.aspect-ratio--3x4-m { padding-bottom: 133.33%; } | ||
.aspect-ratio--6x4-m { padding-bottom: 66.6%; } | ||
.aspect-ratio--4x6-m { padding-bottom: 150%; } | ||
.aspect-ratio--8x5-m { padding-bottom: 62.5%; } | ||
.aspect-ratio--5x8-m { padding-bottom: 160%; } | ||
.aspect-ratio--7x5-m { padding-bottom: 71.42%; } | ||
.aspect-ratio--5x7-m { padding-bottom: 140%; } | ||
.aspect-ratio--1x1-m { padding-bottom: 100%; } | ||
.aspect-ratio--object-m { | ||
position: absolute; | ||
top: 0; | ||
right: 0; | ||
bottom: 0; | ||
left: 0; | ||
width: 100%; | ||
height: 100%; | ||
z-index: 100; | ||
} | ||
} | ||
|
||
@media (--breakpoint-large){ | ||
.aspect-ratio-l { | ||
height: 0; | ||
position: relative; | ||
} | ||
.aspect-ratio--16x9-l { padding-bottom: 56.25%; } | ||
.aspect-ratio--9x16-l { padding-bottom: 177.77%; } | ||
.aspect-ratio--4x3-l { padding-bottom: 75%; } | ||
.aspect-ratio--3x4-l { padding-bottom: 133.33%; } | ||
.aspect-ratio--6x4-l { padding-bottom: 66.6%; } | ||
.aspect-ratio--4x6-l { padding-bottom: 150%; } | ||
.aspect-ratio--8x5-l { padding-bottom: 62.5%; } | ||
.aspect-ratio--5x8-l { padding-bottom: 160%; } | ||
.aspect-ratio--7x5-l { padding-bottom: 71.42%; } | ||
.aspect-ratio--5x7-l { padding-bottom: 140%; } | ||
.aspect-ratio--1x1-l { padding-bottom: 100%; } | ||
.aspect-ratio--object-l { | ||
position: absolute; | ||
top: 0; | ||
right: 0; | ||
bottom: 0; | ||
left: 0; | ||
width: 100%; | ||
height: 100%; | ||
z-index: 100; | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.