UCH群组功能增加编辑器(html+js详解)

群组功能发帖时候增加编辑器,其实并不是很复杂,只不过我们要理解,为什么要这样修改代码。

*可能有些听不懂,不过不会影响修改,多学点东西总是好的吧?

 

首先,我们解析一下blog的编辑器。

看模板文件夹下cp_blog.htm里面的这段代码: 

复制内容到剪贴板 

代码:

                                <textarea class=”userData” name=”message” id=”uchome-ttHtmlEditor” style=”height:100%;width:100%;display:none;border:0px”>$blog[message]</textarea>

                                <iframe src=”editor.php?charset=$_SC[charset]&allowhtml=$allowhtml” name=”uchome-ifrHtmlEditor” id=”uchome-ifrHtmlEditor” scrolling=”no” border=”0″ frameborder=”0″ style=”width:100%;border: 1px solid #C5C5C5;” height=”400″></iframe>

第一步呢,我们先要读懂这两行代码:

这就是编辑器的比较核心的部分,用一个隐藏的textarea来提交信息,用js提取框架iframe里面的编辑内容,而iframe里面的部分是编辑器页面。

display:none 表示用css隐藏了textarea,看不到但是提交信息是可以发出去的。

我们会发现,textarea的iduchome-ttHtmlEditor和iframe里面的name和id都很像,对,这两个能合并在一起就是用这个挂钩的,当然,还要借助于js实现。

 

第二步,再看提交的时候,触发了什么,请看这两段代码,还是那个文件。 

复制内容到剪贴板 

代码:

<input type=”button” id=”blogbutton” name=”blogbutton” value=”提交发布” onclick=”validate(this);” style=”display: none;” />

复制内容到剪贴板 

代码:

<input type=”button” id=”issuance” onclick=”document.getElementById(’blogbutton’).click();” value=”保存发布” class=”submit” />

如果刚才认真听课的同学都发现了,“display: none”又一次使用到了隐藏。

但是提交的时候更有趣:

下面的按钮触发的是上面按钮的动作,怎么做到的呢? 

复制内容到剪贴板 

代码:

onclick=”document.getElementById(’blogbutton’).click();” 

这行代码表示在点击的时候,触发一个js事件:document.getElementById(’blogbutton’).click();

而这个事件的js实际上就是点击第一个按钮的动作,等同于触发了第一个按钮的: 

复制内容到剪贴板 

代码:

onclick=”validate(this);” 

这个部分,那么我们就找到了提交的时候,一定会包含处理编辑器的js函数:validate

 

搜索刚才那个文件中的代码,我们很容易找到这段: 

复制内容到剪贴板 

代码:

        function validate(obj) {

            var subject = $(’subject’);

            if (subject) {

                    var slen = strlen(subject.value);

                if (slen < 1 || slen > 80) {

                    alert(”标题长度(1~80字符)不符合要求”);

                    subject.focus();

                    return false;

                }

            }

 

            if($(’seccode’)) {

                        var code = $(’seccode’).value;

                        var x = new Ajax();

                        x.get(’cp.php?ac=common&op=seccode&code=’ + code, function(s){

                                s = trim(s);

                                if(s != ’succeed’) {

                                        alert(s);

                                        $(’seccode’).focus();

                                   return false;

                                } else {

                                        uploadEdit(obj);

                                        return true;

                                }

                        });

            } else {

                    uploadEdit(obj);

                    return true;

            }

        }

这个东西什么意思呢?我们大概看看,我也作简要解释:

function是函数必须的部分,后面表示 validate(obj)函数名和所传递进来的参数。参数是一个对象,所以用obj来命名,不是语法必须,只是比较方便理解。

然后定义了另外一个对象,在函数内部: var subject = $(’subject’);

表示将id为’subject’的部分当作对象给前面的变量,听不懂这些术语没所谓,以后会明白,不会影响这次你学习哦。

 

