document.execCommand()

document.execCommand() - виконує текстову команду форматування.

Синтаксис:

window.document.execCommand( commandIdentifier , showDefaultUI, value);

Параметри:

window - об'єкт window. Не обов'язково вказувати якщо посилатися на поточне вікно.

document - об'єкт document.

CommandName - рядок який містить назву команди. Назва команди не чутлива до регістру.

showDefaultUI - логічне значення, яке вказує чи слід відображати інтерфейс призначений для користувача.

value - параметр (аргумент) який приймає команда, якщо параметр не потрібний вказують null.

Опис:

document.execCommand() метод об'єкту document який виконує команди форматування тексту щоб змінюють вміст редагування.

Коли властивість document.designMode дорівнює true ("on") включається режим WYSIWYG який дозволяє редагувати текст веб-сторінки у браузері.

У режимі WYSIWYG доступні текстові команди форматування які виконуються методом document.execCommand().

При використанні contentEditable, виклик execCommand() буде впливати на поточний активний редагований елемент.

backColor - зміна кольору фону.
Internet Explorer використовує цю функцію, щоб встановити колір фону тексту.

document.execCommand("backColor", 0, 'red');

bold - перемикає жирним шрифтом вкл/викл для виділеного тексту або в точці вставки.
Internet Explorer використовує
```

```
тег замість
```

```
.document.execCommand("bold");
contentReadOnly - робить вміст тільки для читання або редагування. Для цього потрібно логічне значення true / false передати в якості значення параметру.document.execCommand("contentReadOnly", false, false);
copy - копіює поточний вибраний елемент в буфер обміну.
Не всі браузери дозволяють.
document.execCommand("copy");
cut - вирізає виділення і копіює його в буфер обміну.
Не всі браузери дозволяють.
document.execCommand("cut");
paste - вставляє вміст з буфера обміну в точці вставки або замінює виділення.
Не всі браузери дозволяють.
document.execCommand("paste", false, null);
delete - видаляє виділене.document.execCommand('delete');
createLink - створює посилання (силку) для виділення. Для цього потрібно рядок з URI адресою передати в якості значення параметру. document.execCommand("CreateLink",true,'http://яваскрипт.укр/');
decreaseFontSize -додає тег
```

```
навколо виділення або в точці вставки. document.execCommand("decreaseFontSize");
delete - видаляє поточне виділення. document.execCommand("delete");
enableObjectResizing - включає / виключає чи показувати ручку зміни розміру на зображеннях та інших об'єктів із змінними розмірами.document.execCommand("enableObjectResizing", true, true);
fontName - зміна назви шрифту для вибору або в точці вставки.document.execCommand("FontName", true, "Arial");
fontSize - зміна розміру шрифту для вибору або в точці вставки. Розмір шрифту HTML ( 1- 7) , який буде прийнятий в якості значення аргументу. document.execCommand("FontSize", true, 1);
foreColor - зміна кольору шрифту для вибору або в точці вставки.document.execCommand("foreColor", true, "red");
formatBlock - додає HTML блок навколо рядка, що містить виділення, замінивши блок-елемент, що містить рядок. Ім'я тега вказується в параметрі.Практично всі теги блоку можуть бути використані. Наприклад. "H1", "Р", "DL", "BLOCKQUOTE". document.execCommand("formatBlock", true, "h1");
forwardDelete - видаляє символ попереду позиції курсора. Аналогічно натисканю клавіші Backspace. document.execCommand("forwardDelete");
heading - додає заголовок навколо виділеного або у місці вставки. Назву тегу заголовку вказую у параметрі (тобто "h1"-"h6").
hiliteColor - зміна кольору фону для виділеного або в точці вставки. Рядок з значенням кольору передається в параметрі.document.execCommand("hiliteColor", "red");
increaseFontSize - додає тег BIG навколо виділеного або в точці вставки. document.execCommand("increaseFontSize");
indent - додає один відступ до виділеного або в точці вставки.document.execCommand("indent", false,null);
outdent - видаляє один відступ у виділенні або в точці вставки.document.execCommand("outdent", false, null);
insertBrOnReturn - вставляє тег br або розбиває поточний елемент на два блоки. Виділене замінює.
insertHorizontalRule - вставляє горизонтальну лінію в точці вставки або замінює виділення.document.execCommand("insertHorizontalRule", false,null);
insertHTML - вставляє рядок HTML в точці вставки або замінює виділення. Рядок з HTML тегами передається у параметрі. document.execCommand("insertHTML", false, "B");
insertImage - вставляє зображення в точці вставки або заміняє виділене. У параметрі вказується рядок з URI адресою зображення.document.execCommand("insertImage", false, "http://яваскрипт.укр/_images/device-pixels.png");
insertOrderedList - створює нумерований упорядкований список для виділеного або в точці вставки.document.execCommand("insertOrderedList", false, null);
insertUnorderedList - створює маркований невпорядкований список для виділеного або в точці вставки.document.execCommand("insertUnorderedList", false, null);
insertParagraph - вставляє абзац навколо виділення або в точці вставки. document.execCommand("insertParagraph", false, null);
insertText - вставляє простий текст в точці вставки або замінює виділення.document.execCommand("insertText", false, 'JavaScript');
HTML теги вставляє як звичайний текст:
document.execCommand("insertText", false, 'JavaScript');
italic - вкл/викл курсив для виділення або в точці вставки.document.execCommand("italic", false, null);
justifyCenter - вирівнювання по центру виділене або точку вставки. document.execCommand("justifyCenter", false, null);
justifyFull - вирівнювання по ширині виділене або точку вставки. document.execCommand("justifyFull", false, null);
justifyLeft - вирівнювання по лівому краю виділене або точку вставки. document.execCommand("justifyLeft", false, null);
justifyRight - вирівнювання по правому краю виділене або точку вставки.document.execCommand("justifyRight", false, null);
removeFormat - видаляє всі форматування з виділення. document.execCommand("removeFormat", false, null);
selectAll - виділяє весь зміст редагованої області.document.execCommand("selectAll", false, null);
unselect - відміняє поточне виділення. document.execCommand("unselect");
strikeThrough - вкл / викл перекреслення для виділення або в точці вставки.document.execCommand("strikeThrough", false, null);
subscript - включення / виключення нижній індекс для виділення або в точці вставки.document.execCommand("subscript", false, null);
superscript - включення / виключення верхній індекс для виділення або в точці вставки.document.execCommand("superscript", false, null);
underline - включення / виключення підкреслення для виділення або в точці вставки.document.execCommand("underline");
undo - скасовує останню виконану команду.document.execCommand("undo");
unlink - видаляє силку з обраного посилання.document.execCommand("unlink");
useCSS - включає використання тегів HTML або стилів CSS. Логічне значення true / false передається у параметрі. false - використовувати CSS. true - використовувати HTML.
Це команда застаріла використовуйте замість неї "styleWithCSS". document.execCommand("useCSS", false, true);
styleWithCSS - замінює команду "useCSS". Передається у параметрі логічне значення. true - використання HTML тегів, false - використання CSS стилів. document.execCommand("StyleWithCSS", false, true); if(!document.execCommand("StyleWithCSS", false, true)) document.execCommand("UseCSS", false, false);
print - виводить діалогове вікно для друку. document.execCommand("print",true,null);

Не всі браузери підтримують усі команди. Для перевірки чи підтримує браузер команду форматування використовуте метод document.queryCommandSupported().

Приклад:

document.designMode='on';
document.execCommand('selectAll');

document.designMode='on';
document.execCommand('selectAll');
document.execCommand("justifyCenter", false, null);