react-stylux-text
v0.2.5
Published
The headings and paragraph mechanic of react-stylux
Downloads
4
Readme
react-stylux
This project is part of the larger react-stylux library.
This is currently a very alpha stage project, documentation will be lack luster for a few weeks. Please stand by while testing occurs. Responsive implementation is in its infancy and will continue to improve. There are currently three sizes, please see Responsive notes for more information.
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
Prerequisites
npm install --save react-stylux-text
How To Use Stylux
Table of Contents
- What's included
- Step by Step
- Animation Notes
- Responsive Notes
- Text
- Feature Wish List
- Acknowledgments
- Changelog
Included in the text version of react-stylux is:
- H1 1-5
- H2 1-5
- H3 1-5
- H4 1-5
- P (Paragraphs) 1-5
- PLQ (Pull Quotes) 1-2
Currently not done:
- Pull Quote 1
- Pull Quote 2
Step by step:
Stylux utilizes three main components and flex-box to handle layouts effectively. As an example, import Container, Holder, and Navbar1:
import {
Container,
Holder,
NavBar1,
} from 'react-stylux';
Now you can use these components like any other component!
<Container>
<Holder>
<NavBar1>
<a href="">Item1</a>
<a href="">Item2</a>
<a href="">Item3</a>
</NavBar1>
<NavBar1>
<a href="facebook.com"></a>
<a href="twitter.com"></a>
<a href="instagram.com"></a>
</NavBar1>
</Holder>
</Container>
Children are passed into the block level component to render based on type. In the example above, NavBar1 is used in conjunction with Holder1. This will create two spaces, and create two navbars center aligned. As a special note, every navbar block is hooked up with a className to psuedo render a logo based on href/to address info using the font awesome library.
props can be passed into every item to further create a custom expierence:
<Container>
<Holder
block1="2">
<NavBar1>
<a href="">Item1</a>
<a href="">Item2</a>
<a href="">Item3</a>
</NavBar1>
<NavBar1
align="flex-end"
navbarWidth="60%">
<a href="facebook.com"></a>
<a href="twitter.com"></a>
<a href="instagram.com"></a>
</NavBar1>
</Holder>
</Container>
This is just a basic example of what can be done with stylux. Basic documentation on the current blocks can be seen below, a more comprehensive website is currently being worked on.
Documentation:
Each element will be shown with an example of the possible props equal to the default props, if no default is set then the prop will have no equals. Each elements will then be shown is an example of children accepted.
Animation Notes:
The animation library is currently mostly from: animate.css, please see Acknowledgments for full acknowledgment.
defaults
all blocks have access to:
- animationIterationCount in the form of: props.aniCount,
- animationTimingFunction in the form of: props.aniTime,
- animationName in the form of: props.aniName,
- animationDuration in the form of: props.aniDur,
- transformOrigin in the form of: props.transformOrigin,
animate.css recommends the following defaults: aniDur ='1s' aniFillMode = 'both'
if wanting an infinite animation: aniCount = 'infinite'
Animation Names
to see what these do, please refer to animation Acknowledgments or go to http://daneden.me/animate each animation will be associated with suggested defaults, these will be improved as more testing is accomplished.
- bounce
- transform-origin: center bottom
- pulse
- handShake
- animation-timing-function: ease-in-out
- jello
- transform-origin: center
- bounceIn
- animation-duration: 0.75s
- bounceInDown
- bounceInLeft
- bounceInRight
- bounceInUp
- bounceOut
- bounceOutLeft
- bounceOutRight
- bounceOutUp
- fadeIn
- fadeOut
- flipInX (needs better integration)
- flipInY (needs better integration)
- flipOutX (needs better integration)
- flipOutY (needs better integration)
- hinge
- animation-duration: 2s
- slideInLeft
- slideInRight
- slideOutLeft
- slideOutRight
Responsive Notes:
There are two breakpoints on the follow elements:
- headings
- paragraphs
Small Breakpoint:
use this through props as: smdis the breakpoint for this is currently set at max-width: 440px (subject to change)
Medium Breakpoint:
use this through props as: mddis the breakpoint for this is currently set at min-width: 441px and max-width: 760px (subject to change)
Text Specific
Headings (all names subject to change)
large size: Each of these headings follow a specific pattern:
- 1: Base Version - 1.333 * 1.618ish
- 2: Smaller Version - num/1.2ish
- 3: Larger Version - num * 1.2ish
- 4: Light Gray Base Version
- 5: Open (Possible outline version)
medium size: (not correct calculations) Each of these headings follow a specific pattern:
- 1: Base Version - 1.333 * 1.618ish
- 2: Smaller Version - num/1.2ish
- 3: Larger Version - num * 1.2ish
- 4: Light Gray Base Version
- 5: Open (Possible outline version)
small size: (not correct calculations) Each of these headings follow a specific pattern:
- 1: Base Version - 1.333 * 1.618ish
- 2: Smaller Version - num/1.2ish
- 3: Larger Version - num * 1.2ish
- 4: Light Gray Base Version
- 5: Open (Possible outline version)
MainHeadings
MainHeading1
<H11
color = 'black'
font = 'inherit'
size = '7em'
smSize = '3.939em'
mdSize = '5.25em'
weight = '900'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 15px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H11>This is a Heading</H11>
MainHeading2
<H12
color
font = 'sans-serif'
size = '6em'
smSize = '3.376em'
mdSize = '4.501em'
weight = '900'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 15px 0'
margin = '0'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H12>This is a Heading</H12>
MainHeading3
<H13
color
font = 'sans-serif'
size = '7.5em'
smSize = '4.4em'
mdSize = '5.7em'
weight = '900'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 15px 0'
margin = '0'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H13>This is a Heading</H13>
MainHeading4
<H14
color = 'lightgray'
font = 'sans-serif'
size = '7em'
smSize = '3.939em'
mdSize = '5.25em'
weight = '900'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 15px 0'
margin = '0'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor = 'lightgray'
>
This accepts and renders one child
<H14>This is a Heading</H14>
MainHeading5
<H15
color
stroke = '3px'
font = 'sans-serif'
size = '7em'
smSize = '3.939em'
mdSize = '5.25em'
weight = '900'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 15px 0'
margin = '0'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H15>This is a Heading</H15>
Headings
Heading1
<H21
color
font = 'sans-serif'
size = '5.646em'
smSize = '3em'
mdSize = '4em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '0'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H21>This is a Heading</H21>
Heading2
<H22
color
font = 'sans-serif'
size = '4.705em'
smSize = '2.7em'
mdSize = '3em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H22>This is a Heading</H22>
Heading3
<H23
color
font = 'sans-serif'
size = '6.1em'
smSize = '3.5em'
mdSize = '4.5em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H23>This is a Heading</H23>
Heading4
<H24
color = 'lightgray'
font = 'sans-serif'
size = '5.646em'
smSize = '3em'
mdSize = '4em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor = 'lightgray'
>
This accepts and renders one child
<H24>This is a Heading</H24>
Heading5
<Heading5
color
stroke = '3px'
font = 'sans-serif'
size = '5.646em'
smSize = '3em'
mdSize = '4em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H25>This is a Heading</H25>
SubHeadings
SubHeading1
<H31
color
font = 'sans-serif'
size = '3.489em'
smSize = '2.5em'
mdSize = '3em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H31>This is a Heading</H31>
SubHeading2
<H32
color
font = 'sans-serif'
size = '2.9075em'
smSize = '2em'
mdSize = '2.5em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H32>This is a Heading</H32>
SubHeading3
<H33
color
font = 'sans-serif'
size = '3.9em'
smSize = '3em'
mdSize = '3.5em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H33>This is a Heading</H33>
SubHeading4
<H34
color = 'lightgray'
font = 'sans-serif'
size = '3.489em'
smSize = '2.5em'
mdSize = '3em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor = 'lightgray'
>
This accepts and renders one child
<H34>This is a Heading</H34>
SubHeading5
<H35
color
stroke = '3px'
font = 'sans-serif'
size = '3.489em'
smSize = '2.5em'
mdSize = '3em'
weight = '600'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 5px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H35>This is a Heading</H35>
SubHeadings
SecondarySubHeading1
<H41
color
font = 'sans-serif'
size = '3.489em'
smSize = '2.5em'
mdSize = '3em'
weight = '100'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 3px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H41>This is a Heading</H41>
SecondarySubHeading2
<H42
color
font = 'sans-serif'
size = '2.9025em'
smSize = '2em'
mdSize = '2.5em'
weight = '100'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 3px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H42>This is a Heading</H42>
SecondarySubHeading3
<H43
color
font = 'sans-serif'
size = '3.9em'
smSize = '3em'
mdSize = '3.5em'
weight = '100'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 3px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H43>This is a Heading</H43>
SecondarySubHeading4
<H44
color = 'lightgray'
font = 'sans-serif'
size = '3.489em'
smSize = '2.5em'
mdSize = '3em'
weight = '100'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 3px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor = 'lightgray'
>
This accepts and renders one child
<H44>This is a Heading</H44>
SecondarySubHeading5
<H45
color
stroke = '3px'
font = 'sans-serif'
size = '3.489em'
smSize = '2.5em'
mdSize = '3em'
weight = '100'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '0 0 3px 0'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<H45>This is a Heading</H45>
Paragraphs (all names subject to change)
Each of these paragraphs follow a specific pattern: Large size:
- 1: Base Version - 1.333
- 2: Smaller Version - 0.9
- 3: Larger Version - 1.6
- 4: Light Gray larger Version - 1.6
- 5: Open (Possible dropcap version) - 1.333 medium size:
- 1: Base Version - 1.333
- 2: Smaller Version - 0.9
- 3: Larger Version - 1.6
- 4: Light Gray larger Version - 1.6
- 5: Open (Possible dropcap version) - 1.333 small size:
- 1: Base Version - 1.333
- 2: Smaller Version - 0.9
- 3: Larger Version - 1.6
- 4: Light Gray larger Version - 1.6
- 5: Open (Possible dropcap version) - 1.333
Paragraphs
Paragraph1
<P1
color =
font = 'serif'
size = '1.333em'
smSize = '1.3em'
mdSize = '1.3em'
lineHeight = '1.5em'
weight = '400'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '5px'
margin = '1px'
width = 'inherit'
height
hadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<P1>This is a Heading</P1>
Paragraph2
<P2
color
font = 'serif'
size = '0.95em'
smSize = '0.95em'
mdSize = '0.95em'
lineHeight = '1.22em'
weight = '400'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '5px'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<P2>This is a Heading</P2>
Paragraph3
<P3
color
font = 'serif'
size = '1.6em'
smSize = '1.5em'
mdSize = '1.6em'
lineHeight = '1.8em'
weight = '400'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '5px'
margin = '1px'
width = 'inherit'
height
sShadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<P3>This is a Heading</P3>
Paragraph4
<P4
color = 'lightgray'
font = 'serif'
size = '1.6em'
smSize = '1.5em'
mdSize = '1.6em'
lineHeight = '1.8em'
weight = '400'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '5px'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor = 'lightgray'
>
This accepts and renders one child
<P4>This is a Heading</P4>
Paragraph5
Not Finished
<P5
color
font = 'serif'
size = '1.333em'
smSize = '1.3em'
mdSize = '1.3em'
lineHeight = '1.5em'
weight = '400'
variant
display = 'flex'
align = 'center'
textAlign = 'center'
padding = '5px'
margin = '1px'
width = 'inherit'
height
shadow
bLeft
bRight
bTop
bBottom
border
id
className
aniCount
aniTime
aniName
aniDur
smdis = 'flex'
mddis = 'flex'
hoverColor
>
This accepts and renders one child
<P5>This is a Heading</P5>
Pull Quotes
Not Finished
Pullquote1
Pullquote2
Known Bugs
Will be added soon
Feature Wish List
Will be added soon
Built With
- React - The library used
Code of Conduct
a link should go to the code of conduct
Contributing
No Contributions will be accepted outside of the project team until the project is out of full Alpha Testing
Versioning
for a more detailed list of changes, please refer to the changelog 0.2.4
- best so far
0.2.1
- fixed media queries
Authors
- Christopher Fox -
License
This is licensed under MIT license. If used in any project, please give ackknowledgments to Christoher Fox.
Acknowledgments
- A Giant Thank you to Dev Mountain for teaching me to code good
- A big thank you to Morten Rand-Hendriksen for your videos on flex box and the code that allows the className socialness to work
- Credit to http://meyerweb.com/eric/tools/css/reset/ for use of a reset file
- Credit to the React-Styles team (used as nestingstyles) for the code to allow for media queries through style object
- Massive credit for the animations to Daniel Eden - animate.css - http://daneden.me/animate
Changelog
0.2.4 - react-stylux 0.3.6
- Adding React.Fragment to check it out on Headers & Paragraphs
- Adjusted padding & margin on Paragraphs and Headers
- Added flex: 1 as default to Paragraph and Headers to fill space completely
- Added fontVariant as props.variant for Paragraphs and Headers
0.2.3
- updated to current stable react-stylux version 0.2.9
0.2.2
- Hover states added to headings and paragraphs
- sm and md sizes added on state
- h3 default weight changed to 600
- h4 default weight changed to 100
- added pull quotes styles to superstylesheet
- updated readme for changes
0.2.1
- updated media queries smdis min-wdith = 440px
- updated media queries mddis min-width = 441px
- updated readme