有这样的对象有啥用啊?

这样的对象可以直接指向某个DOM的节点,更简单的说法是方便操作部分指定的html,哈哈,这样理解了吧?

 

再看这个js函数。我用注释来说明每一行做什么: 

复制内容到剪贴板 

代码:

        function validate(obj) {//创建函数和函数名,声明需要传入什么参数

            var subject = $(’subject’);//设定一个函数内的变量,方便后面用,指向了id为subject的html部分。

            if (subject) {//如果有这个对象,可以理解成,如果有这个html的话

                    var slen = strlen(subject.value);//读取这个html部分的value值的长度

                if (slen < 1 || slen > 80) {//判断长度是否超过80或者小于1.

                    alert(”标题长度(1~80字符)不符合要求”);//提示不合法

                    subject.focus();//将光标焦点放到指定的对象上

                    return false;//返回这个函数的返回值为否(假),目的是告诉浏览器不要继续表单提交了,有问题啦。如果运行到这里,整个函数结束,不再继续运行。但是, 刚才的判断部分如果没有进入这个大括号的话,程序继续运行。细节部分参考一下相关描述js函数的书籍或资料,不详细说了。

                }

            }

 

            if($(’seccode’)) {//这个是判断’seccode’部分的,有ajax的部分,跳过大部分,我只简单说,我们直接谈中心部分。

                        var code = $(’seccode’).value;//读取’seccode’的值

                        var x = new Ajax();//创建一个ajax的实例,理解为要做ajax之前的热身,不然程序容易抽筋,那就不能继续了,呵呵

                        x.get(’cp.php?ac=common&op=seccode&code=’ + code, function(s){//将’cp.php?ac=common&op=seccode&code=’ + code作为ajax异步传输读取的地址,返回的是这个地址给的结果,也就是s

                                s = trim(s);//安全处理s

                                if(s != ’succeed’) {//如果s不是’succeed’的话,则运行下面的部分。

                                        alert(s);//警告,内容就是s,估计如果s不是’succeed’的话,会直接返回错误提示。

                                        $(’seccode’).focus();//呵呵,上面见过,将鼠标光标放到’seccode’上。

                                   return false;//返回别继续的指令,刚才说过。

                                } else {//否则运行(也就是说s的内容就是’succeed’)

                                        uploadEdit(obj);//哈哈,bingo~~~就是要照这个,更新编辑器的函数

                                        return true;//告诉浏览器,哈哈,正确了,提交吧,我拿到了编辑器的数据啦~~~

                                }

                        });

            } else {//这两行自己理解一下,自己看看括号是哪里的if和else,如果不知道if-else是什么,参考我之前发过的教程。

                    uploadEdit(obj);

                    return true;

            }

        }

这样我们就找到要得部分了,估计现在有些朋友会晕了,“改一个编辑器这么麻烦啊?”

是啊,如果你熟练的话,其实也不会特别麻烦,所以提醒某些喜欢免费的朋友,无论大家分享什么东西,都要懂得感恩,很多细节的部分你是看不到的,但是很有可能人家用心坐了很久,扯远了,我们继续哦

 

找到刚才那个地方,也就是uploadEdit(obj);

这还不够,你并不了解他具体是怎么运行的,确认一下,看看他在那里呢?

 

找了这个文件没有发现声明这个函数的部分,也就是没有找到 function uploadEdit

 

再看看代码,发现这个: 

复制内容到剪贴板 

代码:

<script language=”javascript” src=”image/editor/editor_function.js”></script>

*html中包含js的一种方法,具体参考html相关书籍和资料

 

好,开心吧,为什么呢?因为这个就是编辑器js的函数集文件了,马上打开看看吧,很快找到(第一个函数就是啊): 

复制内容到剪贴板 

代码:

function uploadEdit(obj) {

        mainForm = obj.form;

        forms = $(’attachbody’).getElementsByTagName(”FORM”);

        albumid = $(’uploadalbum’).value;

        edit_save();

        upload();

}

