Tbeditor"

From Documentation
(Created page with "hi")
 
Line 1: Line 1:
−
hi
+
{{ZKComponentReferencePageHeader}}
 +
 
 +
= CKEditor =
 +
 
 +
*Demonstration: [http://www.zkoss.org/zkdemo/input/wysiwyg_editor WYSIWYG Editor]
 +
*Java API: N/A
 +
*JavaScript API: N/A
 +
 
 +
{{ZKAddon | link=http://sourceforge.net/projects/zk1/files/ZK%20CKEditor/ZK%205/}}
 +
 
 +
It is moved to google code after 3.5.2.0: [http://code.google.com/p/zkckeditor/ zkckeditor]
 +
 
 +
It is moved to github after 3.6.0.0: https://github.com/zkoss/zkckeditor
 +
 
 +
= Employment/Purpose =
 +
The component used to represent [http://ckeditor.com/ CKEditor]
 +
 
 +
CKEditor  is a popular HTML on-line text editor developed by Frederico Caldeira Knabben.
 +
 
 +
CKEditor is a text editor to be used inside web pages. It's a WYSIWYG editor, which means that the text being edited on it looks as similar as possible to the results users have when publishing it.
 +
 
 +
It brings to the web common editing features found on desktop editing applications like Microsoft Word and OpenOffice.
 +
 
 +
= Example =
 +
[[Image:ZKCompRef_CKEditor.png]]
 +
 
 +
<source lang="xml" >
 +
<ckeditor width="850px">
 +
<attribute name="value"><![CDATA[
 +
<table width="200" cellspacing="1" cellpadding="1" border="1">
 +
<tbody>
 +
<tr style="background: #B7B313; color:white;">
 +
<td>First Name</td>
 +
<td>Last Name</td>
 +
</tr>
 +
<tr>
 +
<td>Jone</td>
 +
<td>Hayes</td>
 +
</tr>
 +
<tr>
 +
<td>Mary</td>
 +
<td>Bally</td>
 +
</tr>
 +
</tbody>
 +
</table>
 +
]]></attribute>
 +
</ckeditor>
 +
</source>
 +
 
 +
[[Image:ZKCompRef_CKEditor2.png]]
 +
 
 +
'''It will turn on the save button when inside a form'''
 +
 
 +
<source lang="xml" >
 +
<zk xmlns:n="http://www.zkoss.org/2005/zk/native">
 +
<n:form>
 +
<ckeditor width="850" />
 +
</n:form>
 +
</zk>
 +
</source>
 +
 
 +
=Work with ZK6 MVVM=
 +
since 6.0.0
 +
 
 +
For work with ZK6 MVVM, it is required to create an addon xml and add the server annotation as follows:
 +
 
 +
WEB-INF/ckez-bind-addon.xml
 +
<source lang="xml" >
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<language-addon>
 +
<!-- The name of this addon. It must be unique -->
 +
<addon-name>ckezbind</addon-name>
 +
<!-- Specifies what other addon this depends
 +
<depends></depends>
 +
-->
 +
<!-- Which language this addon will be added to -->
 +
<language-name>xul/html</language-name>
 +
 
 +
<component>
 +
<component-name>ckeditor</component-name>
 +
<extends>ckeditor</extends>
 +
<annotation>
 +
<annotation-name>ZKBIND</annotation-name>
 +
<property-name>value</property-name>
 +
<attribute>
 +
<attribute-name>ACCESS</attribute-name>
 +
<attribute-value>both</attribute-value>
 +
</attribute>
 +
<attribute>
 +
<attribute-name>SAVE_EVENT</attribute-name>
 +
<attribute-value>onChange</attribute-value>
 +
</attribute>
 +
<attribute>
 +
<attribute-name>LOAD_REPLACEMENT</attribute-name>
 +
<attribute-value>value</attribute-value>
 +
</attribute>
 +
<attribute>
 +
<attribute-name>LOAD_TYPE</attribute-name>
 +
<attribute-value>java.lang.String</attribute-value>
 +
</attribute>
 +
</annotation>
 +
</component>
 +
</language-addon>
 +
</source>
 +
 
 +
then add it into WEB-INF/zk.xml
 +
 
 +
<source lang="xml" >
 +
<zk>
 +
<language-config>
 +
<addon-uri>/WEB-INF/ckez-bind-addon.xml</addon-uri>
 +
</language-config>
 +
</zk>
 +
</source>
 +
Since 3.6.0.1, server annotation has been added to the lang-addon.xml file, so you no more need to add the above settings to your zk.xml file.
 +
 
 +
=File browser=
 +
ZK CKEditor provides a default file browser for browsing the files in a folder that you specify. You can define a target folder in index.zul and when you open the add image/flash dialog and click "Browse Server", CKEditor will open a new window, and list all the files in the file browser.
 +
{| width="100%"
 +
|-
 +
|[[File:ZKCompRef_CKEditor_filebrowser.png]]
 +
| <source lang="xml" >
 +
<zk>
 +
    <ckeditor filebrowserImageBrowseUrl="img"/>
 +
</zk>
 +
</source>
 +
|}
 +
[[File:ZKCompRef_CKEditor_filebrowser2.png]]
 +
[[File:ZKCompRef_CKEditor_filebrowser3.png]]
 +
 
 +
==Custom File browser==
 +
since 3.6.0.2
 +
If you wish to customize your own file browser, you can change the location by calling CKeditor.setFilebrowserImageUploadUrl(page_url), and refer to [http://docs.cksource.com/CKEditor_3.x/Developers_Guide/File_Browser_%28Uploader%29 CKEditor Developers Guide] to create your custom file browser.
 +
 
 +
=File upload=
 +
since 3.6.0.2
 +
ZK CKEditor provides a default file upload handler for uploading the files to the folder you specify. You can define a target folder in index.zul and when user uploads a file, it will save the file in the folder that you have specified.
 +
{| width="100%"
 +
|-
 +
|[[File:ZKCompRef_CKEditor_filebrowser.png]]
 +
| <source lang="xml" >
 +
<zk>
 +
    <ckeditor filebrowserImageBrowseUrl="img" filebrowserImageUploadUrl="img"/>
 +
</zk>
 +
</source>
 +
|}
 +
[[File:ZKCompRef_CKEditor_fileupload.png]]
 +
[[File:ZKCompRef_CKEditor_fileupload2.png]]
 +
 
 +
==Custom File upload handler==
 +
since 3.6.0.2
 +
If you wish to customize your own file upload handler, you can change the location by calling CKeditor.setFileUploadHandlePage(page_url), and refer to [http://docs.cksource.com/CKEditor_3.x/Developers_Guide/File_Browser_%28Uploader%29 CKEditor Developers Guide] to create your custom file upload handler.
 +
 
 +
=Supported Events=
 +
 
 +
{| border="1" | width="100%"
 +
! <center>Name</center>
 +
! <center>Event Type</center>
 +
|-
 +
| <center><tt>onChange</tt></center>
 +
| <javadoc>org.zkoss.zk.ui.event.InputEvent</javadoc>
 +
 
 +
<tt>'''Description:''' </tt> Denotes the content of an input component has been modified by the user.
 +
 
 +
|-
 +
| <center><tt>onChanging</tt></center>
 +
| <javadoc>org.zkoss.zk.ui.event.InputEvent</javadoc>
 +
 
 +
<tt>'''Description:''' </tt> Denotes that user is changing the content of an input component. Notice that the component's content (at the server) won't be changed until <tt>onChange</tt> is received. Thus, you have to invoke the <tt>getValue </tt>method in the <tt>InputEvent </tt>class to retrieve the temporary value.
 +
 
 +
|-
 +
| <center><tt>onSave</tt></center>
 +
| <javadoc>org.zkoss.zk.ui.event.InputEvent</javadoc>
 +
 
 +
<tt>'''Description:''' </tt> Denotes the save button of the CKEditor component has been clicked by the user.
 +
 
 +
|}
 +
 
 +
=Supported Children=
 +
 
 +
*NONE
 +
 
 +
=Use Cases=
 +
 
 +
{| border='1px' | width="100%"
 +
! Version !! Description !! Example Location
 +
|-
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp;
 +
|}
 +
 
 +
=Version History=
 +
{{LastUpdated}}
 +
 
 +
{| border='1px' | width="100%"
 +
! Version !! Date !! Content
 +
|-
 +
| &nbsp;
 +
| &nbsp;
 +
| &nbsp;
 +
|}
 +
 
 +
{{ZKComponentReferencePageFooter}}

Revision as of 06:53, 6 May 2015


DocumentationZK Component ReferenceInputTbeditor
Tbeditor

CKEditor

Template:ZKAddon

It is moved to google code after 3.5.2.0: zkckeditor

It is moved to github after 3.6.0.0: https://github.com/zkoss/zkckeditor

Employment/Purpose

The component used to represent CKEditor

CKEditor is a popular HTML on-line text editor developed by Frederico Caldeira Knabben.

CKEditor is a text editor to be used inside web pages. It's a WYSIWYG editor, which means that the text being edited on it looks as similar as possible to the results users have when publishing it.

It brings to the web common editing features found on desktop editing applications like Microsoft Word and OpenOffice.

Example

ZKCompRef CKEditor.png 

<ckeditor width="850px">
<attribute name="value"><![CDATA[
<table width="200" cellspacing="1" cellpadding="1" border="1">
	<tbody>
		<tr style="background: #B7B313; color:white;">
			<td>First Name</td>
			<td>Last Name</td>
		</tr>
		<tr>
			<td>Jone</td>
			<td>Hayes</td>
		</tr>
		<tr>
			<td>Mary</td>
			<td>Bally</td>
		</tr>
	</tbody>
</table>
]]></attribute>
</ckeditor>

ZKCompRef CKEditor2.png

It will turn on the save button when inside a form 

<zk xmlns:n="http://www.zkoss.org/2005/zk/native">
	<n:form>
		<ckeditor width="850" />
	</n:form>
</zk>

Work with ZK6 MVVM

since 6.0.0

For work with ZK6 MVVM, it is required to create an addon xml and add the server annotation as follows:

WEB-INF/ckez-bind-addon.xml 

<?xml version="1.0" encoding="UTF-8"?>
<language-addon>
	<!-- The name of this addon. It must be unique -->
	<addon-name>ckezbind</addon-name>
	<!-- Specifies what other addon this depends
	<depends></depends>
	-->
	<!-- Which language this addon will be added to -->
	<language-name>xul/html</language-name>

	<component>
		<component-name>ckeditor</component-name>
		<extends>ckeditor</extends>
		<annotation>
			<annotation-name>ZKBIND</annotation-name>
			<property-name>value</property-name>
			<attribute>
				<attribute-name>ACCESS</attribute-name>
				<attribute-value>both</attribute-value>
			</attribute>
			<attribute>
				<attribute-name>SAVE_EVENT</attribute-name>
				<attribute-value>onChange</attribute-value>
			</attribute>
			<attribute>
				<attribute-name>LOAD_REPLACEMENT</attribute-name>
				<attribute-value>value</attribute-value>
			</attribute>
			<attribute>
				<attribute-name>LOAD_TYPE</attribute-name>
				<attribute-value>java.lang.String</attribute-value>
			</attribute>
		</annotation>
	</component>
</language-addon>

then add it into WEB-INF/zk.xml 

<zk>
	<language-config>
		<addon-uri>/WEB-INF/ckez-bind-addon.xml</addon-uri>
	</language-config>
</zk>

Since 3.6.0.1, server annotation has been added to the lang-addon.xml file, so you no more need to add the above settings to your zk.xml file.

File browser

ZK CKEditor provides a default file browser for browsing the files in a folder that you specify. You can define a target folder in index.zul and when you open the add image/flash dialog and click "Browse Server", CKEditor will open a new window, and list all the files in the file browser.

File:ZKCompRef CKEditor filebrowser.png 
<zk>
    <ckeditor filebrowserImageBrowseUrl="img"/>
</zk>

ZKCompRef CKEditor filebrowser2.png ZKCompRef CKEditor filebrowser3.png

Custom File browser

since 3.6.0.2

If you wish to customize your own file browser, you can change the location by calling CKeditor.setFilebrowserImageUploadUrl(page_url), and refer to CKEditor Developers Guide to create your custom file browser.

File upload

since 3.6.0.2

ZK CKEditor provides a default file upload handler for uploading the files to the folder you specify. You can define a target folder in index.zul and when user uploads a file, it will save the file in the folder that you have specified.

File:ZKCompRef CKEditor filebrowser.png 
<zk>
    <ckeditor filebrowserImageBrowseUrl="img" filebrowserImageUploadUrl="img"/>
</zk>

ZKCompRef CKEditor fileupload.png ZKCompRef CKEditor fileupload2.png

Custom File upload handler

since 3.6.0.2

If you wish to customize your own file upload handler, you can change the location by calling CKeditor.setFileUploadHandlePage(page_url), and refer to CKEditor Developers Guide to create your custom file upload handler.

Supported Events

Name
Event Type
onChange
 InputEvent

Description: Denotes the content of an input component has been modified by the user.

onChanging
 InputEvent

Description: Denotes that user is changing the content of an input component. Notice that the component's content (at the server) won't be changed until onChange is received. Thus, you have to invoke the getValue method in the InputEvent class to retrieve the temporary value.

onSave
 InputEvent

Description: Denotes the save button of the CKEditor component has been clicked by the user.

Supported Children

*NONE

Use Cases

Version Description Example Location
     

Version History

Last Update : 2015/05/06


Version Date Content
     



Last Update : 2015/05/06

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.


Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Component_Reference/Input/Tbeditor&oldid=43281"