Это старая версия документа!
Содержание
NicEdit
NicEdit — это облегченный, кроссплатформенный редактор встроенного контента, позволяющий легко редактировать содержимое веб-сайта в режиме реального времени прямо в браузере.
NicEdit Javascript интегрируется в любой сайт за считанные секунды, позволяя сделать любой элемент/div редактируемым или преобразовать стандартные текстовые поля в редактор форматированного текста.
Документация
This is the offical manual for the NicEdit WYSIWYG Editor. NicEdit is a Lightweight, Cross Platform, Inline Content Editor to allow easy editing of web site content on the fly in the browser. To download it go to http://nicedit.com/
- NicEdit Reference
- Plugin Reference
- Customization
About NicEdit
NicEdit — это лёгкий, кроссплатформенный редактор встроенного контента, позволяющий легко редактировать содержимое веб-сайта на лету прямо в браузере. Этот небольшой и простой в использовании JavaScript-редактор интегрируется в любой сайт за считанные секунды, делая любой элемент/div редактируемым или преобразуя стандартные текстовые поля в форматированный текст.
NicEdit был разработан Брайаном Кирхоффом и может свободно использоваться в любых целях под лицензией MIT.
Функции:
- Небольшой размер файла (<35 КБ в сумме), <10 КБ в сжатом виде!
- Для работы требуется всего 2 файла (js + иконки).
- Гибкая конфигурация: замена текстовых полей или блоков div.
- При желании несколько редакторов могут использовать один элемент управления.
- Сохранение контента с помощью AJAX или HTTP POST
- IE 5.5+ / FF 2+ / Opera 9+ / Safari 3+
NicEdit Reference
Javascript API
Class nicEditors
The nicEditors class provides convience methods to add NicEditor to the page or get a reference to a editor by ID
nicEditors.allTextAreas | Converts all the textareas on the page info NicEditor instances. Returns a reference to the array of all NicEdit instances on the page. |
nicEditors.findEditor | Finds a specific editor by ID if created using allTextAreas explitly For example to get the nicedit instance for <textarea id=«myArea2»></textarea> use: nicEditors.findEditor('myArea2'); The method returns a nicedit instance that you call the functions below on. Warning: In order to use this and other API methods, the editor must be finshed loading. To see an example of how you can use addEvent to have your code run after editor load see Editor Events |
nicEditors.editors[] | The raw array of all the NicEdit instances on the page |
Class nicInstance
The nicEditor instance class creates the editable area for a single element and provides a number of useful methods to developers. You can get a reference to a specific nicInstance object using
nicEditors.findEditor
[nicInstance].getContent() | Returns the current HTML of the nicInstance For example: nicEditors.findEditor('myArea2').getContent(); returns the HTML in the content editor that replaced the element on the page with ID 'myArea2'. |
[nicInstance].setContent(HTML) | Set the current HTML in the editor instance For example: nicEditors.findEditor('myArea2').setContent('<strong>Some HTML</strong> here'); |
[nicInstance].saveContent() | Only for nicInstances that are replacing a <textarea> this method syncs the content of the editor with the textarea value. This is done automatically if the form with the orginal <textarea> is submitted. However, you may want to explitly do the syncing yourself. |
Class nicEditor
The nicEditor class is a container for a number of nicEditor instances and 1 nicPanel. Because of this you can use nicEditor in 2 ways:
- Create a single control panel with setPanel() then use addInstance multiple times to create as many editable areas on the page you need that are controlled from a single control panel.
- Use the panelInstance() to create a combined content area/panel editor. If you use this option and want multiple editors you should create multiple nicEditor instances.
|var myNicEditor = new nicEditor() |Creates a new nicedit object. A single instance of nicEditor contains: -1 or more editor instances (nicInstance/nicIFrameInstance), -1 nicPanel|
myNicEditor.addInstance('someElementsID') | Adds a nicedit instance to allow inline editing of the given elements ID |
myNicEditor.removeInstance('someElementID') | Removes the nicedit instance with the given ID, returning it to the orginal element with the content within the element. |
myNicEditor.setPanel('someElementID') | Append an editor control panel at the end of the given ID. Normally the element is blank and with a fixed CSS width you would like the panel set. |
myNicEditor.panelInstance('someElementID') | Creates an inline content editor with attached control panel on top of the element. |
myNicEditor.instanceById('someElementID') | Find a nicInstance object by ID that was added to this nicEditor |
myNicEditor.floatingPanel() |