IntegrationFrom FCKeditor Docs
Jump to:
navigation,
search
There are several ways to integrate CKEditor into your pages. This page presents the most common way to achieve it.
Step 1: Loading CKEditorCKEditor is a JavaScript application. To load it, you just need to include a single file reference at your page. Supposing that you have installed CKEditor at the "ckeditor" directory at the root of your web site, here you have an example: <head> ... <script type="text/javascript" src="/ckeditor/ckeditor.js"></script> </head> With the above file loaded, the CKEditor JavaScript API is ready to be used. Step 2: Creating an Editor InstanceCKEditor works just like a textarea in your page. While the editor offers a user interface to easily write, format and work with rich text, the same thing could be achieved, not that easily, with a textarea, requiring the user to type HTML code inside of it. But, as a matter of fact, CKEditor uses a textarea to transfer its data to the server. The textarea is invisible to the end user. So, to create and editor instance you must, ironically, create a textarea first: <textarea name="editor1"><p>Initial value.</p></textarea> Note that, if you want to load data into the editor, from a database for example, just put that data inside the textarea, just like the above example. In this example, we have named our textarea "editor1". This name can be used in the server side later, when receiving the posted data. Now, using the CKEditor JavaScript API, we "replace" the plain textarea with an editor instance. A single JavaScript call is needed for that: <script type="text/javascript"> CKEDITOR.replace( 'editor1' ); </script> This script block must be included at any point "after" the <textarea> tag in the page. You can also call the replace function inside <head>, but you need to listen for the "window.onload" event in such case: <script type="text/javascript"> window.onload = function() { CKEDITOR.replace( 'editor1' ); }; </script> Step 3: Saving the Editor DataAs previously described, the editor works just like a <textarea> field. So, when submitting a form containing an editor instance, its data will be simply posted, using the textarea name as the key to retrieve it. For example, following the above example, in PHP we would do something like this: <?php $editor_data = $_POST[ 'editor1' ]; ?> Client Side Data HandlingSome applications (like Ajax applications) need to handle all data at the client side, sending it to the server by its own ways. In such case, it's enough to use the CKEditor API to easily retrieve an editor instance data. For example: <script type="text/javascript"> var editor_data = CKEDITOR.instances.editor1.getData(); </script> Complete Sample<html> <head> <title>Sample - CKEditor</title> <script type="text/javascript" src="/ckeditor/ckeditor.js"></script> </head> <body> <form method="post"> <p> My Editor:<br /> <textarea name="editor1"><p>Initial value.</p></textarea> <script type="text/javascript"> CKEDITOR.replace( 'editor1' ); </script> </p> <p> <input type="submit" /> </p> </form> </body> </html> JavaScript APIWork in progress... One of our users has put up a temporary guide here. Thank you Christiaan. ViewsPersonal toolsNavigationCKEditor 3.xFCKeditor 2.xCKFinder
© 2003 - 2009 Frederico Caldeira Knabben (
FredCK.com). All rights reserved.
|
CKEditor 3.0 使用步骤【英文文档】
最新推荐文章于 2019-05-16 15:34:11 发布