React Rock

React-Rock is a lightweight package for managing global state in React applications. It simplifies handling data by providing a store with rows and metadata, while offering methods to perform CRUD operations and more. It enables easy integration with React components, making it an ideal solution for managing complex state in large applications.

Installation

To install the React-Rock package, run the following command in your project:

npm install react-rock

Features

• Global Store Management: Manage rows and meta data in a global store.
• CRUD Operations: Perform create, read, update, and delete operations on rows.
• Meta Management: Set, get, and delete meta data.
• Optimized Re-renders: Control component re-renders with the freeze option.
• Class Component Support: Use the StoreComponent for integrating store data into class components.

Basic Example: Creating a Store and Adding Records

To create a new store and add a record, use the createStore function. Here's an example:

import { createStore } from 'react-rock';

// Define RowType and MetaType
type RowType = { name: string, age: number };
type MetaType = { totalRecords: number };

// Create a store
const users = createStore<RowType, MetaType>({ name: '', age: 0 }, { totalRecords: 0 });

// Add a new row to the store
users.create({ name: 'John Doe', age: 30 });

RowType Explained

When a row is created, it will have the following properties:

type RowType<Row> = Row & {
    _id: string;       // Unique identifier for the row
    _index: number;    // Index of the row in the store
    _observe: number;  // Internal property to track changes
}

Each row will include the original data (Row) and some additional properties like _id, _index, and _observe.

Methods

Here’s a table with all available methods and their descriptions:

Example of the find Method

The find method allows you to search for rows in the store based on specific conditions:

npm install react-rock

Re-rendering in React Components

React-Rock optimizes re-renders by offering a freeze mechanism. When a store update occurs and the freeze option is enabled, React components that access the store using methods like find or findFirst will not automatically re-render. This gives you control over when your components should re-render, improving performance in large applications.

WhereType

The WhereType is used to specify conditions when querying rows. It defines a query structure for filtering rows.

QueryValueType

The QueryValueType is used within WhereType to define possible conditions for querying:

Example of WhereType

import { createStore } from 'react-rock';

// Define RowType and MetaType
type RowType = { name: string, age: number };
type MetaType = { totalRecords: number };

// Create a store
const users = createStore<RowType, MetaType>({ name: '', age: 0 }, { totalRecords: 0 });

// Add a new row to the store
users.create({ name: 'John Doe', age: 30 });

ArgsType

The ArgsType defines options for customizing query behavior, such as selecting specific rows or skipping rows.

Example with Class Component

To use the store in a class component, extend the StoreComponent class:

npm install react-rock

CRUD Example

import { createStore } from 'react-rock';

// Define RowType and MetaType
type RowType = { name: string, age: number };
type MetaType = { totalRecords: number };

// Create a store
const users = createStore<RowType, MetaType>({ name: '', age: 0 }, { totalRecords: 0 });

// Add a new row to the store
users.create({ name: 'John Doe', age: 30 });

Examples with find and Query

type RowType<Row> = Row & {
    _id: string;       // Unique identifier for the row
    _index: number;    // Index of the row in the store
    _observe: number;  // Internal property to track changes
}

Example of Using the Store in Multiple Components

React-Rock allows you to share the same store across multiple components, ensuring a consistent state throughout the app:

const foundUsers = users.find({ name: { equalWith: 'John Doe' } });
console.log(foundUsers);

Explanation of Types

• RowType: Represents a record with an _id, _index, and _observe along with user-defined data fields.
• ArgsType: Defines the options for querying rows with flexibility like skipping, taking, and custom row processing.
• WhereType: Represents the conditions for querying records, using fields like contain, equalWith, and range queries like gt, lt, etc.
• QueryValueType: Specifies the allowed condition types for filtering rows based on field values.

License

This package is licensed under the MIT License.

This documentation should provide a concise overview of how to use the react-rock package effectively.

? Contributing

Contributions are welcome! Please check out the contribution guidelines.

? License

This project is licensed under the MIT License.

The above is the detailed content of React Rock. For more information, please follow other related articles on the PHP Chinese website!