初始化
在初始化TinyMCE的时候,需要把以下代码加入到页面的HEAD标签中。按以下例子中的设置,所有的TEXTAREA文本域在页面加载时将被转换成编辑器。另外还有其他模块,我们将在后面详细讲述。
<!-- tinyMCE --> <script language="javascript" type="text/javascript" src="jscripts/tiny_mce/tiny_mce.js"></script> <script language="javascript" type="text/javascript"> tinyMCE.init({ mode : "textareas" }); </script> <!-- /tinyMCE --> |
注意以上红色部分是tiny_mce.js脚本文件的位置,该文件中包含了编辑器所需要的全部代码,主题及语言包将在初始化时被加载。
蓝色部分是初始化调用,它生成TinyMCE的全局实例,其中的设置及名称-值属性将在以后描述。
设置
以名称-值属性方式传递给tinyMCE的init方法的设置控制着程序的全局行为。所有的键及可能的键值如下表所示。注意,用[]括起来的名称是可选的,不是必须的设置。
常规设置 | |||||||||||||||||||
mode | Mode可以是以下几个值之一: textareas - 页面加载时把所有TEXTAREA组件转换成编辑器. specific_textareas - 将所有"mce_editable"属性值为true的TEXTAREA转换成编辑器. exact - 只转换在"elements"设置中指定的确切组件. |
||||||||||||||||||
[theme] | 指定要使用的主题名称,主题将被放在TinyMCE的themes目录下,默认为default。TinyMCE自带三个内置的主题,它们是simple,default和advanced。 如果你想创建自己的主题,请仔细阅读文档的主题 部分。 |
||||||||||||||||||
[plugins] | 此选项是一系列以逗号分隔的主题插件列表(例如,可以只用来扩展图像对话框)。这些插件覆盖了主题模板中定义的功能。插件逻辑应该包含在一个叫"editor_plugin.js"的文件中,它是插件目录中唯一被包含进来的文件。 例如:"my_image_dialog,my_link_dialog". 如果你想创建自己的插件,请仔细阅读文档的主题 部分。 |
||||||||||||||||||
[language] | TinyMCE中使用的语言包,这应该是像se,uk,us等诸如此类的FN代码,它被用来从"langs"目录中获取语言包,该设置的默认值为"uk". 中文用户建议您使用"zh-CN" |
||||||||||||||||||
[elements] | 以逗号分隔的用来转换成编辑器的组件列表,该选项仅在"mode"选项被设置成"exact"时使用。该列表中的元素可以是任何有id或name属性的HTML组件。 | ||||||||||||||||||
[ask] | 当"mode"被设置成"textareas"或"specific_textareas"的时候,该选项被应用,询问用户输入框是否将被转换成编辑器。 如果你想使用这个选项,将它设置为true. |
||||||||||||||||||
[textarea_trigger] | textarea(文本域)触发器的属性,默认值为"mce_editable"。 该选项仅在"mode"被设置为"specific_textareas"时使用。 |
||||||||||||||||||
[valid_elements] | 以逗号分隔开的组件转换部分的列表。 例如: a[href|target=_blank],strong/b,div[align],br. 以上例子告诉TinyMCE移除所有除了"a, strong, div"和"br"的组件,将元素b转换成strong,默认target设为"_blank"并保持href、target、align属性。在匹配组件及属性的名称时可以使用像*,+,?这样的通配符。 字符:
特殊变量: {$uid} - 产生一个唯一ID号。 例如:"p[id:{$uid}]". 此选项的默认值是以下模式: "a[href|target],strong/b[class],em/i[class],strike[class],u[class],p[class|align],ol,ul,li,br, img[class|src|border=0|alt|hspace|vspace|width|height|align],sub,sup,blockquote[dir|style], table[border=0|cellspacing|cellpadding|width|height|class|align],tr[rowspan], td[colspan|rowspan|width|height],div[class|align],span[class|align],pre[class|align], address[class|align],h1[class|align],h2[class|align],h3[class|align], h4[class|align],h5[class|align],h6[class|align],hr". 要包含所有组件及属性,请使用 *[*] ,这在使用invalid_elements选项时特别有用。 |
||||||||||||||||||
[extended_valid_elements] | 向"valid_elements"列表末尾添加可用组件。 |