simple-widgets

A Collection of components to make your React code simpler.

Supports React 17.02 and React 18.x

---

From Synk Reports:

H - word-wrap Regular Expression Denial of Service (ReDoS) Vulnerability

CWE-1333 CVE-2023-26115 CVSS 7.5 HIGH SNYK-JS-WORDWRAP-3149973

Introduced through: pdfmake@0.2.7 Exploit maturity: PROOF OF CONCEPT

Introduced through: simple-widgets@1.35.4 › pdfmake@0.2.7 › @foliojs-fork/linebreak@1.1.1 › brfs@2.0.2 › static-module@3.0.4 › escodegen@1.14.3 › optionator@0.8.3 › word-wrap@1.2.3 Fix: No remediation path available.

---

Breaking Changes:

• 2025-01-15 Simple-Widgets version 1.42.0 CSS files will not be automatically imported anymore. This will make it easier for the user to override CSS files from the default CSS settings.

  The following import will need to be placed in the index.js file (to fix the break change):

  1import '../node_modules/simple-widgets/lib/index.css'

  See the section on CSS File Information.

• 2023-06-05 Simple-Widgets version 1.35.0 <Form> and <FormFields> now calls the App supplied formDictionary() passing a string instead of the previous argument {formName: string}. Below is the code change needed to be compatable with previous versions of simple-widgets. Moving forward, the App supplied formDictionary() can expest a single string.

  1// in src/App.js
  2        setAppSpecificInfo({dbStruct, formDictionary, namedQueries})
  3
  4// in src/entry/formDictionary.js
  5const formDictionary = (search) => {
  6
  7    const formName = (typeof search === 'object') ? search.formName : formName
  8     // old version of simple-widgets did a structure
  9     // simple-widgets v1.35.0 it is now a string

  Why the breaking change?

  Origial idea was the ability to search by different elements in each entry in the dictionary (gqlName, db table name, etc.) This was before introducing the concept of named forms (to support forms refereenced within other forms, records and child records). Since forms are uniquely named and the primary form name is provided to <Form> and <FormFields> this change cleans up the design.

• 2021-09-01 DatePicker, DatePickerStyle, UnstyledDatePicker are now obsolete please used DateInput instead (same React props)

• last version (1.11.3) of simple-widgets to have DatePicker, DatePickerStyle, UnstyledDatePicker npm install --save simple-widgets@1.11.3

Planned removal:

• dropping makeChangeHandler from library (It assumes React Component style 'this', not React components using React Hooks)

---

Installation

Using npm:

1    npm install --save simple-widgets

or yarn:

1    yarn add simple-widgets

---

Dependencies not bundled with Simple Widgets

In order to use simple-widgets, these dependencies need to be added in the home directory of your project.

1npm i @apollo/client @types/react axios deep-object-diff graphql-tag object-sizeof react react-dom --save

How to test the library locally (before publishing to npm)

1cd ~/projects/simple-widgets
2npm run build
3npm pack
4
5cd ~/projects/testProject
6npm install  ~/projects/simple-widgets/simple-widgets-1.33.11.tgz
7

Input Components

CheckBox, Choice, ChoiceText, List, Radio, DatePicker, DoubleListBox

Some of the basic HTML input field types reqire different functions to handle changes. This collection of inputs is built on top of those to give a simpler standard interface. All of these widgets require the following props:

• name: A unique name for this field with corresponding name in the parent compoent's state example name="subject"
• value: where the input value come from example value={this.state.subject}
• onChange: function in the parent component to catch/store state changes example onChange={this.handleChange}
• choices: and a array of Strings as pull down choices
• selectedValue: want the 'value' should change to when the CheckBox or Radio button is selected
• text: a label (String or component) displayed following the CheckBox or Radio button

Release Notes

1.32.0 1.33.0 1.33.1 1.34.0

Component Documents

Accordion
AlertModal
AppCore
Browser Detect
Carousel
CheckBox
CheckBoxGroup
Choice
ChoiceText
ChoiceTextSearchable
Common Functions
ConfirmModal
ContextMenu
CSS Rule Functions
Date Functions
DoubleListBox
Entry Form is used to help line up components in a form.
ErrorModal
Header
InputFile
Invalid
Link
List
MenuBar
Menu Utils
Modal
OpenTab
Outline
PageTitle
ProgressCircles
Radio
Redirect
Scroll Functions
Search Functions
SearchSortTable Basics
SearchSortTable
SimpleTable
Slider
SpreadSheet
StatusBox
TextArea
TextAreaError
Theme
XButton

Getting Started_

• Short Tutorial
• Example Project

CSS File Information

Using CSS Files

Build and Publish

1. npm run pack
2. npm run dry
3. npm run pub

Contributing

Martin A. Jackson

Jim Abele