@modular-forms/qwik/dist/source/methods/insert.js

The modular and type-safe form library for Qwik

import { getFieldArrayNames, getFieldArrayState, getFieldArrayStore, getFieldNames, getFieldState, getPathIndex, getUniqueId, setFieldArrayState, setFieldArrayValue, setFieldState, sortArrayPathIndex, validateIfRequired, } from '../utils';
/**
 * Inserts a new item into the field array.
 *
 * @param form The form of the field array.
 * @param name The name of the field array.
 * @param options The insert options.
 */
export function insert(form, name, options) {
    // Get store of specified field array
    const fieldArray = getFieldArrayStore(form, name);
    // Continue if specified field array exists
    if (fieldArray) {
        // Get length of field array
        const arrayLength = fieldArray.items.length;
        // Destructure options
        const { at: index = arrayLength, value } = options;
        // Continue if specified index is valid
        if (index >= 0 && index <= arrayLength) {
            // If item is not inserted at end, move fields and field arrays of items
            // that come after new item one index further
            if (index < arrayLength) {
                // Create function to filter a name
                const filterName = (value) => value.startsWith(`${name}.`) && getPathIndex(name, value) >= index;
                // Create function to get next index name
                const getNextIndexName = (fieldOrFieldArrayName, fieldOrFieldArrayIndex) => fieldOrFieldArrayName.replace(`${name}.${fieldOrFieldArrayIndex}`, `${name}.${fieldOrFieldArrayIndex + 1}`);
                // Move fields that come after new item one index further
                getFieldNames(form)
                    .filter(filterName)
                    .sort(sortArrayPathIndex(name))
                    .reverse()
                    .forEach((fieldName) => {
                    setFieldState(form, getNextIndexName(fieldName, getPathIndex(name, fieldName)), getFieldState(form, fieldName));
                });
                // Move field arrays that come after new item one index further
                getFieldArrayNames(form)
                    .filter(filterName)
                    .sort(sortArrayPathIndex(name))
                    .reverse()
                    .forEach((fieldArrayName) => {
                    setFieldArrayState(form, getNextIndexName(fieldArrayName, getPathIndex(name, fieldArrayName)), getFieldArrayState(form, fieldArrayName));
                });
            }
            // Set value of new field array item
            setFieldArrayValue(form, name, { at: index, value });
            // Insert item into field array
            fieldArray.items.splice(index, 0, getUniqueId());
            // Set touched at field array and form to true
            fieldArray.touched = true;
            form.touched = true;
            // Set dirty at field array and form to true
            fieldArray.dirty = true;
            form.dirty = true;
            // Validate field array if required with delay to allow new fields to be
            // mounted beforehand
            setTimeout(() => validateIfRequired(form, fieldArray, name, {
                on: ['touched', 'input'],
            }), 250);
        }
    }
}