Основные функции редактирования

Общие функции редактирования находятся в окне документа. Это функции вставки текста, HTML и объектов; применения, изменения и удаления разметки шрифта и символов; изменения тегов и атрибутов и т.д.

Доступность

Dreamweaver 3.

Описание

Применяет указанный тип разметки символов к выделенной области. Если выбран курсор вставки, то разметка символов применяется к любому вводимому далее тексту.

Аргументы

tagName

• Аргумент tagName это имя тега, связанного с разметкой символов. Он должен представлять собой одну из следующих строк: «b», «cite», «code», «dfn», «em», «i», «kbd», «samp», «s», «strong», «tt», «u» или «var».

Возвращает

Ничего не возвращает.

dom.applyFontMarkup()

Доступность

Dreamweaver 3.

Описание

Применяет тег FONT и указанные атрибут и значение к текущему выделению.

Аргументы

атрибут, значение

• Аргумент attribute должен иметь значение «face», «size» или «color».

• Аргумент value представляет собой значение, связанное с атрибутом, например «Arial», «Helvetica», «sans-serif», «5» или «#FF0000».

Возвращает

Ничего не возвращает.

dom.deleteSelection()

Доступность

Dreamweaver 3.

Описание

Удаляет выделение в документе.

Аргументы

Нет.

Возвращает

Ничего не возвращает.

dom.editAttribute ()

Доступность

Dreamweaver 3.

Описание

Отображает соответствующий интерфейс для редактирования указанного атрибута документа. В большинстве случаев этот интерфейс представляет собой диалоговое окно. Эта функция действительна только для активного документа.

Аргументы

attribute

• Аргумент attribute это строка, указывающая атрибут тега, который нужно изменить.

Возвращает

Ничего не возвращает.

dom.exitBlock()

Доступность

Dreamweaver 3.

Описание

Выполняет выход из текущего блока абзаца или строки заголовка, оставляя точку вставки за пределами всех элементов блоков.

Аргументы

Нет.

Возвращает

Ничего не возвращает.

dom.getCharSet()

Доступность

Dreamweaver 4.

Описание

Возвращает атрибут charset в теге meta документа.

Аргументы

Нет.

Возвращает

Личность кодирования документа. Например, для документа Latin1 функция возвращает iso-8859-1.

dom.getFontMarkup()

Доступность

Dreamweaver 3.

Описание

Получает значение указанного атрибута тега FONT для выбранного фрагмента.

Аргументы

attribute

• Аргумент attribute должен иметь значение «face», «size» или «color».

Возвращает

Строка, содержащая значение указанного атрибута или пустой строки, если атрибут не задан.

dom.getLineFromOffset()

Доступность

Dreamweaver MX.

Описание

Находит номер строки для данного смещения символа в тексте (код HTML или JavaScript) файла.

Аргументы

offset

• Аргумент offset — это целое число, представляющее расположение символа от начала файла.

Возвращает

Целое число, представляющее номер строки в документе.

dom.getLinkHref ()

Доступность

Dreamweaver 3.

Описание

Возвращает ссылку, в которую заключен выделенный фрагмент. Эта функция эквивалентна циклическому проходу по родительским объектам в первом и втором поколении для текущего узла до тех пор, пока не будет найдена ссылка, затем для этой ссылки вызывается getAttribute('HREF').

Аргументы

Нет.

Возвращает

Строку, содержащую имя связанного файла в формате file:// URL-адрес.

dom.getLinkTarget ()

Доступность

Dreamweaver 3.

Описание

Возвращает цель ссылки, в которую заключен выделенный фрагмент. Эта функция эквивалентна циклическому проходу по родительским объектам в первом и втором поколении для текущего узла до тех пор, пока не будет найдена ссылка, затем для этой ссылки вызывается функция getAttribute('TARGET').

Аргументы

Нет.

Возвращает

Строка, содержащая значение атрибута TARGET для ссылки, либо пустая строка, если цель не указана.

dom.getListTag ()

Доступность

Dreamweaver 3.

Описание

Возвращает стиль выделенного списка.

Аргументы

Нет.

Возвращает

Строка, содержащая тег, связанный со списком («ul», «ol» или «dl»), либо пустая строка, если со списком не связан никакой тег. Это значение всегда возвращается в нижнем регистре.

dom.getTextAlignment ()

Доступность

Dreamweaver 3.

Описание

Возвращает выравнивание блока, содержащего выделение.

Аргументы

Нет.

Возвращает