edit_save();???这个就是保存编辑器内容的东西吧,答对,加十分,哈哈

 

我们拿出来这个函数直接用,因为刚才那个文件已经引用过这个文件了,也就是刚才那句代码: 

复制内容到剪贴板 

代码:

<script language=”javascript” src=”image/editor/editor_function.js”></script>

怎么直接用,估计你也会了,复制,粘贴呗……

 

返回cp_blog.htm文件,我们再次理顺这个流程,我考虑将具体代码修改部分留给各位朋友,多测试,一定会有人做出来的,并不是很难。

 

编辑器运行的过程是这样的:

1、用户首先在这部分使用编辑器输入了想要的内容,编辑器直接呈现了效果,但是资料还是在iframe里面,没有传送到textarea部分: 

复制内容到剪贴板 

代码:

                                <textarea class=”userData” name=”message” id=”uchome-ttHtmlEditor” style=”height:100%;width:100%;display:none;border:0px”>$blog[message]</textarea>

                                <iframe src=”editor.php?charset=$_SC[charset]&allowhtml=$allowhtml” name=”uchome-ifrHtmlEditor” id=”uchome-ifrHtmlEditor” scrolling=”no” border=”0″ frameborder=”0″ style=”width:100%;border: 1px solid #C5C5C5;” height=”400″></iframe>

2、用户继续编辑其他的部分,当要提交的时候,用一个隐藏按钮提交内容: 

复制内容到剪贴板 

代码:

<input type=”button” id=”blogbutton” name=”blogbutton” value=”提交发布” onclick=”validate(this);” style=”display: none;” />

复制内容到剪贴板 

代码:

<input type=”button” id=”issuance” onclick=”document.getElementById(’blogbutton’).click();” value=”保存发布” class=”submit” />

3、触发了js函数validate,这个函数又一次触发了编辑器更新的函数uploadEdit。 

复制内容到剪贴板 

代码:

        function validate(obj) {//创建函数和函数名,声明需要传入什么参数

            var subject = $(’subject’);//设定一个函数内的变量,方便后面用,指向了id为subject的html部分。

            if (subject) {//如果有这个对象,可以理解成,如果有这个html的话

                    var slen = strlen(subject.value);//读取这个html部分的value值的长度

                if (slen < 1 || slen > 80) {//判断长度是否超过80或者小于1.

                    alert(”标题长度(1~80字符)不符合要求”);//提示不合法

                    subject.focus();//将光标焦点放到指定的对象上

                    return false;//返回这个函数的返回值为否(假),目的是告诉浏览器不要继续表单提交了,有问题啦。如果运行到这里,整个函数结束,不再继续运行。但是, 刚才的判断部分如果没有进入这个大括号的话,程序继续运行。细节部分参考一下相关描述js函数的书籍或资料,不详细说了。

                }

            }

 

            if($(’seccode’)) {//这个是判断’seccode’部分的,有ajax的部分,跳过大部分,我只简单说,我们直接谈中心部分。

                        var code = $(’seccode’).value;//读取’seccode’的值

                        var x = new Ajax();//创建一个ajax的实例,理解为要做ajax之前的热身,不然程序容易抽筋,那就不能继续了,呵呵

                        x.get(’cp.php?ac=common&op=seccode&code=’ + code, function(s){//将’cp.php?ac=common&op=seccode&code=’ + code作为ajax异步传输读取的地址,返回的是这个地址给的结果,也就是s

                                s = trim(s);//安全处理s

                                if(s != ’succeed’) {//如果s不是’succeed’的话,则运行下面的部分。

                                        alert(s);//警告,内容就是s,估计如果s不是’succeed’的话,会直接返回错误提示。

                                        $(’seccode’).focus();//呵呵,上面见过,将鼠标光标放到’seccode’上。

                                   return false;//返回别继续的指令,刚才说过。

                                } else {//否则运行(也就是说s的内容就是’succeed’)

                                        uploadEdit(obj);//哈哈,bingo~~~就是要照这个,更新编辑器的函数

                                        return true;//告诉浏览器,哈哈,正确了,提交吧,我拿到了编辑器的数据啦~~~

                                }

                        });

            } else {//这两行自己理解一下,自己看看括号是哪里的if和else,如果不知道if-else是什么,参考我之前发过的教程。

                    uploadEdit(obj);

                    return true;

            }

        }

