react-stylux-text

0.2.5 • Public • Published

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

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

Readme

Keywords

none

Package Sidebar

Install

npm i react-stylux-text

Weekly Downloads

0

Version

0.2.5

License

MIT

Unpacked Size

250 kB

Total Files

33

Last publish

Collaborators

  • foxchrisrealthe