Строку, содержащую значение атрибута ALIGN для тега, связанного с блоком, либо пустую строку, если атрибут ALIGN не задан для этого тега. Это значение всегда возвращается в нижнем регистре.

dom.getTextFormat ()

Доступность

Dreamweaver 3.

Описание

Возвращает формат выделенного блока текста.

Аргументы

Нет.

Возвращает

Строка, содержащая тег блока, связанный с текстом (например, «p», «h1», «pre» и т.д.) или пустую строку, если с выделенной областью не связан тег блока. Это значение всегда возвращается в нижнем регистре.

dom.hasCharacterMarkup ()

Доступность

Dreamweaver 3.

Описание

Проверяет, применена ли уже к выделению указанная разметка символа.

Аргументы

markupTagName

• Аргумент markupTagName это имя проверяемого тега. Он должен представлять собой одну из следующих строк: «b», «cite», «code», «dfn», «em», «i», «kbd», «samp», «s», «strong», «tt», «u» или «var».

Возвращает

Логическое значение, определяющее, имеет ли все выделение указанную разметку символа. Функция возвращает значение false, если указанную разметку имеет только часть выделения.

dom.indent ()

Доступность

Dreamweaver 3.

Описание

Формирует отступ у выделения с помощью тегов BLOCKQUOTE. Если выделение приходится на элемент списка, то данная функция формирует отступ для выделения путем преобразования выделенного элемента во вложенный список. Этот вложенный список имеет тот же тип, что и внешний список, и содержит один элемент, т.е. первоначальное выделение.

Аргументы

Нет.

Возвращает

Ничего не возвращает.

dom.insertHTML ()

Доступность

Dreamweaver 3.

Описание

Вставляет содержимое HTML в документ в текущей точке вставки.

Аргументы

contentToInsert, {bReplaceCurrentSelection}

• Аргумент contentToInsert представляет собой содержимое, которое нужно вставить.

• Аргумент bReplaceCurrentSelection, который является необязательным, представляет собой логическое значение, указывающее, должно ли содержимое заменять текущее выделение. Если аргумент bReplaceCurrentSelection имеет значение true, то содержимое заменяет текущее выделение. При значении false содержимое вставляется после текущего выделения.

Возвращает

Ничего не возвращает.

Пример

Следующий код вставляет строку HTML <b>130</b> в текущий документ:

Результат отображается в окне документа.

dom.insertObject ()

Доступность

Dreamweaver 3.

Описание

Вставляет указанный объект, при необходимости предлагая пользователю параметры.

Аргументы

objectName

• Аргумент objectName — это имя объекта в папке Configuration/Objects.

Возвращает

Ничего не возвращает.

Пример

Вызов функции dom.insertObject('Button') вставляет кнопку формы в активный документ после текущего выделения. Если ничего не выделено, эта функция вставляет кнопку в текущую точку вставки.

dom.insertText ()

Доступность

Dreamweaver 3.

Описание

Вставляет текстовое содержимое документа в текущей точке вставки.

Аргументы

contentToInsert, {bReplaceCurrentSelection}

• Аргумент contentToInsert это содержимое, которое требуется вставить.

• Аргумент bReplaceCurrentSelection, который является необязательным, представляет собой логическое значение, указывающее, должно ли содержимое заменять текущее выделение. Если аргумент bReplaceCurrentSelection имеет значение true, то содержимое заменяет текущее выделение. При значении false содержимое вставляется после текущего выделения.

Возвращает

Ничего не возвращает.

Пример

Следующий код вставляет текст &lt;b&gt;130&lt;/b&gt; в текущий документ:

Результаты отображаются в окне документа.

dom.newBlock ()

Доступность

Dreamweaver 3.

Описание

Создает новый блок с таким же тегом и атрибутами, как у блока, содержащего текущее выделение, либо создает новый абзац, если указатель находится за пределами всех блоков.

Аргументы

Нет.

Возвращает

Ничего не возвращает.

Пример

Если текущее выделение находится внутри абзаца с выравниванием по центру, то вызов функции dom.newBlock() дает вставку <p align="center"> после текущего абзаца.

dom.notifyFlashObjectChanged ()

Доступность

Dreamweaver 4.

Описание

Указывает Dreamweaver, что файл текущего объекта Flash был изменен. Dreamweaver обновляет отображение просмотра, при необходимости изменяя размер и сохраняя пропорции исходного изображения.

Аргументы

Нет.

Возвращает

Ничего не возвращает.

dom.outdent ()

Доступность

Dreamweaver 3.

Описание

Устанавливает выступ для выделенного фрагмента.