4、我们追寻找到那个函数,终于了解,最终更新编辑器的中心函数是edit_save(); 

复制内容到剪贴板 

代码:

<script language=”javascript” src=”image/editor/editor_function.js”></script>

复制内容到剪贴板 

代码:

function uploadEdit(obj) {

        mainForm = obj.form;

        forms = $(’attachbody’).getElementsByTagName(”FORM”);

        albumid = $(’uploadalbum’).value;

        edit_save();

        upload();

}

我们知道了这些,就可以照猫画虎的制作出来任何地方的编辑器了。

 

附加解释一下edit_save()的内部结构,有朋友可能会问到,还是用注释来解释(之前讲过的部分就不说了,仔细看着个帖子就好): 

复制内容到剪贴板 

代码:

//提交保存

function edit_save() {

        var p = window.frames['uchome-ifrHtmlEditor'];//见下一行

        var obj = p.window.frames['HtmlEditor'];//和上面那句代码一起创建一个对象,指向了’uchome-ifrHtmlEditor’部分

        var status = p.document.getElementById(’uchome-editstatus’).value;//读取了’uchome- ifrHtmlEditor’内’uchome-editstatus’部分的值,用返回值来继续下面的判断

        if(status == ‘code’) {//如果是code的话(英汉字典:code=代码)

                $(’uchome-ttHtmlEditor’).value = p.document.getElementById(’sourceEditor’).value;//将html(也就是编辑器内生成的html)写 入那个id为’uchome-ttHtmlEditor’的textarea内部,这样的话,提交表单就不是空值了

        } else if(status == ‘text’) {//如果是text的话(英汉字典:text=文本)

                if(is_ie) {//如果在ie浏览器下,这个is_ie是这个js的全局变量,是有其他代码判断后生成的,不是js语言内置的,这里可能会有朋友乱用,说明一下

                        obj.document.body.innerText = p.document.getElementById(’dvtext’).value;

                        $(’uchome-ttHtmlEditor’).value = obj.document.body.innerHTML;//这两句都是将文本写入指定区域

                } else {//如果是其他浏览器

                        obj.document.body.textContent = p.document.getElementById(’dvtext’).value;

                        var sOutText = obj.document.body.innerHTML;

                        $(’uchome-ttHtmlEditor’).value = sOutText.replace(//r/n|/n/g,”<br>”);//类似上面的,将文本写入指定区域

                }//这两个不同的部分很典型的体现了js需要写出来不同浏览器兼容的代码,并不是在ie下成功,就在任何地方运行成功,这个是做产品时候的细节部分, 也是最基本的,其实很多时候程序是否好坏,这些细节地方体现的最多,但是不用到这里你看不出来开发者的功力,虽然只是一个非常基本和初级的地方,我也想这 样拓展说一下,做出来一个功能其实并不是很难,麻烦的是后期测试和修改bug时候,有时候开发时间如果是10的话,测试和后期整理代码要到30,这样1比 3的比例和一般人想象还是有出入的。

        } else {//如果是其他类新,则直接写入

                $(’uchome-ttHtmlEditor’).value = obj.document.body.innerHTML;//参考前面注释:写入值

        }

        backupContent($(’uchome-ttHtmlEditor’).value);//这个是方便下次恢复数据的代码。

}

你可能感兴趣的:(UCH群组功能增加编辑器(html+js详解))