Funda UI

React components using pure Bootstrap 5+ which has undergone complex business testing and is easy to integrate with any API. You can load Bootstrap css libraries separately in your project.

All components have undergone complex business verification and provide multiple examples.

• Documentation

Key Features

1. Simplify the assignment method of diversified data.
2. Components are compatible with gRPC, REST APIs, GraphQL self-packaging, uniformly use Classes and their methods to introduce interfaces
3. Enhanced user interaction, flexible use in asynchronous and synchronous states
4. Introduce appropriate component .css files as needed, only for some components with special needs. Most of them can directly use Bootstrap's official style sheet. Styles are performant and easy to override.
5. Do not embed css-in-js, directly use external CSS styles to completely change the component style.

Components List

Here is a table of the components and their status.

| WEB ELEMENTS | FORMS | INTERACTION | NAVIGATION | LAYOUTS | | --- | --- | --- | --- | --- | | Accordion ✅ | Input ✅ | Infinite Scroll ❏ |Multilevel Dropdown Menu ✅ | MasonryLayout ✅ | | Accordion Slider ❏ | Number Input ✅ | Image Perspective Hover ❏ | Dropdown Menu ✅ | RootPortal ✅ | | Back To Top ✅ | Date ✅🔥 | Mousewheel Interaction ❏ | | Splitter Panel ✅ | | Button ❏ | Tag Input ✅ | Parallax ❏ | | | | Card ❏ | Textarea ✅ | Scroll Reveal ✅ | | | | Content Placeholder ❏ | NativeSelect ✅ | DragDrop List ✅🔥 | | | | Counter ❏ | Cascading Select ✅ | Mode Switch ✅ | | | | Hybrid Content Slider ❏ | Cascading Select End-to-end ✅🔥 | Custom Scrollbar ✅ | | | | Image Shapes ❏ | Radio ✅ | Horizontal Scroll Content ✅ | | | | Lightbox ❏ | Checkbox ✅ | Refresher ✅ | | | | List Bulleted ❏ | Select ✅🔥 | | | | | Modal Dialog ✅🔥 | Live Search ✅ | | | | | Pagination ✅ | File ✅ | | | | | Table ✅🔥 | SearchBar ✅ | | | | | Periodical Scroll ❏ | Switch ✅ | | | | | Progress Bar ❏ | Dynamic Fields ✅🔥 | | | | | Rating ❏ | MultipleCheckboxes ✅ | | | | | Seamless Scrolling Element ❏ | MultipleSelect ✅🔥 | | | | | Show More Less ✅ | Range Slider ✅ | | | | | Slideshow ❏ | Color Picker ✅ | | | | | Tabs ✅ | | | | | | Timeline ❏ | | | | | | Toast ✅ | | | | | | Tooltip ✅ | | | | | | Digital Clock ✅ | | | | | | Tree ✅🔥 | | | | | | Event Calendar ✅🔥 | | | | | | Event Calendar Timeline ✅🔥 | | | | | | Chatbox ✅🔥🤖 | | | | | | Stepper ✅ | | | | | | Popover ✅ | | | | |

Usage

Step 1. You need to install it:

$ npm i funda-ui

Step 2. Using Bootstrap CSS together (recommended)

<link href="./bootstrap.min.css" rel="stylesheet"/>

Step 3. import required components as required

If the component does not have a CSS file, it can not be imported, or use own CSS.

import Input from 'funda-ui/Input';
import Textarea from 'funda-ui/Textarea';
import CascadingSelect from 'funda-ui/CascadingSelect';

// component styles
import 'funda-ui/CascadingSelect/index.css';

or

import { 
    Input,
    Textarea,
    CascadingSelect
} from 'funda-ui';

// component styles
import 'funda-ui/CascadingSelect/index.css';

or

const Input = require('funda-ui').Input;
const Textarea = require('funda-ui').Textarea;
const CascadingSelect = require('funda-ui').CascadingSelect;

// component styles
import 'funda-ui/CascadingSelect/index.css';

Collecting Data

Basic

Use useState() to store data.

import React, { useState } from 'react';
import Input from 'funda-ui/Input';
import Select, { OptionConfig, MultiSelectValue } from 'funda-ui/Select';

// component styles
import 'funda-ui/Select/index.css';