Аргументы

Нет.

Возвращает

Ничего не возвращает.

dom.removeCharacterMarkup ()

Доступность

Dreamweaver 3.

Описание

Удаляет указанный тип разметки символов в выделенном фрагменте.

Аргументы

tagName

• Аргумент tagName — это имя тега, связанного с разметкой символов. Он должен представлять собой одну из следующих строк: «b», «cite», «code», «dfn», «em», «i», «kbd», «samp», «s», «strong», «tt», «u» или «var».

Возвращает

Ничего не возвращает.

dom.removeFontMarkup ()

Доступность

Dreamweaver 3.

Описание

Удаляет указанный атрибут и его значение из тега FONT. Если после удаления атрибута остался только тег FONT, то этот тег FONT также удаляется.

Аргументы

attribute

• Аргумент attribute должен иметь значение «face», «size» или «color».

Возвращает

Ничего не возвращает.

dom.resizeSelection ()

Доступность

Dreamweaver 3.

Описание

Изменяет размеры выделенного объекта на указанные.

Аргументы

newWidth, newHeight

• Аргумент newWidth указывает новую ширину, которую функция задаст для выделенного объекта.

• Аргумент newHeight указывает новую высоту, которую функция задаст для выделенного объекта.

Возвращает

Ничего не возвращает.

dom.setAttributeWithErrorChecking ()

Доступность

Dreamweaver 3.

Описание

Возвращает указанный атрибут к указанному значению для текущего выделенного фрагмента, запрашивая значение у пользователя, если оно имеет неверный тип или выходит за пределы диапазона. Эта функция действительна только для активного документа.

Аргументы

атрибут, значение

• Аргумент attribute указывает атрибут, задаваемый для выделенного фрагмента.

• Аргумент value указывает значение, задаваемое для атрибута.

Возвращает

Ничего не возвращает.

dom.setLinkHref ()

Доступность

Dreamweaver 3.

Описание

Преобразует выделенный фрагмент в гипертекстовую ссылку или изменяет значение URL-адреса тега HREF, в который заключен выделенный фрагмент.

Аргументы

linkHREF

• Аргумент linkHREF — это URL-адрес (путь относительно документа, относительно корневой папки либо абсолютный URL-адрес), содержащий ссылку. Если этот аргумент пропущен, открывается диалоговое окно «Выбрать HTML».

Возвращает

Ничего не возвращает.

Enabler

См. dom.canSetLinkHref().

dom.setLinkTarget ()

Доступность

Dreamweaver 3.

Описание

Задает цель ссылки, в которую заключен выделенный фрагмент. Эта функция эквивалентна циклическому проходу по родительским объектам в первом и втором поколении для текущего узла до тех пор, пока не будет найдена ссылка, затем для этой ссылки вызывается функция setAttribute('TARGET') по ссылке.

Аргументы

{linkTarget}

• Необязательный аргумент linkTarget это строка, представляющая имя рамки, имя окна или одной из зарезервированных целей: («_self», «_parent», «_top» или «_blank»). Если аргумент не указан, появляется диалоговое окно «Задать цель».

Возвращает

Ничего не возвращает.

dom.setListBoxKind ()

Доступность

Dreamweaver 3.

Описание

Изменяет тип выбранного меню SELECT.

Аргументы

kind

• Аргумент kind должен иметь значение либо «menu», либо «list box».

Возвращает

Ничего не возвращает.

dom.showListPropertiesDialog ()

Доступность

Dreamweaver 3.

Описание

Открывает диалоговое окно «Свойства списка».

Аргументы

Нет.

Возвращает

Ничего не возвращает.

Enabler

См. dom.canShowListPropertiesDialog().

dom.setListTag ()

Доступность

Dreamweaver 3.

Описание

Задает стиль выделенного списка.

Аргументы

listTag

• Аргумент listTag — это тег, связанный со списком. Он должен иметь значение «ol», «ul», «dl» или быть пустой строкой.

Возвращает

Ничего не возвращает.

dom.setTextAlignment ()

Доступность

Dreamweaver 3.

Описание

Присваивает указанное значение атрибуту ALIGN блока, содержащего выделенный фрагмент.

Аргументы

alignValue

• Аргумент alignValue должен иметь значение «left», «center» или «right».

Возвращает

Ничего не возвращает.

dom.setTextFieldKind ()

Доступность

Dreamweaver 3 (устарел с выпуска Dreamweaver CS5.5)

Описание

Устанавливает формат выделенного текстового поля.

Аргументы

fieldType

