Obecné funkce pro úpravu se spravují v okně dokumentu. Tyto funkce umožňují vložit text, kód HTML a objekty, používat, měnit nebo odebírat písmo nebo znaky, označit či upravit tagy a atributy a mnohem více.
dom.applyCharacterMarkup()
Dostupnost
Dreamweaver 3.
Popis
K vybraným prvkům přiřadí požadovaný typ značení znaků. Pokud vyberete místo kurzoru, požadované značení znaků se použije u veškerého později zadaného textu.
Argumenty
tagName
Argument tagName představuje název tagu přiřazeného ke značení znaků. Použít můžete libovolný z následujících řetězců: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" nebo "var".
Vrátí
Nic.
dom.applyFontMarkup()
Dostupnost
Dreamweaver 3.
Popis
U vybraných prvků použije tag FONT, vybraný atribut a hodnotu.
Argumenty
attribute, value
Argument attribute musí mít hodnotu "face", "size" nebo "color".
Argument value představuje hodnotu, kterou chcete přiřadit k atributu (např. "Arial, Helvetica, sans-serif", "5" nebo "#FF0000".
Vrátí
Nic.
dom.deleteSelection()
Dostupnost
Dreamweaver 3.
Popis
Odstraní vybrané prvky v dokumentu.
Argumenty
Žádné.
Vrátí
Nic.
dom.editAttribute()
Dostupnost
Dreamweaver 3.
Popis
Zobrazí vhodné rozhraní pro úpravu vybraného atributu dokumentu. Ve většině případů se bude jednat o dialogové okno. Tato funkce je určena pouze pro aktivní dokument.
Argumenty
attribute
attribute představuje řetězec určující atribut tagu, který chcete upravit.
Vrátí
Nic.
dom.exitBlock()
Dostupnost
Dreamweaver 3.
Popis
Ukončí aktuální odstavec nebo blok nadpisu a přesune místo kurzoru mimo veškeré elementy bloku.
Argumenty
Žádné.
Vrátí
Nic.
dom.getCharSet()
Dostupnost
Dreamweaver 4.
Popis
Vrátí atribut charset v metatagu dokumentu.
Argumenty
Žádné.
Vrátí
Údaj o kódování dokumentu. Například u dokumentu Latin1 vrátí funkce hodnotu iso-8859-1.
dom.getFontMarkup()
Dostupnost
Dreamweaver 3.
Popis
Vrátí hodnotu vybraného atributu tagu FONT aktuálně vybrané položky.
Argumenty
attribute
Argument attribute musí mít hodnotu "face", "size" nebo "color".
Vrátí
Řetězec obsahující hodnotu vybraného atributu, případně prázdný řetězec, pokud není atribut nastaven.
dom.getLineFromOffset()
Dostupnost
Dreamweaver MX.
Popis
Vyhledá číslo řádku se zadaným posunem znaku v textu (kód HTML nebo JavaScript) souboru.
Argumenty
offset
Argument offset má podobu celého čísla představujícího umístění znaku vůči začátku souboru.
Vrátí
Celé číslo představující číslo řádku v dokumentu.
dom.getLinkHref()
Dostupnost
Dreamweaver 3.
Popis
Vrátí odkaz směrující na právě zvolené prvky. Tato funkce prochází nadřazené prvky první a druhé úrovně pro aktuální uzel, dokud nevyhledá odkaz a nevyvolá u něj příkaz getAttribute('HREF').
Argumenty
Žádné.
Vrátí
Řetězec obsahující název odkazovaného souboru ve formátu soubor:// adresa URL.
dom.getLinkTarget()
Dostupnost
Dreamweaver 3.
Popis
Vrátí cíl odkazu směrujícího na právě zvolené prvky. Tato funkce prochází nadřazené prvky první a druhé úrovně pro aktuální uzel, dokud nevyhledá odkaz a nevyvolá u něj příkaz getAttribute('TARGET').
Argumenty
Žádné.
Vrátí
Řetězec obsahující hodnotu atributu TARGET odkazu, případně prázdný řetězec, pokud není cíl nastaven.
dom.getListTag()
Dostupnost
Dreamweaver 3.
Popis
Vrátí styl vybraného seznamu.
Argumenty
Žádné.
Vrátí
Řetězec obsahující tag přiřazený k seznamu ("ul", "ol" nebo "dl"), případně prázdný řetězec, pokud není k seznamu přiřazen žádný tag. Tato hodnota se vrátí vždy jako malá písmena.
dom.getTextAlignment()
Dostupnost
Dreamweaver 3.
Popis
Vrátí zarovnání bloku obsahujícího vybrané prvky.
Argumenty
Žádné.
Vrátí
Řetězec obsahující hodnotu atributu ALIGN tagu přiřazeného k bloku, případně prázdný řetězec, pokud není atribut ALIGN pro tag nastaven. Tato hodnota se vrátí vždy jako malá písmena.
dom.getTextFormat()
Dostupnost
Dreamweaver 3.
Popis
Vrátí formát bloku s vybraným textem.
Argumenty
Žádné.
Vrátí
Řetězec obsahující tag bloku přiřazený k textu (např. "p", "h1", "pre" atd.), případně prázdný řetězec, pokud není k vybraným položkám přiřazen žádný tag bloku. Tato hodnota se vrátí vždy jako malá písmena.
dom.hasCharacterMarkup()
Dostupnost
Dreamweaver 3.
Popis
Ověří, zda již vybrané položky obsahují požadované značení znaků.
Argumenty
markupTagName
Argument markupTagName představuje název ověřovaného tagu. Použít můžete libovolný z následujících řetězců: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" nebo "var".
Vrátí
Booleovskou hodnotu vypovídající o tom, zda všechny vybrané položky obsahují požadované značení znaků. Funkce vrátí hodnotu false v případě, že požadované značení znaků je k dispozici pouze pro část vybraných položek.
dom.indent()
Dostupnost
Dreamweaver 3.
Popis
Odsadí vybrané položky pomocí tagů BLOCKQUOTE. Pokud je vybrána položka v seznamu, tato funkce odsadí vybrané položky jejich převedením na vnořený seznam. Tento vnořený seznam je stejného typu jako nadřazený seznam a obsahuje jedinou položku – původní výběr.
Argumenty
Žádné.
Vrátí
Nic.
dom.insertHTML()
Dostupnost
Dreamweaver 3.
Popis
Vloží obsah HTML v aktuálním místě kurzoru v dokumentu.
Argumenty
contentToInsert, {bReplaceCurrentSelection}
Argument contentToInsert představuje obsah, který chcete vložit.
Argument bReplaceCurrentSelection je volitelný a představuje Booleovskou hodnotu, která určuje, zda má obsah nahradit stávající vybrané položky. Pokud bude mít argument bReplaceCurrentSelection hodnotu true, obsah aktuálně vybrané položky nahradí. Bude-li mít hodnotu false, obsah se vloží až za aktuálně vybrané položky.
Vrátí
Nic.
Příklad
Následující kód do stávajícího dokumentu vloží řetězec HTML <b>130</b>:
var theDOM = dw.getDocumentDOM(); theDOM.insertHTML('<b>130</b>');
Výsledek se projeví v okně dokumentu.
dom.insertObject()
Dostupnost
Dreamweaver 3.
Popis
Vloží vybraný objekt a podle potřeby vyzve uživatele k zadání parametrů.
Argumenty
objectName
Argument objectName představuje název objektu ve složce Configuration/Objects.
Vrátí
Nic.
Příklad
V rámci volání funkce dom.insertObject('Button') se za aktuálně vybrané položky v aktivním dokumentu vloží tlačítko formuláře. Pokud jste žádné položky nevybrali, funkce vloží tlačítko v aktuálním místě kurzoru.
I když je možné soubory s objekty ukládat v samostatných složkách, je nezbytné, aby měly tyto soubory jedinečné názvy. Pokud se bude nacházet soubor Button.htm ve složce Forms i ve složce MyObjects, aplikace Dreamweaver mezi nimi nedokáže rozlišovat.
dom.insertText()
Dostupnost
Dreamweaver 3.
Popis
Vloží obsah textu v aktuálním místě kurzoru v dokumentu.
Argumenty
contentToInsert, {bReplaceCurrentSelection}
Argument contentToInsertpředstavuje obsah, který chcete vložit.
Argument bReplaceCurrentSelection je volitelný a představuje Booleovskou hodnotu, která určuje, zda má obsah nahradit stávající vybrané položky. Pokud bude mít argument bReplaceCurrentSelection hodnotu true, obsah aktuálně vybrané položky nahradí. Bude-li mít hodnotu false, obsah se vloží až za aktuálně vybrané položky.
Vrátí
Nic.
Příklad
Následující kód do stávajícího dokumentu vloží text <b>130</b> :
var theDOM = dreamweaver.getDocumentDOM(); theDOM.insertText('<b>130</b>');
Výsledek se projeví v okně dokumentu.
dom.newBlock()
Dostupnost
Dreamweaver 3.
Popis
Vytvoří nový blok se stejným tagem a atributy jako v případě bloku obsahujícího stávající vybrané položky, nebo vytvoří nový odstavec v případě, že se kurzor nachází mimo všechny bloky.
Argumenty
Žádné.
Vrátí
Nic.
Příklad
Pokud se aktuálně vybrané položky nachází uvnitř odstavce zarovnaného na střed, volání funkce dom.newBlock() vloží na konec aktuálního odstavce tag <p align="center">.
dom.notifyFlashObjectChanged()
Dostupnost
Dreamweaver 4.
Popis
Informuje aplikaci Dreamweaver, že se aktuální soubor s objektem Flash změnil. Aplikace Dreamweaver poté aktualizuje zobrazení Náhled a podle potřeby upraví jeho velikost, aniž by však změnila poměr šířky a výšky oproti originálu.
Argumenty
Žádné.
Vrátí
Nic.
dom.outdent()
Dostupnost
Dreamweaver 3.
Popis
Odsadí vybrané položky.
Argumenty
Žádné.
Vrátí
Nic.
dom.removeCharacterMarkup()
Dostupnost
Dreamweaver 3.
Popis
Z vybraných prvků odebere zadaný typ značení znaků.
Argumenty
tagName
Argument tagName představuje název tagu přiřazeného ke značení znaků. Použít můžete libovolný z následujících řetězců: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" nebo "var".
Vrátí
Nic.
dom.removeFontMarkup()
Dostupnost
Dreamweaver 3.
Popis
Odstraní vybraný atribut a jeho hodnotu z tagu FONT. Pokud po odebrání atributu zůstane pouze samotný tag FONT, odstraní se i tento tagFONT.
Argumenty
attribute
Argument attribute musí mít hodnotu "face", "size" nebo "color".
Vrátí
Nic.
dom.resizeSelection()
Dostupnost
Dreamweaver 3.
Popis
Změní velikost vybraného objektu podle zadaných rozměrů.
Argumenty
newWidth, newHeight
Argument newWidthpředstavuje novou šířku, podle které funkce vybraný objekt upraví.
Argument newHeightpředstavuje novou výšku, podle které funkce vybraný objekt upraví.
Vrátí
Nic.
dom.setAttributeWithErrorChecking()
Dostupnost
Dreamweaver 3.
Popis
Nastaví v rámci aktuálně vybraných položek u vybraného atributu vybranou hodnotu a upozorní uživatele, pokud je hodnota nevhodného typu, nebo pokud je mimo povolený rozsah. Tato funkce je určena pouze pro aktivní dokument.
Argumenty
attribute, value
Argument attribute určuje atribut, který chcete v rámci aktuálně vybraných položek změnit.
Argument value určuje hodnotu, kterou chcete u atributu nastavit.
Vrátí
Nic.
dom.setLinkHref()
Dostupnost
Dreamweaver 3.
Popis
Vytvoří z vybraných položek hypertextový odkaz, nebo upraví hodnotu adresy URL v tagu HREF uzavírajícího aktuálně vybrané položky.
Argumenty
linkHREF
Argument linkHREF představuje adresu URL (dokument, relativní cesta, cesta v souvislosti s kořenovým adresářem nebo absolutní adresa URL) tvořící odkaz. Pokud tento argument neuvedete, otevře se dialogové okno Výběr souboru HTML.
Vrátí
Nic.
Aktivace
Viz dom.canSetLinkHref().
dom.setLinkTarget()
Dostupnost
Dreamweaver 3.
Popis
Nastaví cíl odkazu směrujícího na právě zvolené prvky. Tato funkce prochází nadřazené prvky první a druhé úrovně pro aktuální uzel, dokud nevyhledá odkaz a nevyvolá u něj příkaz setAttribute('TARGET).
Argumenty
{linkTarget}
Argument linkTarget je volitelný a představuje řetězec s názvem rámce, názvem okna nebo jedním z vyhrazených cílů ("_self", "_parent", "_top" nebo "_blank"). Pokud argument neuvedete, otevře se dialogové okno Výběr cíle.
Vrátí
Nic.
dom.setListBoxKind()
Dostupnost
Dreamweaver 3.
Popis
Změní typ vybrané nabídky SELECT.
Argumenty
kind
Argument kind musí mít hodnotu "menu" nebo "list box".
Vrátí
Nic.
dom.showListPropertiesDialog()
Dostupnost
Dreamweaver 3.
Popis
Otevře dialogové okno Vlastnosti seznamu.
Argumenty
Žádné.
Vrátí
Nic.
Aktivace
dom.setListTag()
Dostupnost
Dreamweaver 3.
Popis
Nastaví styl vybraného seznamu.
Argumenty
listTag
Argument listTag představuje tag přiřazený k seznamu. Musí obsahovat hodnotu "ol", "ul", "dl", nebo se musí jednat o prázdný řetězec.
Vrátí
Nic.
dom.setTextAlignment()
Dostupnost
Dreamweaver 3.
Popis
Nastaví zadanou hodnotu atributu ALIGN bloku, který obsahuje vybrané položky.
Argumenty
alignValue
Argument alignValue musí mít hodnotu "left", "center" nebo "right".
Vrátí
Nic.
dom.setTextFieldKind()
Dostupnost
Dreamweaver 3 (zastaralé od verze Dreamweaver CS5.5)
Popis
Nastaví formát vybraného textového pole.
Argumenty
fieldType
Argument fieldType musí mít hodnotu "input", "textarea" nebo "password".
Vrátí
Nic.
dom.setTextFormat()
Dostupnost
Dreamweaver 4.
Popis
Nastaví formát bloku s vybraným textem.
Argumenty
blockFormat
Argument blockFormat představuje řetězec pro zadání jednoho z následujících formátů: "" (žádný formát), "p", "h1", "h2", "h3", "h4", "h5", "h6" nebo "pre".
Vrátí
Nic.
dom.showFontColorDialog()
Dostupnost
Dreamweaver 3.
Popis
Otevře dialogové okno Výběr barev.
Argumenty
Žádné.
Vrátí
Nic.
dreamweaver.deleteSelection()
Dostupnost
Dreamweaver 3.
Popis
Odstraní vybrané položky v aktivním dokumentu nebo na panelu Web. V systému Macintosh odstraní textové pole s vybraným dialogovým oknem nebo plovoucím panelem.
Argumenty
Žádné.
Vrátí
Nic.
Aktivace
dreamweaver.editFontList()
Dostupnost
Dreamweaver 3.
Popis
Otevře dialogové okno Úprava seznamu písem.
Argumenty
Žádné.
Vrátí
Nic.
dreamweaver.getFontList()
Dostupnost
Dreamweaver 3.
Popis
Vrátí seznam všech skupin písem uvedených v textovém poli Inspektor vlastností a v dialogovém okně Definice stylu.
Argumenty
Žádné.
Vrátí
Řada řetězců představujících každou z položek v seznamu písem.
Příklad
Ve výchozím nastavení aplikace Dreamweaver vrátí volání funkce dreamweaver.getFontList() řadu obsahující následující položky:
"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()
Dostupnost
Dreamweaver 4.
Popis
Vrátí styly podporované vybraným písmem TrueType.
Argumenty
fontName
Argument fontName představuje řetězec obsahující název písma.
Vrátí
Řadu tří booleovských hodnot, které značí podporu daného písma. První hodnota informuje o tom, jestli písmo podporuje styl tučný, druhá styl kurzíva a třetí tučný i kurzíva současně.
dreamweaver.getKeyState()
Dostupnost
Dreamweaver 3.
Popis
Určuje, zda došlo ke stisku uvedené upravující klávesy.
Argumenty
key
Argument key musí obsahovat jednu z následujících hodnot: "Cmd", "Ctrl", "Alt" nebo "Shift". V systému Windows odpovídá hodnota "Cmd" a "Ctrl" klávese Ctrl a v systému Macintosh odpovídá hodnota "Alt" klávese Alt.
Vrátí
Booleovskou hodnotu informující o případném stisku klávesy.
Příklad
Následující kód umožňuje před provedením dané operace ověřit, zda uživatel stiskl klávesu Shift nebo Ctrl (Windows), případně Shift nebo Cmd (Macintosh):
if (dw.getKeyState("Shift") && dw.getKeyState("Cmd")){ // execute code }
dreamweaver.getNaturalSize()
Dostupnost
Dreamweaver 4.
Popis
Vrátí informaci o šířce a výšce grafického objektu.
Argumenty
url
Argument url přesměruje na grafický objekt, jehož rozměry požadujete. Aplikace Dreamweaver musí tento objekt podporovat (GIF, JPEG, PNG, Flash nebo Shockwave). Adresa URL uvedená jako argument funkce getNaturalSize() musí být absolutní adresou URL směrující do místního souboru. Nesmí se tedy jednat o relativní adresu URL.
Vrátí
Řadu dvou celých čísel, kde první celé číslo definuje šířku objektu a druhé jeho výšku.
dreamweaver.getSystemFontList()
Dostupnost
Dreamweaver 4.
Popis
Vrátí seznam písem v systému. Tato funkce umožňuje vrátit všechna písma nebo pouze písma TrueType.
Argumenty
fontTypes
Argument fontTypes představuje řetězec obsahující hodnotu all nebo hodnotu TrueType.
Vrátí
Řadu řetězců obsahujících celý název písma. Pokud nebudou písma nalezena, vrátí hodnotu null.
dreamweaver.getSystemFontName()
Dostupnost
Dreamweaver CS5.
Popis
Vrátí název písma v systému.
Argumenty
Nic.
Vrátí
Řetězec obsahující název písma v systému.