Skip to content

bbalganjjm/natural_js

Repository files navigation

Natural-JS

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

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 by Natural-JS and Natural-ARCHITECTURE is a library package that makes up the architecture of Natural-JS. Natural-DATA is a library package that supports data synchronization, formatting, validation, and processing and Natural-UI is a library package that supports HTML-based UI components.

Structure of Natural-JS

[ Structure of Natural-JS ]

Natural-JS Architecture Framework

[ 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. Return a collection of matched elements either found in the DOM based on 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 Natural-JS operation environment setting, AOP setting, Communication Filter setting, UI option value, etc.

Natural-ARCHITECTURE

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

Natural-ARCHITECTURE

[ Natural-ARCHITECTURE ]

Communicator-View-Controller(CVC) Architecture Pattern

The CVC pattern is an architectural pattern based on the Model-View-Controlelr(MVC) pattern. As shown in the figure below, it is a client-centric architectural pattern that configures the client browser area as the Communicator-View-Controller architecture and defines the server as a 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

[ Communicator-View-Controller(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 ]

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

Controller

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

  • Controller object is an object in which user-defined functions that control block pages are implemented.

    N.cont executes the init function of the Controller object and returns a Controller object.

  • Natural-ARCHITECTURE supports AOP (Aspect-Oriented Programming) for Controller objects.

View

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

Communicator

Communicator(N.comm) is a class that implements 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 that 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 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.

DataSync supports two way databinding between components.

Formatter

Formatter(N.formatter) is a library that formats the input data set(array [json object]) and returns the formatted data set.

Validator

Validator(N.validator) is a library that validates the input data set(array [json object]) and returns a validation result data set.

Natural-DATA Library

Natural-DATA Library provides methods and functions for sorting, filtering, and refining data of type array[json object].

Natural-UI

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

Components such as Grid, List, and Form do not have their own style. If the style is defined in the context element(table, ul/li, etc.) of the component before initializing the component, the component is created according to the defined style.

Natural-UI

[ Natural-UI ]

Alert

Alert(N.alert) is a UI component that displays message dialogs such as 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 "a, input[type=button], button" element specified as a context option.

Datepicker

Datepicker(N.datepicker) 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 makes a layer popup form 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, input[type=checkbox], and input[type=radio] elements to create a selection and extend the functionality of that control.

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 makes 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.

Supports

Support browsers

  • PC : Chrome, Edge, Firefox, Safari, Opera, Internet Explorer 11(limited support)
  • Mobile : iOS Safari, iOS UIWebView, Android Browser, Android Chrome, Android WebView

Training and support

License

This software is licensed under the LGPL v2.1 © Goldman Kim<[email protected]>