• Аргумент fieldType должен иметь значение «input», «textarea» или «password».

Возвращает

Ничего не возвращает.

dom.setTextFormat ()

Доступность

Dreamweaver 4.

Описание

Задает формат блока для выделенного текста.

Аргументы

blockFormat

• Аргумент blockFormat — это строка, задающая один из следующих форматов: «» (без формата), «p», «h1», «h2», «h3», «h4», «h5», «h6» или «pre».

Возвращает

Ничего не возвращает.

dom.showFontColorDialog ()

Доступность

Dreamweaver 3.

Описание

Открывает диалоговое окно «Палитра цветов».

Аргументы

Нет.

Возвращает

Ничего не возвращает.

dreamweaver.deleteSelection ()

Доступность

Dreamweaver 3.

Описание

Удаляет выделенный фрагмент в активном документе либо на панели веб-сайта. На Macintosh удаляет текстовое поле, имеющее фокус в диалоговом окне или на всплывающей панели.

Аргументы

Нет.

Возвращает

Ничего не возвращает.

Enabler

См. dreamweaver.canDeleteSelection().

dreamweaver.editFontList ()

Доступность

Dreamweaver 3.

Описание

Открывает диалоговое окно «Изменить список шрифтов».

Аргументы

Нет.

Возвращает

Ничего не возвращает.

dreamweaver.getFontList ()

Доступность

Dreamweaver 3.

Описание

Возвращает список всех групп шрифтов, которые есть в инспекторе текстовых свойств и в диалоговом окне «Определение стиля».

Аргументы

Нет.

Возвращает

Массив строк, представляющих каждый элемент в списке шрифтов.

Пример

При установке Dreamweaver по умолчанию вызов функции dreamweaver.getFontList() возвращает массив, состоящий из следующих элементов:

• «Arial, Helvetica, sans-serif»

• «Times New Roman, Times, serif»

• «Courier New, Courier, mono»

• «Georgia, Times New Roman, Times, serif»

• «Verdana, Arial, Helvetica, sans-serif»

dreamweaver.getFontStyles()

Доступность

Dreamweaver 4.

Описание

Возвращает стили, поддерживаемые указанным шрифтом TrueType.

Аргументы

fontName

• Аргумент fontName — это строка, содержащая имя шрифта.

Возвращает

Массив из трех логических значений, указывающих, что поддерживает шрифт. Первое значение указывает, поддерживает ли шрифт полужирное начертание, второе указывает, поддерживает ли шрифт курсив, а третье — поддерживает ли шрифт одновременно полужирное начертание и курсив.

dreamweaver.getKeyState ()

Доступность

Dreamweaver 3.

Описание

Определяет, нажата ли указанная клавиша-модификатор.

Аргументы

key

• Аргумент key должен иметь одно из следующих значений: «Cmd», «Ctrl», «Alt» или «Shift». В Windows, «Cmd» и «Ctrl» относятся к клавише Control; на Macintosh «Alt» относится к клавише Option.

Возвращает

Логическое значение, которое указывает, нажата ли клавиша.

Пример

Следующий код проверяет перед выполнением операции, что одновременно нажаты клавиши Shift и Control (Windows) или Shift и Command (Macintosh):

dreamweaver.getNaturalSize ()

Доступность

Dreamweaver 4.

Описание

Возвращает ширину и высоту графического объекта.

Аргументы

url

• Аргумент url указывает на графический объект, для которого нужны размеры. Этот объект должен поддерживаться в Dreamweaver (GIF, JPEG, PNG, Flash и Shockwave). URL-адрес, предоставленный в качестве аргумента функции getNaturalSize(), должен быть абсолютным URL-адресом, указывающим на локальный файл. URL-адрес не может быть относительным.

Возвращает

Массив из двух целых чисел, где первое определяет ширину объекта, а второй определяет высоту.

dreamweaver.getSystemFontList ()

Доступность

Dreamweaver 4.

Описание

Возвращает список шрифтов для системы. Эта функция может возвращать либо все шрифты, либо только шрифты TrueType.

Аргументы

fontTypes

• Аргумент fontTypes — это строка, содержащая либо значение all, либо значение TrueType.

Возвращает

Массив строк, содержащих полные имена шрифтов. Возвращает значение null, если не найдено ни одного шрифта.

dreamweaver.getSystemFontName ()

Доступность

Dreamweaver CS5.

Описание

Возвращает имя системного шрифта.

Аргументы

Ничего не возвращает.

Возвращает

Строку, содержащую имя системного шрифта.