@bbalganjjm/natural_js NPM

Natural-JS

Natural-JS is a JavaScript architectural framework designed to enable intuitive, easy, and fast implementation of user interfaces for enterprise web applications.

Structure

Natural-JS consists of the Natural-CORE, Natural-ARCHITECTURE, Natural-DATA, and Natural-UI library packages. Natural-CORE is a common library package used globally within Natural-JS, and Natural-ARCHITECTURE is a library package that constitutes the architecture of Natural-JS. Natural-DATA is a library package that supports data synchronization, formatting, verification, and processing, and Natural-UI is a library package that provides HTML-based UI components.

Structure of Natural-JS

Natural-JS Architecture Framework

Natural-CORE

Natural-CORE is a common library package used globally by Natural-JS.

CORE Utitlities - N() & N

N() is a Natural-JS core method. It returns a collection of matched elements either found in the DOM based on the passed argument(s) or created by passing an HTML string.

N is an object class that defines the core functions of Natural-JS.

N() and N provide the following jQuery extensions and utility classes:

jQuery selector extensions: jQuery selector extension for defining selectors with attributes such as style or data
jQuery plugin extension methods: Natural-JS utility method created with jQuery Plugin
N: Object class that defines the core functions of Natural-JS
N.gc: Function set class for Natural-JS internal garbage collection
N.string: Function set class for string control
N.element: Function set class for controlling HTML elements
N.date: Function set class for date control
N.browser: Web browser information-related function set class
N.message: Function set class for handling messages(multilingual)
N.array: Function set class for manipulating array data
N.json: Function set class for manipulating JSON data
N.event: Function set class for event control

Natural Config - Config(natural.config.js)

Config(natural.config.js) is a place to save the Natural-JS operation environment settings, AOP settings, Communication Filter settings, UI option values, etc.

Natural-ARCHITECTURE

Natural-ARCHITECTURE is a library package that constitutes the architecture of Natural-JS.

Natural-ARCHITECTURE

Communicator-View-Controller(CVC) Architecture Pattern

The CVC pattern is an architectural pattern based on the Model-View-Controller(MVC) pattern. As shown in the figure below, it is a client-centric architectural pattern that configures the client's browser area as the Communicator-View-Controller architecture and defines the server as the model area. Applying the CVC pattern allows client browser implementation technologies to deviate from server technology and server architecture dependencies, and the complexity of development can be reduced by completely separating the design and development areas.

CVC Architecture Pattern

Natural Architecture Framework

Natural Architecture Framework is an architectural framework that implements the CVC Architecture Pattern.

Natural Architecture Framework

Natural Architecture Framework provides a clear separation of the areas of development, offering a foundation for division of work among professionals in each area.

Controller

Controller(N.cont) is a class that implements the Controller layer of the CVC Architecture Pattern.

The Controller object is an object in which user-defined functions that control block pages are implemented.
Natural-ARCHITECTURE supports AOP(Aspect-Oriented Programming) for Controller objects.

View

There is no separate implementation of the View, and the HTML element area of the block page is defined as the View.

Communicator

Communicator(N.comm) is a class that implements the Communicator layer of CVC Architecture Pattern.

N.comm is a library that supports Ajax communication with the server, such as requesting content or data from the server or passing parameters.
N.comm provides a Communication Filter feature that can execute common logic in every request and response or error generation phase when communicates with the server.

Context

Context(N.context) is a space that ensures data persistence within the life-cycle (until the page is loaded and redirected to another URL) of a Natural-JS-based application. Natural-JS configuration values (Config(natural.config.js)), global configuration values, common messages of the framework, etc., are stored in N.context objects.

Natural-DATA

Natural-DATA is a library package that supports data synchronization, formatting, validation, and processing.

DataSync

DataSync is a library that synchronizes data changed by components or libraries in real-time.

Formatter

Formatter(N.formatter) is a library that formats the input dataset(JSON object array) and returns the formatted dataset.

Validator

Validator(N.validator) is a library that validates the input dataset(JSON object array) and returns a validation result dataset.

Natural-DATA Library

Natural-DATA Library provides methods and functions for sorting, filtering, and refining data of the JSON object array type.

Natural-UI

Natural-UI is a library package that supports HTML-based UI components.

Natural-UI

Alert

Alert(N.alert) is a UI component that displays message dialogs like window.alert or window.confirm in the form of layer popups.

Button

Button(N.button) is a UI component that creates a button with "a, inputtype=button, button" element specified as a context option.

Datepicker

Datepicker(N.datepicker) is a UI component that displays a calendar popup for selecting a date or month in the text input element specified by the context option.

Popup

Popup(N.popup) is a UI component that creates a layer popup from the internal element specified by the context option or the page specified by the URL option.

Tab

Tab(N.tab) is a UI component that creates a tab page view by specifying an element consisting of div>ul>li tags as the context option.

Select

Select(N.select) is a UI component that binds data to select, inputtype=checkbox, and inputtype=radio elements to create selections and extends the functionality of those controls.

Form

Form(N.form) is a UI component that binds or creates single-row data to an element(block elements such as div and table) specified by the context option.

List

List(N.list) is a UI component that creates a list of data in the form of a single column by specifying the ul>li element as the context option.

Grid

Grid(N.grid) is a UI component that creates a list of data in a multi-column form by specifying a table element as a context option.

Pagination

Pagination(N.pagination) is a UI component that creates paging indexes from list data or the total count of rows.

Tree

Tree(N.tree) is a UI component that transforms hierarchical data into tree elements.

Natural-UI.Shell

While Natural-UI supports UI development in the content area, Natural-UI.Shell is a component package that supports the development of shell areas outside the content area.

Notify(N.notify)

Notify(N.notify) is a UI component that displays a global notification message in a specified location that does not require user confirmation.

Documents(N.docs)

Documents(N.docs) is a page container that displays Natural-JS based menu pages in MDI(Multi Document Interface) or SDI(Single Document Interface) structure.