Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
docs:3500:0800:0810 [2023/04/05 06:49] – seandocs:3500:0800:0810 [2025/06/12 02:36] (current) – Rename to AwareIM aware_support3
Line 5: Line 5:
 Before we explain how to write scripts for different components it is useful if a developer understands roughly the general architecture of the client-side code. Before we explain how to write scripts for different components it is useful if a developer understands roughly the general architecture of the client-side code.
  
-This is what happens behind the scenes when a screen is displayed in the browser by //**Aware IM**//. A screen (usually represented by visual perspectives) consists of multiple queries, forms, content panels and so on (we will call them "components").+This is what happens behind the scenes when a screen is displayed in the browser by //**AwareIM**//. A screen (usually represented by visual perspectives) consists of multiple queries, forms, content panels and so on (we will call them "components").
  
 Each component, such as a form or a query is handled by the appropriate "controller" (also called "parser"). The fist thing the controller does is ask the server to provide the definition of the layout of the component. Then the controller parses XML returned by the server and prepares two Javascript objects: Each component, such as a form or a query is handled by the appropriate "controller" (also called "parser"). The fist thing the controller does is ask the server to provide the definition of the layout of the component. Then the controller parses XML returned by the server and prepares two Javascript objects:
Line 22: Line 22:
   - The HTML and widget configurations are then given to the Kendo UI library to prepare its widgets   - The HTML and widget configurations are then given to the Kendo UI library to prepare its widgets
   - Final HTML of the screen is produced and is drawn by the browser.   - Final HTML of the screen is produced and is drawn by the browser.
-So where in this process do the client scripts come in? For most components there are two types of scripts – the "initialization" script and the "render" script. As a developer you can define one or both – depending on what the script needs to do. The initialization script if defined is run by //**Aware IM**// just before the controller of the component returns the markup of the controller and the array of widget configurations (so immediately after step 3 above). The script, therefore, has a chance to modify the markup returned by the controller or the configuration of any of the widgets of the component. +So where in this process do the client scripts come in? For most components there are two types of scripts – the "initialization" script and the "render" script. As a developer you can define one or both – depending on what the script needs to do. The initialization script if defined is run by //**AwareIM**// just before the controller of the component returns the markup of the controller and the array of widget configurations (so immediately after step 3 above). The script, therefore, has a chance to modify the markup returned by the controller or the configuration of any of the widgets of the component. 
  
 The markup can be modified using jQuery functions that manipulate HTML. The script can only modify the markup for the component, but not the entire screen, because the entire screen hasn’t been built yet.  The markup can be modified using jQuery functions that manipulate HTML. The script can only modify the markup for the component, but not the entire screen, because the entire screen hasn’t been built yet. 
  
-Widget configurations represent Javascript objects with properties described by Kendo UI API Reference. For example, to see the API Reference  of the Kendo UI grid widget that implements //**Aware IM**// queries in the standard form go to [[http://docs.telerik.com/kendo-ui/api/javascript/ui/grid]] and look up the Configuration section at the top. Note that you can only modify configuration of the widget (which also includes Events), but you cannot use Methods of the widget in the initialization script.+Widget configurations represent Javascript objects with properties described by Kendo UI API Reference. For example, to see the API Reference  of the Kendo UI grid widget that implements //**AwareIM**// queries in the standard form go to [[http://docs.telerik.com/kendo-ui/api/javascript/ui/grid]] and look up the Configuration section at the top. Note that you can only modify configuration of the widget (which also includes Events), but you cannot use Methods of the widget in the initialization script.
  
 The render script, though, runs after everything has been drawn on the screen – i.e. after step 6 above. By this time all Kendo UI widgets will have been already created, so the script can access the widget and call its methods (see the Methods section in the Kendo UI API Reference for each widget). Configuration objects cannot be used at this stage. The render script, though, runs after everything has been drawn on the screen – i.e. after step 6 above. By this time all Kendo UI widgets will have been already created, so the script can access the widget and call its methods (see the Methods section in the Kendo UI API Reference for each widget). Configuration objects cannot be used at this stage.
  • Last modified: 2023/04/05 06:49