Development/Tutorials/Plasma/JavaScript/DataEngineAPI - Revision history

Neverendingo: Text replace - "`" to ""`


2011-06-29T21:07:48Z
Text replace - "<code javascript="javascript">" to "<syntaxhighlight lang="javascript">"

				
				
				
				
			
			← Older revision
			Revision as of 21:07, 29 June 2011
			
Line 25:
Line 25:
  The Simplified JavaScript API is powered by Qt's QtScript system which provides access to a full featured ECMA Script interpreter. If it works in ECMA Script, it will work in a Simplified JavaScript Plasmoid. As an interesting implementation note, QtScript uses the high performance ECMA Script interpreter from WebKit and shares this code with QtWebKit.     The Simplified JavaScript API is powered by Qt's QtScript system which provides access to a full featured ECMA Script interpreter. If it works in ECMA Script, it will work in a Simplified JavaScript Plasmoid. As an interesting implementation note, QtScript uses the high performance ECMA Script interpreter from WebKit and shares this code with QtWebKit.  
    
− On top of the ECMA Script language, QtScript provides Qt integration features. Probably the most useful one in this context is the use of signals and slots which is Qt's callback mechanism. Signals may be emitted in QtScript by calling the signal method in question, a signal can be connected to a slot by using the connect() method (and disconnected with disconnect()) and any function defined in the Plasmoid may be used as a slot. For example: <code javascript="javascript"> + On top of the ECMA Script language, QtScript provides Qt integration features. Probably the most useful one in this context is the use of signals and slots which is Qt's callback mechanism. Signals may be emitted in QtScript by calling the signal method in question, a signal can be connected to a slot by using the connect() method (and disconnected with disconnect()) and any function defined in the Plasmoid may be used as a slot. For example: <syntaxhighlight lang="javascript">
  function onClick()   function onClick()
  {   {

`Neverendingo: Text replace - "`" to ""

2011-06-29T20:54:02Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:45:14Z
Text replace - "<code>" to "<syntaxhighlight lang="text">"

				
				
				
				
			
			← Older revision
			Revision as of 20:45, 29 June 2011
			
Line 43:
Line 43:
  </code> This will print out:     </code> This will print out:  
    
− <code> + <syntaxhighlight lang="text">
  We got clicked!   We got clicked!
  First click!   First click!



Neverendingo: Text replace - "" to ""

2011-06-29T20:39:33Z
Text replace - "<code bash>" to "<syntaxhighlight lang="bash">"

				
				
				
				
			
			← Older revision
			Revision as of 20:39, 29 June 2011
			
Line 9:
Line 9:
  Useful tool for anyone working with dataEngines is   Useful tool for anyone working with dataEngines is
    
− <code bash> + <syntaxhighlight lang="bash">
  plasmaengineexplorer   plasmaengineexplorer
  </code>   </code>



Outolumo: /* Introduction to the DataEngine JavaScript API */ First version of the text.
2010-08-07T18:38:36Z
‎Introduction to the DataEngine JavaScript API:  First version of the text.

				
				
				
				
			
			← Older revision
			Revision as of 18:38, 7 August 2010
			
Line 1:
Line 1:
  = Introduction to the DataEngine JavaScript API  =   = Introduction to the DataEngine JavaScript API  =
    
− * What is a DataEngine + DataEngines are a key concept in Plasma. They are objects which serve to deliver some kind of data to one or more Plasma applets or plasmoids. Separating the part of the code that supplies the data from the part which displays the data, means that one DataEngine can be reused by many applets, regardless of which language the DataEngine or applet is written in.
  +  
  + DataEngines provide a standardized interface to various resources. Applets may be written for different uses, with different devices in mind, manage the presentation with for example JavaScript, C++ or HTML and still use the same dataEngine to supply the raw data. On the other hand, plasmoids can use the same API to access different kinds of data.
  +  
  + Plasma supports out of the box many different DataEngines, which deliver all kinds of varied information about things like the state of the machine, e.g. CPU usage, memory usage, position of the mouse pointer and Internet access. It is also possible to write new dataEngines. Some of the existing dataEngines include rss-feedreader, microblogging engine and weather service report.
  +  
  + Useful tool for anyone working with dataEngines is
  +  
  + <code bash>
  + plasmaengineexplorer
  + </code>
  +  
  + You can use it to inspect which engines are currently available in your system to supply data and what data are they providing.
  +  
  + DataEngines work in one-directional one-to-many relationship. One dataEngine may provide same raw data to many plasmoids all at the same (for example the same time engine could power both clock and timezone applets) but plasmoids cannot send information to dataEngines - they only provide information. In some situations it might be useful to provide some data (for example login credentials to web service) for the interaction. For that purpose there is another plasma technology, Services.
  +  
  + This document describes the API any dataEngine exposes to plasmoids written in JavaScript.
    
  == QtScript  ==   == QtScript  ==



Aseigo: Created page with '= Introduction to the DataEngine JavaScript API  =  * What is a DataEngine  == QtScript  ==  {{improve|The example used is from the Plasmoids, and isn't relevant to DataEngines a...'
2010-08-06T05:37:56Z
Created page with '= Introduction to the DataEngine JavaScript API  =  * What is a DataEngine  == QtScript  ==  {{improve|The example used is from the Plasmoids, and isn't relevant to DataEngines a...'
New page
= Introduction to the DataEngine JavaScript API  =



* What is a DataEngine



== QtScript  ==



{{improve|The example used is from the Plasmoids, and isn't relevant to DataEngines as it uses PushButton, etc. A new example should be written that uses the DataEngine API}}



The Simplified JavaScript API is powered by Qt's QtScript system which provides access to a full featured ECMA Script interpreter. If it works in ECMA Script, it will work in a Simplified JavaScript Plasmoid. As an interesting implementation note, QtScript uses the high performance ECMA Script interpreter from WebKit and shares this code with QtWebKit. 



On top of the ECMA Script language, QtScript provides Qt integration features. Probably the most useful one in this context is the use of signals and slots which is Qt's callback mechanism. Signals may be emitted in QtScript by calling the signal method in question, a signal can be connected to a slot by using the connect() method (and disconnected with disconnect()) and any function defined in the Plasmoid may be used as a slot. For example: <code javascript="javascript">

function onClick()

{

    print("We got clicked!")

}



function onFirstClick()

{

    print("First click!")

    button.clicked.disconnect(onFirstClick)

}



button = new PushButton

button.clicked.connect(onClick)

button.clicked.connect(onFirstClick)

button.clicked()

</code> This will print out: 



<code>

We got clicked!

First click!

</code> 



on the console when the Plasmoid starts, and the "We got clicked!" again whenever the button is clicked by the user.



The object that emitted the signal that caused a slot to be called can be retrieved using the ''QObject'' '''sender''' read-only property of the global '''plasmoid''' object.



== Global functions ==



== The Global engine Object ==



== Events ==



== Services ==



== Other Functions and Classes ==



== Addons ==



{{improve|This section can be copy and pasted from the Plasmoid API page}}



== Extensions ==





{{improve|This section can be copy and pasted from the Plasmoid API page}}