Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

As a user, I want the vars & props for the Button component documented on the site #264

Open
16 of 19 tasks
blazebarsamian opened this issue Jun 22, 2018 · 6 comments
Open
16 of 19 tasks
Assignees
Labels
docs enhancement pinned tickets that shouldnt be deleted until completed and this label is removed

Comments

@blazebarsamian
Copy link
Contributor

blazebarsamian commented Jun 22, 2018

Scenario: Vars Table

  • Create a new folder in /docs-src/src/pages/components called ButtonTables
  • Create a new file in that folder called ButtonVars.js
  • Table details:
    • Table Headers: Variable Name, Default Value, Description
    • On small screens, there should be a Table.HeadStacked that says Button Vars
    • The Table Data should include <Table.HeaderInline>[Column Header]</Table.HeaderInline> before the table data so that the headers shows on small screens when the table stacks.
    • Make sure to check the settings file for any vars that were not listed at the top of the components stylesheet.
  • Import the ButtonVars file into the main example page: /docs-src/src/pages/components/Button.js
  • After the ExampleSection include <h3>Variables:</h3>
  • Then call in the table: <ButtonVars />

Scenario: Props Table

  • Create a new file in the ButtonTables folder called ButtonProps.js
  • Table details:
    • Table Headers: Name, Type, Default, Description
    • On small screens, there should be a Table.HeadStacked that says Button Props
    • The Table Data should include <Table.HeaderInline>[Column Header]</Table.HeaderInline> before the table data so that the header shows on small screens when the table stacks. Example:
    •  <Table.Data>
          <Table.HeaderInline>Name:</Table.HeaderInline> <code>shrink</code>
       </Table.Data>
      
    • Include all possible props (make sure to also check the components file to make sure you didnt miss any props that were not listed on the site.
  • Import the ButtonProps file into the main example page: /docs-src/src/pages/components/Button.js
  • After the Variables section include <h3>Properties:</h3>
  • Then call in the table: <ButtonProps />

screen shot 2018-06-22 at 10 25 23 am

screen shot 2018-06-22 at 10 25 26 am

@blazebarsamian
Copy link
Contributor Author

I've pushed up what I have for this ticket to my branch 264-button-tables.

Props Table:
Ready for someone to take over:

  • Need to double check that I have included all the possible props.
  • Need to double check that the type column has the correct types for each prop.
  • Check that descriptions are accurate + finish filling in the ones that are incomplete

@revelry-stalebot
Copy link

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

@revelry-stalebot
Copy link

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

@blazebarsamian blazebarsamian added the pinned tickets that shouldnt be deleted until completed and this label is removed label May 31, 2019
@revelry-stalebot revelry-stalebot bot removed the stale label May 31, 2019
@blazebarsamian
Copy link
Contributor Author

Props:

  • looks like theres something for button icons (rev-Button-icon) but not entirely sure how to make this work. Might just be because we dont have Icons that work in Harmonium?
  • ButtonGroup has props that add classes but no styles for those classes. I started fixes this but not going to commit those changes on this PR. I created a new ticket Add other ButtonGroup examples + add styles for different ButtonGroup variations #392 to handle ButtonGroup styles.
  • ButtonGroup has a stackedForSmall prop but theres no styles for that anywhere

Research:

Is it better to have the code rendered out like this:

rev-Button.rev-Button--success, .rev-ButtonGroup--success .rev-Button {
    background: #00A67F;
}

or should I create mixins and include them in 2 different spots so that the code renders out like:

rev-Button.rev-Button--success {
    background: #00A67F;
}

or

.rev-ButtonGroup--success .rev-Button {
    background: #00A67F;
}

@blazebarsamian
Copy link
Contributor Author

blazebarsamian commented Jun 14, 2019

Update:

Today I got all of the props in for both buttons and ButtonGroups. I need to probably double check everything next week before I push up and create a PR.

  • I need to also look into rev-Button-icon because that seems like something that should be added to the example page as well as in the props table.

download (3)

@blazebarsamian
Copy link
Contributor Author

Button icons will be handled in #391

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs enhancement pinned tickets that shouldnt be deleted until completed and this label is removed
Projects
None yet
Development

No branches or pull requests

2 participants