CKEditor 3.0 使用步骤【英文文档】

Integration

From 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.

Contents

[hide]

Step 1: Loading CKEditor

CKEditor 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 Instance

CKEditor 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">&lt;p&gt;Initial value.&lt;/p&gt;</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 Data

As 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 Handling

Some 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">&lt;p&gt;Initial value.&lt;/p&gt;</textarea>
   <script type="text/javascript">
    CKEDITOR.replace( 'editor1' );
   </script>
  </p>
  <p>
   <input type="submit" />
  </p>
 </form>
</body>
</html>

JavaScript API

Work in progress...

One of our users has put up a temporary guide here. Thank you Christiaan.

Powered by MediaWiki

------------------------------------我就是传说中的分割线---------------------------------------------------------------

附件:

原文地址:http://docs.fckeditor.net/CKEditor_3.x/Developers_Guide/Integration

CKEditor 3.X 开发者向导:http://docs.fckeditor.net/CKEditor_3.x/Developers_Guide

CKEditor 3.0 JavaScript API 文档:http://docs.fckeditor.net/ckeditor_api/

官方网站:http://ckeditor.com/

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值