1.0.9 • Published 4 years ago

desire-ui v1.0.9

Weekly downloads
-
License
MIT
Repository
-
Last release
4 years ago

Usage

Import

Install this package via

npm install desire-ui

Theming

This package requires theming similar to @material/core.

  • Create a setup file e.g. Theme.js
  • Declare your theme

    import {
      addColor,
      addPrimaryColor,
      addSecondaryColor,
      createTheme,
      finalizeMaterialTheme,
      setFontfamily,
    } from 'desire-ui';
    
    // create Theme
    export let theme = createTheme();
    
    // add colors, fonts here
    addPrimaryColor(theme, '#56aa12');
    addSecondaryColor(theme, '#566');
    addColor(theme, 'mainColor', '#187420');
    addColor(theme, 'accentColor', '#159');
    setFontfamily(theme, 'Arial, Helvetica, sans-serif');
    
    // finalize
    theme = finalizeMaterialTheme(theme);
  • Wrap your DesireComponents with the provided ThemeProvider

    import { ThemeProvider } from 'desire-ui';
    import { theme } from '../../Theme';
    <ThemeProvider theme="{theme}"> /* Desire Components */ </ThemeProvider>

Components

Jobs

Jobs are elements that give the user an overview of the current jobs status, e.g. the currently produced parts or the deadline when the job is due.

Jobs can be used as standalone elements or can be wrapped inside a JobList, e.g.:

import { Job, JobList, ThemeProvider } from 'desire-ui';
<JobList>
  {jobs.map((job: JobType) => (
  <Job
    key="{job.id}"
    deadline="{job.deadline}"
    description="{job.description}"
    backgroundColorMain="{job.backgroundColorMain}"
    backgroundColorAccent="{job.backgroundColorAccent}"
    parts="{job.parts}"
    user="Thomas"
    icon="{job.icon}"
  />
  ))}
</JobList>

The full job interface:

NameTypeDescription
deadlineDateThe time when the job is due.
descriptionstringThe description of the job.
iconReactElementThe icon rendered above the job as an ReactElement.
backgroundColorAccentstringThe accent color.
backgroundColorMainstringThe main color.
jobTitle?stringThe title of the job.
parts?numberThe amount of parts to be produced.
currentlyProducedParts?numberThe amount of parts that already have been produced.
expectedDuration?numberThe expected duration in minutes for the job to finish all parts.
user?stringThe user's name responsible for the job.
position?numberThe jobs displayed position within the job list.
active?booleanThe active state of the job.
activeBackgroundColorAccent?stringThe accent color, when active prop is set to true.
activeBackgroundColorMain?stringThe main color, when active prop is set to true.

MinMaxInput

Min Max Input Component is a numerical input which has to be between a Minimum and a Maximum

import { MinMaxInput } from 'desire-ui';
<MinMaxInput label="label" minValue="{0}" maxValue="{10}" handleSubmit="{setInput()}" />

The full job interface:

NameTypeDescription
labelstringThe Label of the Input
minValuenumberThe minimum Value the input has to be above
maxValuenumberThe maximum Value the input has to be above
handleSubmit(input: number) => void;The function, which gets triggered on submit
1.0.9

4 years ago

1.0.7

4 years ago

1.0.6

4 years ago

1.0.5

4 years ago

1.0.2

4 years ago

1.0.1

4 years ago

1.0.4

4 years ago

1.0.0

4 years ago