interface Config {
    name: string;
    role: boolean;
}


export default () => {
    // Consolidated config state
    const [config, setConfig] = useState<Config>({
        name: '',
        role: '',
    });

    const updateConfig = (newConfig: Partial<Config>) => {
        setConfig(prev => ({ ...prev, ...newConfig }));
    };
    

    const handleSubmit = (e: React.MouseEvent<HTMLButtonElement>) => {
        e.preventDefault();
        alert(`Name: ${config.name}, Role: ${config.role}`);
    };

    return (
        <form onSubmit={handleSubmit}>
            <div>

                <Input
                    name="name"
                    label="Name"
                    onChange={(e: React.MouseEvent, onComposition: any, el: any, value: string) => {
                        updateConfig({ name: value });
                    }}
                />
            </div>

            <div>
        
                <Select
                    label="Role"
                    placeholder="Select"
                    name="role"
                    options={[
                        {"label": "Admin","value": "admin","queryString": ""},
                        {"label": "User","value": "user","queryString": ""}
                    ]}
                    onChange={(e: React.MouseEvent<HTMLElement> | React.KeyboardEvent<HTMLElement>, e2: HTMLElement, val: OptionConfig | MultiSelectValue): void => {
                        updateConfig({ role: (val as OptionConfig).value });
                    }}
                />

            </div>

            <button className="btn btn-outline-primary btn-sm mb-2" type="submit">Submit</button>
        </form>
    );

}

Advanced

Using vanilla JS to collect the value of name is faster and easier.

import React, { useRef } from "react";
import Input from 'funda-ui/Input';
import Select, { OptionConfig, MultiSelectValue } from 'funda-ui/Select';

// component styles
import 'funda-ui/Select/index.css';

// utils
import { serializeArray } from 'funda-ui/Utils/formdata';
import { isEmpty } from "funda-ui/Utils/validate";

interface FormField {
    name: string;
    value: string;
}

interface FormData {
    [key: string]: string;
}

type CallbackFunction = (formData: FormData) => void;
type ErrorCallbackFunction = () => void;

function customValidate(
    form: HTMLFormElement | HTMLDivElement | null,
    callback?: CallbackFunction,
    errCallback?: ErrorCallbackFunction
): void {
    if (form === null) return;

    const formData: FormData = {};
    const fieldsData: FormField[] = serializeArray(form);
    let fieldsCheck: boolean = true;
    let customFieldsCheck: boolean = true;

    // Step 1: everything is ok  
    //-------------
    // required fields
    const emptyFieldsCheck = fieldsData.every((item: FormField) => {
        if (item.name !== null && item.name !== '') {
            formData[item.name] = item.value;

            const _field = form.querySelector<HTMLElement>(`[name="${item.name}"]`);
            if (!_field) return true;

            const fieldRequired = _field.getAttribute('required');
            if (fieldRequired !== null && fieldRequired !== 'false') {
                if (item.value === '' || isEmpty(item.value)) {
                    const _label = _field.dataset.requiredTitle;
                    alert(`${_label} cannot be empty!`);
                    return false;
                }
            }
        }

        errCallback?.();

        return true;
    });

    //  merged result
    fieldsCheck = [emptyFieldsCheck, customFieldsCheck].every((item: boolean) => {
        return item;
    });

    // Step 2: everything is ok  
    //-------------
    if (fieldsCheck) {
        callback?.(formData);
    }
}



export default () => {
    const formRef = useRef<HTMLDivElement>(null);

    const handleSubmit = (e: React.MouseEvent<HTMLButtonElement>) => {
        e.preventDefault();
   
        customValidate(
            formRef.current, 
            (formData: any[]) => {
                alert(JSON.stringify(formData));
            },
            () => { }
        );

    };

    return (
        <div ref={formRef}>
            <div>

                <Input
                    name="name"
                    label="Name"
                />
            </div>

            <div>
        
                <Select
                    label="Role"
                    placeholder="Select"
                    name="role"
                    options={[
                        {"label": "Admin","value": "admin","queryString": ""},
                        {"label": "User","value": "user","queryString": ""}
                    ]}
                />

            </div>

            <button className="btn btn-outline-primary btn-sm mb-2" type="button" onClick={handleSubmit}>Submit</button>
        </div>
    );

}

Licensing

Licensed under the MIT.