WebFormsJS is a JavaScript library that provides the infrastructure for interacting with web controls in the CodeBehind framework; this allows developers to easily manage HTML tags on the server-side.
WebFormsJS is a new architecture similar to Microsoft's former Web-Forms, but has none of its disadvantages. The performance of WebFormsJS is much more than the previous Web-Forms, so that it manages all HTML tags.
Using WebFormsJS allows the developers to focus on the server response and therefore there is no need to develop the front side and the developers set the controls on the server-side. WebFormsJS can also be used outside of the CodeBehind framework. In the rest of this article, we teach how to set the server response to interact with WebFormsJS.
The bandwidth consumption when using WebFormsJS is very low. WebFormsJS is like a gasoline car that absorbs carbon pollution as much as it pollutes the air.
Advantages of using WebFormsJS:
- WebFormsJS provides features like postback, progress bar and script extraction.
- WebForms is an advanced system that can be run with simple HTML pages without View or server script pages.
- WebFormsJS automatically sends form data through Ajax. WebFormsJS serializes form data as a string or a FormData object, depending on whether the form is multipart or not.
- Using WebFormsJS reduces the complexity of web development.
At the beginning of the web-forms.js file, there are WebFormsJS customization options. The following codes show the options of this file:
var PostBackOptions = new Object();
PostBackOptions.UseProgressBar = true;
PostBackOptions.UseConnectionErrorMessage = true;
PostBackOptions.ConnectionErrorMessage = "Connection Error";
PostBackOptions.AutoSetSubmitOnClick = true;
PostBackOptions.SendDataOnlyByPostMethod = false;
PostBackOptions.WebFormsTagsBackgroundColor = "#eee";
PostBackOptions.SetResponseInsideDivTag = true;
WebFormsJS options:
- UseProgressBar: If there is a file input in the form, the progress bar will show the amount of data sent on the screen.
- UseConnectionErrorMessage: Enabling this option causes the error text to be displayed.
- ConnectionErrorMessage: The text to display when an error occurs.
- AutoSetSubmitOnClick: Enabling this option makes submit type inputs automatically send data through WebFormsJS.
- SendDataOnlyByPostMethod: Enabling this option causes the data to be sent with the Post method; Therefore, the form method is ignored.
- WebFormsTagsBackgroundColor: Before rendering the web-forms tags, it gives a default color to their background to improve the user experience.
- SetResponseInsideDivTag: Enabling this option determines whether the server response will be placed inside the div tag or not.
Action Controls are WebFormsJS received codes that are received in INI format. WebFormsJS automatically detects whether the server response has Action Controls or not. If the server's response is based on the structure of an INI file that starts with [web-forms]
, it will process the Action Controls, otherwise it will replace the server's response in the form of Ajax on the page.
Example of received Action Controls:
[web-forms]
as<body>=background-color:green
saCheckBoxInput=onchange|MyNewFunc()
deMyTagId=1
ta<i>2=right
aoSelectInput=OptionValue|Option Text|1
al(InputName)=My Input Title
- Line 1:
as<body>=background-color:green
Here, the first two characters areas
, which means adding a style, and then it is specified that it will be applied to thebody
tag, and after the equal character (=
), the style attribute is specified. - Line 2:
saCheckBoxInput=onchange|MyNewFunc()
Here, the first two characters aresa
, which means adding an attribute, and then it is specified that it will be applied to a tag with the idCheckBoxInput
, and after the equal character (=
), the name and value of the attribute is specified, which is specified by the character (|
) are separated. - Line 3:
deMyTagId=1
Here, the first two characters arede
, which means to delete the tag, and then it is determined that it will be applied to a tag with the idMyTagId
, and after the equal character (=
) there is a value of1
, which means to apply deletion. - Line 4:
ta<i>2=right
Here, the first two characters areta
, which means text align, and then it is determined that it will be applied to a third tag namedli
, and after the equal character (=
) there is a value of right which means right to left. - Line 5:
aoSelectInput=OptionValue|Option Text|1
Here, the first two characters areao
, which means adding the option tag, and then it is specified that it will be applied to a tag with the id nameSelectInput
, and after the equal character (=
), the option value is placed, and after the character (|
) option text is placed and at the end after the (|
) character is the number1
, which means that the option is active (checked
). - Line 6:
al(InputName)=My Input Title
Here, the first two characters areal
, which means adding a title, and then it is specified that it will be applied to a tag namedInputName
, and after the equal character (=
), the title text is specified.
Action Controls are received in the form of an INI file format. In the first line of the response there is the word [web-forms]
and each of the following lines is an action control.
The first two characters determine the action code. For example, things like adding styles and removing tags can be obtained from action codes. Usually the first two letters stand for actions and indicate that an action must be performed.
After the first two letters, there are 6 status types that specify the tag. Then the equal character is placed and after that the values are placed.
Below is the list of all action codes:
The following items are added to the available amount:
- ai: Add Id - Value:
Id
- an: Add Name - Value:
Name
- av: Add Value - Value:
Value
- ac: Add Class - Value:
Class
- as: Add Style - Value:
Style
- ao: Add Option Tag - Value:
Value|Text|1 or 0
- ak: Add CheckBox Tag - Value:
Value|Text|1 or 0
- al: Add Title - Value:
Title
- at: Add Text - Value:
Text
(string value$[ln];
it replaces by\n
character) - aa: Add Attribute - Value:
Attribute|Value
- nt: Add Tag - Value:
TagName|Id
The following replaces the existing values:
- si: Set Id - Value:
Id
- sn: Set Name - Value:
Name
- sv: Set Value - Value:
Value
- sc: Set Class - Value:
Class
- ss: Set Style - Value:
Style
- so: Set Option Tag - Value:
Value|Text|1 or 0
- sk: Set Checked - Value: For input with checked type
1 or 0
- For any tagsValue|Text|1 or 0
- sl: Set Title - Value:
Title
- st: Set Text - Value:
Text
(string value$[ln];
it replaces by\n
character) - sa: Set Attribute - Value:
Attribute|Value
- sw: Set Width - Value:
Width
- sh: Set Height - Value:
Height
- bc: Set Background Color - Value:
Color
- tc: Set Text Color - Value:
Color
- fn: Set Font Name - Value:
Name
- fs: Set Font Size - Value:
Size
- fb: Set Font Bold - Value:
1 or 0
- vi: Set Visible - Value:
1 or 0
- ta: Set Text Align - Value:
Align
- sr: Set Read Only - Value:
1 or 0
- sd: Set Disabled - Value:
1 or 0
- mn: Set Min Length - Value:
Length
- mx: Set Max Length - Value:
Length
- ts: Set Selected Value - Value:
Value
- ti: Set Selected Index - Value:
Index
- ks: Set Checked Value - Value:
Value|1 or 0
- ki: Set Checked Index - Value:
Index|1 or 0
The following items are added only if there are no pre-existing values:
- ii: Insert Id - Value:
Id
- in: Insert Name - Value:
Name
- iv: Insert Value - Value:
Value
- ic: Insert Class - Value:
Class
- is: Insert Style - Value:
Style
- io: Insert Option Tag - Value:
Value|Text|1 or 0
- ik: Insert CheckBox Tag - Value:
Value|Text|1 or 0
- il: Insert Title - Value:
Title
- it: Insert Text - Value:
Text
(string value$[ln];
it replaces by\n
character) - ia: Insert Attribute - Value:
Attribute|Value
The following will remove the current values:
- di: Delete Id - Value:
1
- dn: Delete Name - Value:
1
- dv: Delete Value - Value:
1
- dc: Delete Class - Value:
Class
- ds: Delete Style - Value:
Style
(only the style name is entered without a value) - do: Delete Option Tag - Value:
Value
- dk: Delete CheckBox Tag - Value:
Value
- dl: Delete Title - Value:
1
- dt: Delete Text - Value:
1
- da: Delete Attribute - Value:
Attribute
- de: Delete Tag - Value:
1
The following increment the current numeric values:
- +n: Increase Minimum Length - Value:
Number
- +x: Increase Maximum Length - Value:
Number
- +f: Increase Font Size - Value:
Number
- +w: Increase Width - Value:
Number
- +h: Increase Height - Value:
Number
- +v: Increase Value - Value:
Number
The following decrease the current numerical values:
- -n: Descrease Minimum Length - Value:
Number
- -x: Descrease Maximum Length - Value:
Number
- -f: Descrease Font Size - Value:
Number
- -w: Descrease Width - Value:
Number
- -h: Descrease Height - Value:
Number
- -v: Descrease Value - Value:
Number
Note: Action controls are executed sequentially; if an action control decides to change an
id
attribute from a tag, subsequent action controls cannot perform actions with the previousid
attribute.
Note: You can also use negative numbers in all indexes. This makes access to tags or values to be read from the end.
Example:
de<li>-1=1
In the example above, the last li
tag is removed.
- _: Execute script - Value:
Script code
Pre Runners are added before Action Control values.
Each Pre Runner usually consists of one character, followed by the values of the Pre Runner, and then ends with the closing parenthesis ()
) character.
- :: Delay - Value:
Second
- (: Period - Value:
Second
Example:
(4)+w<b>1=10px
The above example means that every 4 seconds, the width of the second b tag is added by 10 pixels.
Pre Runners are placed in the queue and can be called one after the other.
Example:
:10)(4)+w<b>1=10px
The above example is the same as the previous example, except that it is executed after 10 seconds.
After the first two characters, there are 6 status types that define the tag:
- Based on
id
: Based on the name of theid
, it recognizes the tag and the character (=
) is placed immediately after it. - By
name
: Identifies the tag based on thename
attribute. It is placed in open and closed parentheses ((Name)
), and if a number is placed after it, it specifies the index, and then the (=
) character is placed after it. - Based on the
tag name
: Based on thetag name
, it recognizes the tag. It is placed inside the smaller and larger signs (<tag name>)
), and if a number is placed after it, it specifies the index, and then the (=
) character is placed after it. - Based on
class name
: Identifies the tag based on theclass name
. It is placed in open and closed brackets ({class name}
), and if a number is placed after it, it specifies the index, and then the character (=
) is placed after it. - Based on
query
: Identifies the tag based on thequery
. The query string is placed after the (*
) character , and then the character (=
) is placed after it. If there are equal characters (=
) in the query value, they should be replaced by$[eq];
string. - Based on
query all
: It applies to multiple tags and identifies tags based on "query". The query string is placed after the ([
) character , and then the character (=
) is placed after it. If there are equal characters (=
) in the query value, they should be replaced by$[eq];
string.
Note: By default, the indexes of the
name
,class name
, andtag name
are set to0
.
Example: Action control with the value de<li>=1
is not different from the value de<li>0=1
.
You can also specify the desired tag nested (query all is not supported in this case).
Example:
at>{my-class}1|<u>|<li>2=My text string
In the example above, the My text string
is placed inside the third li
tag which is inside the first ul
tag, and the ul tag itself is a tag inside the tag whose class is equal to the value of my-class
.
WebFormsJS allows you to create web-forms
tags on pages. The web-forms tags must have one of the src
and ac
attributes or both of them.
The ac
attribute has the Action Controls value. Action Controls in this tag are separated by $[sln];
string.
Example:
<web-forms ac="nt<body>=div|MyDivTag$[sln];shMyDivTag=500px$[sln];swMyDivTag=500px$[sln];2)bci24=violet"></web-forms>
Note: The value of the ac
attribute must not contain the double-quote character ("
), and the string $[dq];
must be used instead.
The src
attribute takes the value of a URL path. WebFormsJS calls the URL contained in the src attribute and puts the URL response inside the same web-forms tag. You can also set the width
and height
attributes in the web-forms tag.
Example:
<web-forms src="/page/header.aspx"></web-forms>
WebFormsJS has a different approach to responding to the first page request in the browser and AJAX requests when the page is already loaded and the user makes a request.
In the first case, if an action is added for the controls, a tag named web-forms
is added at the bottom of the page, and the actions are placed in the ac
attribute of the web-forms tag.
Example:
<!DOCTYPE html>
<html>
<head>
...
</head>
<body>
...
<input name="TextBox" id="TextBox" type="text" />
...
</body>
</html><web-forms ac="bc<body>=green"></web-forms>
In the second case, after the user's request, if the current View is changed, the server must place the Set Text code for the main tag (usually body
) at the beginning of the action code.
Example:
[web-forms]
st<body>=...$[ln]; <input name="TextBox" id="TextBox" type="text" />$[ln];...
bc<body>=green
Note: When a request is made with WebFormJS, a header with the name
Post-Back
and the valuetrue
is also sent to the server. Therefore, it is easy to determine the response approach on the server.
PostBack
and GetBack
are two methods in WebFormsJS.
PostBack
requests the URL string in the condition that it also transfers the input data to the server. The PostBack
method should only be used inside a form tag. The PostBack
method is automatically activated on submit type inputs.
GetBack
only requests the URL string regardless of the input data. The URL string can also contain the query string. The GetBack
method can be used without the form tag on the page.
There are three overloads for the GetBack
method:
GetBack()
: Requests the current URL path executed in the browser.GetBack(this)
: should be used only in situations where the form tag must be present on the page. If executed inside a form, the action path requests the form, otherwise it requests the path of the first form on the page.GetBack("YourURL")
: Requests the URL path entered as an argument.
Calling WebFormJS in HTML pages causes submit buttons to automatically get the onclick attribute with PostBack(this)
value.
<input name="btn_Button" type="submit" value="Click to send data" onclick="PostBack(this)"/>
If you call the PostBack
method as below, the contents of the page will remain and the values will be added to the beginning of the inner content of the body tag.
PostBack(this, true)
You can specify where to add content instead of true.
Example1:
PostBack(this, "<div>2")
The above method places the data received from the server inside the third div
tag.
Example2:
PostBack(this, "MyTagId")
The above method puts the data received from the server inside a tag or MyTagId
id.
Note: Examples 1 and 2 for the
GetBack
method also have the same function.