flawless-ui v1.1.37

FLAWLESS-UI

FlawLess UI is a react Library build to make developing a perfect UI easy

Features

• Network
• Conditional

Network

It handles loading and feedback for HTTP requests.

Config

First you need to install axios

npm i axios

then you can create an axios instance and pass it to the config file and pass it to the FlawLessUI component

const instance = axios.create({
    baseURL: BASE_URL,
})

import { FlawLessUI, createConfig } from 'flawless-ui'

const config = createConfig({
    axiosInstance: instance,
})

const root = ReactDOM.createRoot(
  document.getElementById('root') as HTMLElement
)
root.render(
  <FlawLessUI config={config}>
    <App />
  </FlawLessUI>
)

You can also pass functions to be called in the axios request life cycle

const instance = axios.create({
    baseURL: BASE_URL,
})

import { FlawLessUI, createConfig } from 'flawless-ui'

const config = createConfig({
    axiosInstance: {
        instance: instance,
        onConfig: (config: AxiosRequestConfig<any>) => {
            // Add parameters you want to config
            return config
        }, 
        onConfigError: (error: any) => {
            // catch the error
            throw new error
        },
        onResponse: (response: AxiosResponse<any, any>) => {
            return response
        },
        onResponseError: (error: any) => {
            // catch the error
            throw new error
        },
    },
})

Components

• Loading
• HttpFeedback

Hooks

• useLoading

Variants

• Multiple Axios Instances

Loading

It handles loading for the given url

useEffect(() => {
    getData()
}, [])

const getData = async () => {
  await api.get(URL)
}

return (
    <Loading url={URL}>
        {(loading: boolean) => (
            <>
              {loading ? 'loading' : 'done'}
            </>
         )}
     </Loading>
)

HttpFeedback

First you should create your Alert components and pass to the to the config file

Config

import { createConfig } from 'flawless-ui'

const config = createConfig({
    ...restOfConfig,
    components: {
        alerts: {
          success: (props: AlertI) => <div>S - {props.title} - {props.message}<button onClick={props.onClose}>close</button></div>,
          error: (props: AlertI) => <div>E - {props.title} - {props.message}<button onClick={props.onClose}>close</button></div>,
        },
    },
})

Http Methods

By default HttpFeedback handles error for all request but success for only post, put, patch and delete requests. You can change this how ever by passing an array of methods to the httpMethods of config

import { createConfig, HTTP_METHODS } from 'flawless-ui'

const config = createConfig({
  ...restOfConfig,
  httpMethods: [...HTTP_METHODS, 'get'],
})

Then you can use it like this

useEffect(() => {
    getData()
}, [])

const getData = async () => {
  await api.get('seed/picsum/200/300')
}

return (
    <HttpFeedback 
        url={URL}
    />
)

The message and title passed to the alert component come from 3 methods:

• onError and onSuccess props
• success and error key value pairs in config
• status code message from config

onError and onSuccess props

If these functions return an object with a message key value pair it will be passed to the alert component

<HttpFeedback 
    url={URL}
    onError={data => ({message: data.errorMessage, title: 'Error'})
/>

Status Code Messages

You can use the default STATUS_CODE_MESSAGES that are already in the config file or you change the messages to you liking

useLoading

If not given a url it will return true if any request is being made or if given a url only returns true for that url

const loading = useLoading()

return (
    <>
        {loading ? 'loading' : 'done'}
    </>
)

Multiple Axios Instances

You can have multiple axios instances in the same app. You can have one primary instance and unlimited secondary instances.

Config

You can pass the secondary axios instances to the secondaryAxiosInstances in the config as an array.

const primaryInstance = axios.create({
    baseURL: BASE_URL,
})

const secondaryInstance = axios.create({
    baseURL: SECONDARY_BASE_URL,
})

import { FlawLessUI, createConfig } from 'flawless-ui'

const config = createConfig({
    axiosInstance: primaryInstance,
    secondaryAxiosInstances: [secondaryInstance],
})

Usage

For the Network component and hooks to work for the URLs of an secondary instance you should also pass the base URL of that instance.

import secondaryInstance from 'api'

const BASE_URL = secondaryInstance.defaults.baseURL

// useLoading hook
const loading = useLoading(URL, BASE_URL)

// Loading component
<Loading url={URL} baseUrl={BASE_URL}>
    {(loading: boolean) => (
        <>
          {loading ? 'loading' : 'done'}
        </>
     )}
</Loading>

// HttpFeedback component
<HttpFeedback 
    url={URL}
    baseUrl={BASE_URL}
/>

Conditional

Group of components helping you in rendering components from lists or expressions.

Components

• Show
• IfElse
• For
• Switch

Show

Renders chilrend props if when prop is true

<Show when={expression}>
    {jsx}
</Show>

IfElse

If want to have a if-else statemnet you can wrap your <Show /> components with this. it will only render the first <Show /> component that has a true expression in its when prop

<IfElse>
    <Show when={expression}>
        {jsx}
    </Show>
    <Show when={expression}>
        {jsx}
    </Show>
    <Show when={expression}>
        {jsx}
    </Show>
</IfElse>

For

Has a variaty of ways to help you render an array with ease

<For list={array}>
    {item => (
        {jsx}
    )}
</For>

If you have small changes in your jsx depending on the index or it being the first or last item you can use it like this

<For list={array}>
    {(item, index, isFirst, isLast) => (
        {jsx}
    )}
</For>

If your jsx is completely for first or last item you can pass their function in the firstItem and lastItem. They will render in the correct place and it won't render again in the children function

<For 
    list={array}
    firstItem={item => ({jsx})}
    lastItem={item => ({jsx})}
>
    {item => (
        {jsx}
    )}
</For>

Switch

Works just like a normal switch case

<Switch expression={variable}>
    <Case value={value1} break>
        {jsx}
    </Case>
    <Case value={value2}>
        {jsx}
    </Case>
    <Case default>
        {jsx}
    </Case>
</Switch>