Javascript-Referência JavaScript - Letras A a C
Este capítulo é uma referência alfabética de todos os objetos, propriedades, métodos, manipuladores de eventos e funções.
Para cada propriedade, a seção "Descontinuada(Tainted/Deprecated)"? indica se a propriedade está marcada para ser descontinuada por padrão.
Pode funcionar em alguns browser mas no futuro, provavelmente, representará problemas.
Para obter informações sobre descontinuada, consulte :
"Using data tainting for security", "taint", and "untaint".

[Arquivo posterior (letras D a E)]

Aqui temos um parágrafo com o id=destino...veja tag anchor

abs()

Definição: Função Matemática
Biblioteca: Math
Tipo: Método.
Finalidade: Retorna o valor absoluto (Módulo) de um número.
Sintaxe: Math.abs(número)
Parâmetros: numero é qualquer expressão numérica ou uma propriedade de um objeto existente. Não pode ser omitido(required)
Descrição: Se o número recebido for positivo, retorna o mesmo número.
Se for negativo, retorna o número só que positivo sem qualquer arredondamento, só troca o sinal.
exemplo: <div><script>document.write(Math.abs(-4.783943));</script></div>
Teste:
Nota(s): Math.abs("String") = NaN
Math.abs(null) = 0



accessKey

Definição: Parâmetro/Propriedade de tag HTML
Biblioteca: DOM
Tipo: Parâmetro
Finalidade: Define ou obtém a tecla de atalho para a tag.
Sintaxe: var x = document.getElementById("link").accessKey;
Parâmetros: elemento html Pode ser qualquer elemento html.
Descrição: Toda tag HTML pode ter uma tecla de atalho para facilitar seu uso e normalmente é acessada pelas teclas shift, control, alt pressionadas conjuntamente com uma letra.
exemplo: var x = document.getElementById("meubotao").accessKey;
Exemplo abaixo :
<button id="meubotao" accesskey="w" onfocus='alert("Este botão recebeu o foco")' >
       Clique em [Alt]+w e veja se este botão recebe o foco da app.
</button>
Pressione 'esc' para sair.
Teste: Pressione 'esc' para sair.
Nota(s): O atributo accesskey é um parâmetro da tag HTML que especifica uma tecla de atalho para ativar ou focar um elemento.
O valor do atributo de acesso deve ser um único caractere (uma letra ou um dígito).
A forma de acessar a tecla de atalho varia em diferentes navegadores:
Browser Windows Linux Mac
Internet Explorer [alt] + accessKey    
Chrome [alt] + accessKey [alt] + accessKey [control] + [option] + accessKey
FireFox [alt] + [shift] + accessKey [alt] + [shift] + accessKey [control] + [option] + accessKey
Safari [alt] + accessKey   [control] + [option] + accessKey
Opera 15 ou mais novo : [alt] + accessKey
12.1 ou anterior : [shift] + [esc] + accessKey

acos()

Definição: Função Matemática
Biblioteca: Math
Tipo: Método.
Finalidade: Retorna o arco cosseno (em radianos) de um número.
Retorna o arco cujo cosseno daria o valor do parâmetro recebido.
Sintaxe: Math.acos(número)
Parâmetros: número é o cosseno do ângulo que desejamos descobrir o ângulo. Este parâmetro não pode ser omitido.
O valor dele deve estar em -1 e 1 (veja circulo trignométrico).
Descrição: O método acos é a função inversa do cosseno. No cosseno você dá o angulo e retorna o cosseno. No Acos você dá o cosseno e ele retorna o ângulo.
Retorna um valor numérico do angulo,em radianos, que daria o cosseno recebido como parâmetro. Esse cosseno pode variar de +- pi radianos (PI=180 graus).
Ex: Se o cosseno for -1 a função acos retornará o ângulo PI radianos (180 graus).
exemplo: <script>document.write(Math.acos(-1));</script>
Teste:
Nota(s): Se o parâmetro estiver fora de faixa (-1 a 1) este método retornará NaN.
O ângulo retornado estará em radianos(-¶ a +¶).
Importante : Para converter o angulo de graus para radianos multiplique o angulo por PI e divida por 180 (isto sempre dará um ângulo entre 0 e 2PI (6,28).)
ângulo -1 = -180 graus.



acosh()

Definição: Função Matemática
Biblioteca: Math
Tipo: Método.
Finalidade: Retorna o arco cosseno hiperbólico (em radianos) de um número.
Retorna o arco cujo cosseno hiperbólico que daria o valor do parâmetro recebido.
Sintaxe: Math.acosh(número)
Parâmetros: número é o cosseno hiperbólico do ângulo que desejamos descobrir o ângulo. Este parâmetro não pode ser omitido.
O valor dele deve ser maior que 1.
Descrição: O método acosh é a função inversa do cosseno hiperbólico. No cosseno hiperbólico você dá o angulo e retorna o cosseno hiperbólico. No Acosh você dá o cosseno hiperbólico e ele retorna o ângulo hiperbólico.
Retorna um valor numérico do angulo,em radianos, que daria o cosseno hiperbólico recebido como parâmetro. Esse cosseno hiperbólico pode variar de +- pi radianos (PI=180 graus).
exemplo: <script>document.write(Math.acosh(2.87));</script>
Teste:
Nota(s): Se o parâmetro estiver fora de faixa (menor que 1) este método retornará NaN.
O ângulo retornado estará em radianos(-¶ a +¶).
Importante : Para converter o angulo de graus para radianos multiplique o angulo por PI e divida por 180 (isto sempre dará um ângulo entre 0 e 2PI (6,28).)
ângulo -1 = -180 graus.

activeElement

Definição: No documento HTML sempre tem um objeto que tem o foco da página.
A propriedade activeElement aponta para ele.
Biblioteca: Document-DOM
Tipo: Propriedade
Finalidade: A propriedade activeElement retorna o elemento atualmente em foco no documento.
Sintaxe: document.activeElement
Parâmetros: Nenhum
Descrição: Retorna o elemento HTML que no momento tem o foco da página.
exemplo:    <div id="meuElementoAtivo">
       <script>
        var x = document.activeElement.tagName;
        document.write(x);
       </script>
   </div>
Teste:
Nota(s): No resultado do teste acima recebemos no load da página que a tag ativa no load do documento é a tag body.
Importante : O parâmetro activeElement é Apenas Leitura (ReadOnly), ou seja, podemor ler mas não alterar.
Infelizmente no IOS todas tags que não são input type text esta função retorna o activeElement do body se existir ou null.



addEventListener

Definição: O método document.addEventListener () anexa um manipulador de eventos ao documento ou tag.
Biblioteca: Documento, Elemento-DOM
Tipo: Método
Finalidade: Adicionar o tratamento de um evento ao elemento html.
Sintaxe: document.addEventListener(evento, função, ModoDeCaptura)
Parâmetros: evento : designa qual evento irá disparar a funcionalidade (click, over, etc.).
função : É uma função ( normalmente feita em JavaScript ) que tratará o evento.
E o ModoDeCaptura que pode ser false (bubbling-borbulhamento-default) ou true (Capturing).
Nota : Ao omitir o parâmetro ModoDeCaptura será utilizado o bubbling(default - false).
Descrição: Adiciona um manipulador ('handler') de um determinado evento a um elemento html do documento corrente.
exemplo:    Clique aqui para disparar o evento click recém adicionado a este controle :
   <input type="text" id="demoAddEventListener" />
   <script>
       document.addEventListener("click", function () {
        document.getElementById("demoAddEventListener").value = "Não é que funciona";
       });
   </script>
Teste: Clique aqui para disparar o evento click recém adicionado a este controle :
Nota(s): 1-Você pode adicionar o mesmo evento a diferentes objetos do DOM mas nunca dois tratamentos de evento ao mesmo objeto do DOM. Cada objeto só admite uma função de tratamento para cada evento.
2-Os eventos mais comuns são : Assunto html - 09-Eventos



alert

Definição: Interface com o usuário.
Biblioteca: Objeto Window
Tipo: Método.
Finalidade: Exibe uma caixa de diálogo Alerta com uma mensagem que pode ser customizada pelo programador da mensagem e um botão OK.
Sintaxe: alert("mensagem")
Parâmetros: message é qualquer string ou uma propriedade de um objeto existente.
Descrição: Emite uma caixa de diálogo de alerta com uma mensagem customizável e um botão de Ok.
Esta caixa de diálogo é exibida no modo Modal, ou seja, não é possível clicar em mais nada além do botão OK da caixa de alerta.
No exemplo abaixo há um botão. Clique nele e será exibida um alerta.
Use o método alert para exibir uma mensagem que não requer uma decisão do usuário. O argumento message especifica uma mensagem que a caixa de diálogo contém.
Embora o alert seja um método do objeto window, você não precisa especificar uma windowReference ao chamá-lo. Por exemplo, windowReference.alert() é desnecessário.
Você não pode especificar um título para uma caixa de diálogo de alerta, mas pode usar o método aberto para criar sua própria caixa de diálogo "alerta".
Exemplo:             <form>
                <input type="button" value="Clique aqui para que um caixa de diálogo de alerta seja exibida"
                       onclick='alert("Desta vez foi só um teste mas normalmente é uma mensagem que alerta o usuário sobre um ponto importante.")'>
            </form>
Teste:
Nota(s): É um dos principais recursos de depuração dos scripts JavaScript. A grande maioria dos testes damos um alert(x) onde x é algo que desejamos saber se tem ou não o valor esperado, de uma variável, propriedade, objeto, etc.



alinkColor

Definição: HTML-Cor de exibição do(s) Link(s)
Biblioteca: Document
Tipo: Propriedade.
Finalidade: Determina que seja usada uma cor específica para um link ativo, ou seja, depois do botão do mouse é pressionado, mas antes que o botão do mouse seja liberado.
Sintaxe: document.alinkColor
Parâmetros: Uma cor. Veja descrição abaixo.
Descrição: Obsoleta desde DOM Level 2 (HTML 4.01) - Utilizar o CSS : active em seu lugar.
Esta propriedade é o reflexo de JavaScript do atributo alink da tag <body>.
A propriedade alinkColor é expressa como um trigêmeo RGB hexadecimal ou como uma das literais de seqüência de caracteres listadas em Valores de cor.
R é a quantidade de cor vermelha(RED), G é a quantidade de cor verde (Green) e B é a quantidade de cor azul (Blue).
Por exemplo, os valores hexadecimais de RGB para salmão são vermelho=FA, verde=80 e azul=72, portanto, o trigêmeo RGB para salmão é "#FA8072".
Podemos definir a cor pelo seu nome como aquamarine, lightblue, purple, etc.
Temos as seguintes cores de links : cor do link novo [a:link()], cor do link visitado[a:visited()], cor do link quando o mouse esta sobre ele [a:hover()], cor do link que tem o foco da página:[active()].
Exemplo: document.alinkColor="aqua"
document.alinkColor="#00FFFF"
Teste: Não é possível dar exemplo desta funcionalidade pelo motivo que este item se aplica quando o link não foi visitado e o mouse foi clicado. Por esse motivo funcionaria a primeira vez e depois teríamos que fechar e abrir o browser para refazer o teste.
Se precisar ajuda na escolha de uma cor visite : Assunto: CSS- 11-Escolhendo Cor.html
Nota(s): Obsoleta desde DOM Level 2 (HTML 4.01) - Utilizar o CSS : active em seu lugar.
O motivo pelo qual foi removida é que tudo que é formatação ou estilo foi migrado no html5 para a CSS.



adoptNode

Definição: Document.adoptNode () transfere um nó de outro documento para o documento do método.
O nó adotado e sua subárvore são removidos de seu documento original (se houver), e seu ownerDocument é alterado para o documento atual.
O nó pode é inserido no documento atual.
Biblioteca: Document-DOM
Tipo: Método
Finalidade: Mover um nó do documento origem para o documento destino.
Sintaxe: document.adoptNode(document, XMLDocument);
Parâmetros: XMLDocument é opcional. Usado apenas quando desejamos incluir um nó de um documento XML.
Descrição: Move um nó de outro documento para o documento atual.
Se um nó que pertence a outro documento e precisa ser inserido no documento atual, ele deverá ser importado primeiro. Os nós podem ser importados com os métodos adoptNode e importNode.
O método adoptNode move o nó de origem, enquanto o método importNode o copia.
A subárvore inteira que pertence ao nó é movida ou copiada por esses métodos, embora o método importNode também possa ser usado para copiar um nó sem seus descendentes.
Devido a restrições de segurança, o conteúdo de um documento pode ser acessado de outro documento apenas se os dois documentos estiverem localizados no mesmo domínio. Se você deseja copiar um nó dentro de um documento, use o método cloneNode.
exemplo: var frame = document.getElementsByTagName("IFRAME")[0];
var h = frame.contentWindow.document.getElementsByTagName("H1")[0];
var x = document.adoptNode(h);
Teste: Clique aqui para disparar o evento click recém adicionado a este controle :
Nota(s): 1-Você pode adicionar o mesmo evento a diferentes objetos do DOM mas nunca dois tratamentos de evento ao mesmo objeto do DOM. Cada objeto só admite uma função de tratamento para cada evento.
2-Os eventos mais comuns são : Assunto html - 09-Eventos
3-Em mais de 25 anos de experiência nesta área nunca usei esta funcionalidade. Costumamos usar o innerHTML para transferir valores de um elemento para outro mas não mover o elemento de uma parte do documento para outra.



altkey

Definição: Devolve um booleano(True/False) se a tecla ALT estava pressionada quando o evento ocorreu.
Biblioteca: Event-Document-DOM
Tipo: Propriedades dos Eventos disparados pelo teclado / Mouse
Finalidade: Estender o teclado através da combinação de teclas.
Modificar a percepção da tecla dando mais funcionalidades ao teclado.
Sintaxe: Exemplo: <body onkeydown="funcao(event);">. Veja script abaixo.
Parâmetros: Não tem.
Descrição: Devolve True se a tecla ALT estava pressionada quando o evento disparado pelo teclado ou mouse.
exemplo: <script>
      function funcao1(e) {
        alert(
            "ALT key : " +
            e.altKey +
            "\n"
        );
      }
    </script>
Teste:
Nota(s): Esta propriedade é definida nos eventos de teclado e mouse. Portanto, no teclado por exemplo, será dentro do evento onkeydown="funcao(event);" que teremos acesso a funcionalidade altkey. No caso do mouse será no evento onclick ou em outro similar(onfocus etc.).
Por exemplo, ao pressionar a tecla S estamos digitando apenas a tecla S mas com ALT + S podemos definir uma funcionalidade para salvar o arquivo ou seja lá qual contexto desejarmos para a combinação das teclas.



anchor

Tipo: Parâmetro de Tag <a>.
Finalidade: Quando você clica num link ele vai de uma origem para um destino. Esse destino pode ser uma página ou um ponto no interior da página. Para marcar esse ponto específico de destino em uma página usamos a 'pseudo-tag' anchor que nada mais é que o parâmetro id de uma tag qualquer.
Define um ponto de destino para um link permitindo o deslocamento direto para uma parte da página definida.
Sendo assim uma tag <a> poderá ir diretamente para esse ponto quando no parâmetro href colocamos caractere # seguido do nome do ponto criado.
O link a ser clicado fará com que a exibição do documento seja deslocada não só para a página desejada ( se for o caso) mas também para um ponto especídico de destino nessa página.
Sintaxe: Definição da anchor - destino do link :
<p id="destino">Aqui temos um parágrafo com o id=destino...veja tag anchor</p>

Definição do link que ao ser clicado exibira o ponto definido do documento:
<a href="#destino">Clique aqui para ir ao destino</a>
Parâmetros: id dá um nome ao ponto do documento. Na tag <a> o parametro href="#id" fará o documento apontar para o ponto.
Descrição: Define um ponto em um documento de maneira que um link possa navegar diretamente para esse ponto da página. O parâmetro id indentifica a âncora (destino) enquanto na tag <a href="#id"> cria o link para esse destino.
Exemplo: <p id="destino">Aqui temos um parágrafo com o id=destino...veja tag anchor</p>
Teste: Clique aqui para ir ao destino
Nota(s): •O parâmetro id deve ser único em todo documento.
•Podemos combinar o link para acessar uma página externa diretamente no ponto desejado, como faço neste site. Para isto basta combinar o parâmetro url do tipo href="paginaDeDestino.html#pontodesejado" onde ponto desejado seria o id de alguma tag de destino do link na página de destino.

animationname

Tipo: Propriedade CSS <a>.
Finalidade: Permite alterar o nome de uma animação de uma css.
Sintaxe: document.getElementById("minhaDIV").style.animationName = "meuNovoNomeAnimacao";
Supondo que a CSS tenha sido aplicada numa classe da div minhaDIV.
Parâmetros: meuNovoNomeAnimacao é o nome da nova animação a ser aplicado no objeto.
Descrição: Animação é a movimentação de objetos do documento dinâmicamente e automaticamente pelo browser.
A animação na CSS é um recurso fantástico para sites onde a movimentação de um objeto é importante, como num logo empresarial que vai se montando aos poucos.
Literalmente concorre com um vídeo em igualdade de recursos. Usamos junto com keyframes para tomar as decisões de alterar a animação.
Exemplo: object.style.animationName retorna o nome da animação corrente.
object.style.animationName = "none|keyframename|initial|inherit" define o novo nome da animação a ser aplicada ao estilo do objeto.
Teste:
Nota(s): •Este recurso é da CSS e portanto será melhor tratado neste site na •Toda animação pode ser definida como sendo um conjunto de movimentos a serem feitos com o objeto. Sendo assim tem uma linha de tempo associada a aplicação dessas movimentações e, durante o percorrer dessa linha de tempo, podemos alterar a movimentação que no momento está sendo aplicada ao objeto.
•O parâmetro none desliga a animação do estilo.
•O parâmetro keyframename define em qual keyframe a animação deve ser aplicada.
•O parâmetro initial define que a animação deverá ser aplicada na sua condição inicial.
•O parâmetro inherit define que a animação deverá prosseguir da situação atual seja onde ela se encontrar no momento.

appCodename

Property. A string specifying the code name of the browser.

Syntaxe

navigator.appCodename

Propriedade de

navigator
Navigator 2.0

Depreciada?

No

Descrição

appCodename is a read-only property.

Exemplos

The following example displays the value of the appCodename property:
document.write("The value of navigator.appCodename is " +
   navigator.appCodename)
For Navigator 2.0 and 3.0, this displays the following:
The value of navigator.appCodename is Mozilla
appname, appVersion, javaEnabled, userAgent properties

Applet

Object. Includes a Java applet in a web page.

HTML Syntaxe

To include a Java applet in a web page, use standard HTML Syntaxe:
<aPPLET
   CODE=classFilename
   HEIGHT=height
   WIDTH=width
   MAYSCRIPT
   [name=appletname]
   [CODEBASE=classFileDirectory]
   [ALT=alternateText]
   [ALIGN="left"|"right"|
      "top"|"absmiddle"|"absbottom"|
      "texttop"|"middle"|"baseline"|"bottom"]
   [HSPACE=spaceInPixels]
   [VSPACE=spaceInPixels]>
   [<PARAM name=parametername VALUE=parameterValue>]
   [ ... <PARAM>]
</aPPLET>

HTML attributes

CODE=classFilename specifies the file name of the applet that you want to load. This file name must end in a .class extension.
HEIGHT=height specifies the height of the applet in pixels within the browser window.
WIDTH=width specifies the width of the applet in pixels within the browser window.
MAYSCRIPT permits the applet to access JavaScript. Use this attribute to prevent an applet from accessing JavaScript on a page without your knowledge. If omitted, the applet will not work with JavaScript.
name=appletname specifies the name of the applet. You can use this name when indexing the applets array.
CODEBASE=classFileDirectory specifies directory of the .class file, if it is different from the directory that contains the HTML page.
ALT=alternateText specifies text to display for browsers that do not support the <aPPLET> tag.
ALIGN=alignment specifies the alignment of the applet on the HTML page.
HSPACE=spaceInPixels specifies a horizontal margin for the applet, in pixels, within the browser window.
VSPACE=spaceInPixels specifies a vertical margin for the applet, in pixels, within the browser window.
<PARAM> defines a parameter for the applet.
name=parametername specifies the name of the parameter.
VALUE=parameterValue> specifies a value for the parameter.

Syntaxe

To use an applet object:
document.applets[index]

Parametros

index is an integer representing an applet in a document or the name of an Applet objeto as specified by the name attribute.

Propriedade de

document
Navigator 3.0

Descrição

The author of an HTML page must permit an applet to access JavaScript by specifying the MAYSCRIPT attribute of the <aPPLET> tag. This prevents an applet from accessing JavaScript on a page without the knowledge of the page author. For example, to allow the musicPicker.class applet access to JavaScript on your page, specify the following:
<aPPLET CODE="musicPicker.class" WIDTH=200 HEIGHT=35
   name="musicApp" MAYSCRIPT>
Accessing JavaScript when the MAYSCRIPT attribute is not specified results in an exception.
For more information on using applets, see Chapter 4, "LiveConnect."

The applets array

You can reference the applets in your code by using the applets array. This array contains an entry for each Applet objeto (<aPPLET> tag) in a document in source order. For example, if a document contains three applets, these applets are reflected as document.applets[0], document.applets[1], and document.applets[2].
To use the applets array:
1. document.applets[index]
2. document.applets.length
index is an integer representing an applet in a document or the name of an Applet objeto as specified by the name attribute.
To obtain the number of applets in a document, use the length property: document.applets.length.
Elements in the applets array are read-only. For example, the statement document.applets[0]="myApplet.class" has no effect.

Properties

All public properties of the applet are available for JavaScript access to the Applet object.
The applets array has the following properties:
Property Descrição
length
Reflects the number of <aPPLET> tags in the document

métodos

Event handlers

None.

Exemplos

The following code launches an applet called "musicApp":
<aPPLET CODE="musicSelect.class" WIDTH=200 HEIGHT=35
   name="musicApp" MAYSCRIPT>
</aPPLET>
For more Exemplos, see Chapter 4, "LiveConnect."
MimeType, Plugin objects; Chapter 4, "LiveConnect"

applets

Property. An array reflecting all the applets in a document in source order. See the Applet objeto for information.

appname

Property. A string specifying the name of the browser.

Syntaxe

navigator.appname

Propriedade de

navigator
Navigator 2.0

Depreciada?

No

Descrição

appname is a read-only property.

Exemplos

The following example displays the value of the appname property:
document.write("The value of navigator.appname is " +
   navigator.appname)
For Navigator 2.0 and 3.0, this displays the following:
The value of navigator.appname is Netscape
appCodename, appVersion, javaEnabled, userAgent properties

appVersion

Property. A string specifying version information for the Navigator.

Syntaxe

navigator.appVersion

Propriedade de

navigator
Navigator 2.0

Depreciada?

No

Descrição

The appVersion property specifies version information in the following format:
releaseNumber (platform; country)
The values contained in this format are the following:
appVersion is a read-only property.

Exemplos

Example 1. The following example displays version information for the Navigator:
document.write("The value of navigator.appVersion is " +
   navigator.appVersion)
For Navigator 2.0 on Windows 95, this displays the following:
The value of navigator.appVersion is 2.0 (Win95, I)
For Navigator 3.0 on Windows NT, this displays the following:
The value of navigator.appVersion is 3.0 (WinNT, I)
Example 2. The following example populates a Textarea objeto with newline characters separating each line. Because the newline character varies from platform to platform, the example tests the appVersion property to determine whether the user is running Windows (appVersion contains "Win" for all versions of Windows). If the user is running Windows, the newline character is set to \r\n; otherwise, it's set to \n, which is the newline character for Unix and Macintosh.
<SCRIPT>
var newline=null
function populate(textareaObject){
   if (navigator.appVersion.lastIndexOf('Win') != -1)
      newline="\r\n"
      else newline="\n"
   textareaObject.value="line 1" + newline + "line 2" + newline
          + "line 3"
}
</SCRIPT>
<FORM name="form1">
<BR><TEXTAREA name="testLines" ROWS=8 COLS=55></TEXTAREA>
<P><INPUT TYPE="button" VALUE="Populate the Textarea object"
   onClick="populate(document.form1.testLines)">
</TEXTAREA>
</FORM>
appCodename, appname, userAgent properties

Area

Object. Defines an area of an image as an image map. When the user clicks the area, the area's hypertext reference is loaded into its target window. Area objects are a type of Link object. For information on Area objects, see Link object.

arguments array

Property. An array corresponding to elements of a function.

Syntaxe

To use the arguments array:
1. functionname.arguments[index]
2. functionname.arguments.length

Parametros

functionname is the name of a function you have created or the name of a variable or a Propriedade de an existing objeto that has been assigned a Function objeto using new.
index is an integer representing an element of a function or the name of a function as specified in the function declaration.

Propriedade de

Function object, any user-defined function (see See "Defining and calling functions")

Depreciada?

No

Descrição

You can call a function with more arguments than it is formally declared to accept by using the arguments array. This technique is useful if a function can be passed a variable number of arguments. You can use arguments.length to determine the number of arguments passed to the function, and then treat each argument by using the arguments array.
The arguments array is available only within a function declaration. Attempting to access the arguments array outside a function declaration results in an error.
The this keyword does not refer to the currently executing function, so you must refer to functions and Function objects by name, even within the function body.

Properties

The arguments array has the following properties:
Property Descrição
length
Reflects the number of arguments to the function

Exemplos

This example defines a function that creates HTML lists. The only formal argument for the function is a string that is "U" if the list is to be unordered (bulleted), or "O" if the list is to be ordered (numbered). The function is defined as follows:
function list(type) {
   document.write("<" + type + "L>")
   for (var i=1; i<list.arguments.length; i++) {
      document.write("<LI>" + list.arguments[i])
      document.write("</" + type + "L>")
   }
}
You can pass any number of arguments to this function, and it displays each argument as an item in the type of list indicated. For example, the following call to the function
list("U", "One", "Two", "Three")
results in this output:
<UL>
<LI>One
<LI>Two
<LI>Three
</UL>
caller

arguments property

Property. An array of elements in a function. See the arguments array for information.

Depreciada?

No

Array

Object. Lets you create arrays and work with them.

Syntaxe

To create an Array object:
1. arrayObjectname = new Array([arrayLength])
2. arrayObjectname = new Array([element0, element1, ..., elementn])
To use Array objects:
1. arrayObjectname.propertyname
2. arrayObjectname.methodname(Parametros)

Parametros

arrayObjectname is either the name of a new objeto or a Propriedade de an existing object. When using Array properties and métodos, arrayObjectname is either the name of an existing Array objeto or a Propriedade de an existing object.
arrayLength is the initial length of the array. You can access this value using the length property.
elementn is a list of values for the array's elements. When this form is specified, the array is initalized with the specified values as its elements, and the array's length property is set to the number of arguments.
propertyname is one of the properties listed below.
methodname is one of the métodos listed below.

Propriedade de

None.

Descrição

The Array objeto is a built-in JavaScript object.
You can specify an initial length when you create the array. The following code creates an array of five elements:
billingMethod = new Array(5)
When you create an array, all of its elements are initially null. The following code creates an array of 25 elements, then assigns values to the first three elements:
musicTypes = new Array(25)
musicTypes[0] = "R&B"
musicTypes[1] = "Blues"
musicTypes[2] = "Jazz"
An array's length increases if you assign a value to an element higher than the current length of the array. The following code creates an array of length zero, then assigns a value to element 99. This changes the length of the array to 100.
colors = new Array()
colors[99] = "midnightblue"
You can construct a dense array of two or more elements starting with index 0 if you define initial values for all elements. A dense array is one in which each element has a value. The following code creates a dense array with three elements:
myArray = new Array("Hello", myVar, 3.14159)
In Navigator 2.0, you must index arrays by their ordinal number, for example document.forms[0]. In Navigator 3.0, you can index arrays by either their ordinal number or their name (if defined). For example, suppose you define the following array:
myArray = new Array("Wind","Rain","Fire")
You can then refer to the first element of the array as myArray[0] or myArray["Wind"].

Properties

The Array objeto has the following properties:
Property Descrição
length
Reflects the number of elements in an array
prototype
Lets you add a properties to an Array object.

métodos

The Array objeto has the following métodos:
  • eval
  • join
  • reverse
  • sort
  • toString
  • valueOf

  • Event handlers

    None.

    Exemplos

    Example 1. The following example creates an array, msgArray, with a length of 0, then assigns values to msgArray[0] and msgArray[99], changing the length of the array to 100.
    msgArray = new Array()
    msgArray [0] = "Hello"
    msgArray [99] = "world"
    if (msgArray .length == 100)     // This is true, because defined msgArray [99] element.
       document.write("The length is 100.")
    Veja também the Exemplos for the onError event handler.
    Example 2: Two-dimensional array. The following code creates a two-dimensional array and displays the results.
    a = new Array(4)
    for (i=0; i < 4; i++) {
       a[i] = new Array(4)
       for (j=0; j < 4; j++) {
          a[i][j] = "["+i+","+j+"]"
       }
    }
    for (i=0; i < 4; i++) {
       str = "Row "+i+":"
       for (j=0; j < 4; j++) {
          str += a[i][j]
       }
       document.write(str,"<p>")
    }
    This example displays the following results:
    Multidimensional array test
    Row 0:[0,0][0,1][0,2][0,3]
    Row 1:[1,0][1,1][1,2][1,3]
    Row 2:[2,0][2,1][2,2][2,3]
    Row 3:[3,0][3,1][3,2][3,3]
    Image object

    asin

    Tipo: Médodo biblioteca MATH.
    Finalidade: Calcula qual o tamanho do arco que gera o seno recebido por parâmetro.
    O ângulo é em radianos.
    Sintaxe: Math.asin(x)
    Parâmetros: x é o valor do seno do ângulo que devemos obter o arco.
    Varia de -1 a +1 ( limites do círculo trignométrico).
    Descrição: Calcula o arco que produz o seno recebido por parâmetro pela função.
    Este valor deve estar entre -1 e 1 senão a método retornará NaN.
    MATH.asin é um método estático, ou seja, não é necessário instanciar o objeto MATH ( tipo var x as new MATH).
    Exemplo: Math.asin(-1); retorna -1.5707963267948966 = PI/2.
    Math.asin(-2); retorna NaN
    Math.asin(0.5); retorna 0.5235987755982989 = PI/6.
    Teste: Math.asin(0.5) =
    Nota(s): Todas as funções trignométricas são suportadas pelo Javascript:
    • Math.sin() : Seno.
    • Math.cos() : Cosseno.
    • Math.tan() : Tangente.
    • Math.asin() : Arco-Seno.
    • Math.acos() : Arco-Cosseno.
    • Math.atan() : Arco-Tangente.
    • Math.atan2() : Arco-Tangente 2(Retorna extremos).
    O método asin retorna um valor númerico entre -pi/2 e pi/2 radianos.
    Se o valor parametro estiver fora dessa faixa irá retornar NaN.

    atan

    Tipo: Médodo biblioteca MATH.
    Finalidade: Calcula qual o tamanho do arco que gera a tangente recebido por parâmetro.
    O ângulo é em radianos.
    Sintaxe: Math.atan(x)
    Parâmetros: x é o valor da tangente do ângulo que devemos obter o arco.
    Varia de -1 a +1 ( limites do círculo trignométrico).
    Descrição: Calcula o arco que produz a tangente recebida por parâmetro pela função.
    Este valor deve estar entre -1 e 1 senão a método retornará NaN.
    MATH.atan é um método estático, ou seja, não é necessário instanciar o objeto MATH ( tipo var x as new MATH).
    Exemplo: Math.atan(1); retorna 0.7853981633974483.
    Math.atan(-2); retorna NaN
    Math.atan(0.5); retorna 0.5235987755982989 = PI/6.
    Teste: Math.asin(0.5) =
    Nota(s): Todas as funções trignométricas são suportadas pelo Javascript:
    • Math.sin() : Seno.
    • Math.cos() : Cosseno.
    • Math.tan() : Tangente.
    • Math.asin() : Arco-Seno.
    • Math.acos() : Arco-Cosseno.
    • Math.atan() : Arco-Tangente.
    • Math.atan2() : Arco-Tangente 2(Retorna extremos).
    O método asin retorna um valor númerico entre -pi/2 e pi/2 radianos.
    Se o valor parametro estiver fora dessa faixa irá retornar NaN.

    atan2

    Method. Returns the angle in radians from the X axis to a point.

    Syntaxe

    Math.atan2(x,y)

    Parametros

    x is either a numeric expression or a Propriedade de an existing object, representing the cartesian x-coordinate.
    y is either a numeric expression or a Propriedade de an existing object, representing the cartesian y-coordinate.

    Método de

    Math

    Descrição

    The atan2 method returns a numeric value between 0 and 2pi representing the angle theta of an (x,y) point. This is the counter-clockwise angle, measured in radians, between the positive X axis, and the point (x,y).
    atan2 is passed separate x and y arguments, and atan is passed the ratio of those two arguments.

    Exemplos

    The following function returns the angle of the polar coordinate:
    function getAtan2(x,y) {
       return Math.atan2(x,y)
    }
    If you pass getAtan2 the values (90,15), it returns 1.4056476493802699; if you pass it the values (15,90), it returns 0.16514867741462683.
    acos, asin, atan, cos, sin, tan métodos

    back

    Method. Loads the previous URL in the history list.

    Syntaxe

    history.back()

    Método de

    history object

    Descrição

    This method performs the same action as a user choosing the Back button in the Navigator. The back method is the same as history.go(-1).

    Exemplos

    The following custom buttons perform the same operations as the Navigator Back and Forward buttons:
    <P><INPUT TYPE="button" VALUE="< Back"
       onClick="history.back()">
    <P><INPUT TYPE="button" VALUE="> Forward"
       onClick="history.forward()">
    forward, go métodos

    bgColor

    Property. A string specifying the color of the document background.

    Syntaxe

    document.bgColor

    Propriedade de

    document

    Depreciada?

    No

    Descrição

    The bgColor property is expressed as a hexadecimal RGB triplet or as one of the string literals listed in "Color values". This property is the JavaScript reflection of the BGCOLOR attribute of the <BODY> tag. The default value of this property is set by the user on the Colors tab of the Preferences dialog box, which is displayed by choosing General Preferences from the Options menu.
    You can set the bgColor property at any time.
    If you express the color as a hexadecimal RGB triplet, you must use the format rrggbb. For example, the hexadecimal RGB values for salmon are red=FA, green=80, and blue=72, so the RGB triplet for salmon is "FA8072."

    Exemplos

    The following example sets the color of the document background to aqua using a string literal:
    document.bgColor="aqua"
    The following example sets the color of the document background to aqua using a hexadecimal triplet:
    document.bgColor="00FFFF"
    alinkColor, fgColor, linkColor, vlinkColor properties

    big

    Method. Causes a string to be displayed in a big font as if it were in a <BIG> tag.

    Syntaxe

    stringname.big()

    Parametros

    stringname is any string or a Propriedade de an existing object.

    Método de

    String

    Descrição

    Use the big method with the write or writeln métodos to format and display a string in a document.

    Exemplos

    The following example uses string métodos to change the size of a string:
    var worldString="Hello, world"

    document.write(worldString.small())
    document.write("<P>" + worldString.big())
    document.write("<P>" + worldString.fontsize(7))
    The previous example produces the same output as the following HTML:
    <SMALL>Hello, world</SMALL>
    <P><BIG>Hello, world</BIG>
    <P><FONTSIZE=7>Hello, world</FONTSIZE>
    fontsize, small métodos

    blink

    Method. Causes a string to blink as if it were in a <BLINK> tag.

    Syntaxe

    stringname.blink()

    Parametros

    stringname is any string or a Propriedade de an existing object.

    Método de

    String

    Descrição

    Use the blink method with the write or writeln métodos to format and display a string in a document.

    Exemplos

    The following example uses string métodos to change the formatting of a string:
    var worldString="Hello, world"

    document.write(worldString.blink())
    document.write("<P>" + worldString.bold())
    document.write("<P>" + worldString.italics())
    document.write("<P>" + worldString.strike())
    The previous example produces the same output as the following HTML:
    <BLINK>Hello, world</BLINK>
    <P><B>Hello, world</B>
    <P><I>Hello, world</I>
    <P><STRIKE>Hello, world</STRIKE>
    bold, italics, strike métodos

    blur

    Method. Removes focus from the specified object.

    Syntaxe

    1. fileUploadname.blur()
    2. passwordname.blur()
    3. selectname.blur()
    4. textname.blur()
    5. textareaname.blur()
    6. frameReference.blur()
    7. windowReference.blur()

    Parametros

    fileUploadname is either the value of the name attribute of a FileUpload objeto or an element in the elements array.
    passwordname is either the value of the name attribute of a Password objeto or an element in the elements array.
    selectname is either the value of the name attribute of a Select objeto or an element in the elements array.
    textname is either the value of the name attribute of a Text objeto or an element in the elements array.
    textareaname is either the value of the name attribute of a Textarea objeto or an element in the elements array.
    frameReference is a valid way of referring to a frame, as described in the Frame object.
    windowReference is a valid way of referring to a window, as described in the window object.

    Método de

    Button object, Checkbox object, FileUpload object, Frame object, Password object, Radio object, Reset object object, Select object, Submit object, Text object, Textarea object, window object

    Descrição

    Use the blur method to remove focus from a specific form element, window, or frame. Removing focus from a window sends the window to the background in most windowing systems.

    Exemplos

    The following example removes focus from the password element userPass:
    userPass.blur()
    This example assumes that the password is defined as
    <INPUT TYPE="password" name="userPass">
    focus method, select method

    bold

    Method. Causes a string to be displayed as bold as if it were in a <B> tag.

    Syntaxe

    stringname.bold()

    Parametros

    stringname is any string or a Propriedade de an existing object.

    Método de

    String

    Descrição

    Use the bold method with the write or writeln métodos to format and display a string in a document.

    Exemplos

    The following example uses string métodos to change the formatting of a string:
    var worldString="Hello, world" 
    document.write(worldString.blink())
    document.write("<P>" + worldString.bold())
    document.write("<P>" + worldString.italics())
    document.write("<P>" + worldString.strike())
    The previous example produces the same output as the following HTML:
    <BLINK>Hello, world</BLINK>
    <P><B>Hello, world</B>
    <P><I>Hello, world</I>
    <P><STRIKE>Hello, world</STRIKE>
    blink, italics, strike métodos

    Boolean

    Object. Lets you work with Boolean values. The Boolean objeto is an objeto wrapper for a boolean value.

    Syntaxe

    To create a Boolean object:
    booleanObjectname = new Boolean(value)
    To use a Boolean object:
    booleanObjectname.propertyname

    Parametros

    booleanObjectname is either the name of a new objeto or a Propriedade de an existing object. When using Boolean properties, booleanObjectname is either the name of an existing Boolean objeto or a Propriedade de an existing object.
    value is the initial value of the Boolean object. The value is converted to a boolean value, if necessary. If value is omitted or is 0, null, false, or the empty string "", it the objeto has an initial value of false. All other values, including the string "false" create an objeto with an initial value of true.
    propertyname is one of the properties listed below.

    Propriedade de

    None

    Descrição

    The Boolean objeto is a built-in JavaScript object.
    Use a Boolean objeto when you need to convert a non-boolean value to a boolean value. You can use the Boolean objeto any place JavaScript expects a primitive boolean value. JavaScript returns the primitive value of the Boolean objeto by automatically invoking the valueOf method.

    Properties

    The Boolean objeto has the following properties:
    Property Descrição
    prototype
    Lets you add a properties to a Boolean object.

    métodos

    Event handlers

    None.

    Exemplos

    The following Exemplos create Boolean objects with an initial value of false:
    bNoParam = new Boolean()
    bZero = new Boolean(0)
    bNull = new Boolean(null)
    bEmptyString = new Boolean("")
    bfalse = new Boolean(false)
    The following Exemplos create Boolean objects with an initial value of true:
    btrue = new Boolean(true)
    btrueString = new Boolean("true")
    bfalseString = new Boolean("false")
    bSuLin = new Boolean("Su Lin")

    border

    Property. A string specifying the width, in pixels, of an image border.

    Syntaxe

    imagename.border

    Parametros

    imagename is either the name of an Image objeto or an element in the images array.

    Propriedade de

    Image

    Depreciada?

    No

    Descrição

    The border property reflects the BORDER attribute of the <IMG> tag. For images created with the Image() constructor, the value of the border property is 0.
    border is a read-only property.

    Exemplos

    The following function displays the value of an image's border property if the value is not zero.
    function checkBorder(theImage) {
       if (theImage.border==0) {
          alert('The image has no border!')
       }
       else alert('The image's border is ' + theImage.border)
    }
    height, hspace, vspace, width properties

    Button

    Object. A pushbutton on an HTML form.

    HTML Syntaxe

    To define a button, use standard HTML Syntaxe with the addition of JavaScript event handlers:
    <INPUT
       TYPE="button"
       name="buttonname"
       VALUE="buttonText"
       [onBlur="handlerText"]
       [onClick="handlerText"]
       [onFocus="handlerText"]>

    HTML attributes

    name="buttonname" specifies the name of the Button object. You can access this value using the name property, and you can use this name when indexing the elements array.
    VALUE="buttonText" specifies the label to display on the button face. You can access this value using the value property.

    Syntaxe

    To use a Button object's properties and métodos:
    1. buttonname.propertyname
    2. buttonname.methodname(Parametros)
    3. formname.elements[index].propertyname
    4. formname.elements[index].methodname(Parametros)

    Parametros

    buttonname is the value of the name attribute of a Button object.
    formname is either the value of the name attribute of a Form objeto or an element in the forms array.
    index is an integer representing a Button objeto on a form or the name of a Button objeto as specified by the name attribute.
    propertyname is one of the properties listed below.
    methodname is one of the métodos listed below.

    Propriedade de

    Form object

    Descrição

    A Button objeto on a form looks as follows:


    A Button objeto is a form element and must be defined within a <FORM> tag.
    The Button objeto is a custom button that you can use to perform an action you define. The button executes the script specified by its onClick event handler.

    Properties

    The Button objeto has the following properties:
    Property Descrição
    form property
    Specifies the form containing the Button object
    name
    Reflects the name attribute
    type
    Reflects the TYPE attribute
    value
    Reflects the VALUE attribute

    métodos

    The Button objeto has the following métodos:
  • blur
  • click
  • eval
  • focus
  • toString
  • valueOf

  • Event handlers

    Exemplos

    The following example creates a button named calcButton. The text "Calculate" is displayed on the face of the button. When the button is clicked, the function calcFunction is called.
    <INPUT TYPE="button" VALUE="Calculate" name="calcButton"
       onClick="calcFunction(this.form)">
    Form object, Reset object, Submit object

    caller

    Property. Returns the name of the function that invoked the currently executing function.

    Syntaxe

    functionname.caller

    Parametros

    functionname is the name of a function you have created or the name of a variable or a Propriedade de an existing objeto that has been assigned a Function objeto using new.

    Propriedade de

    Function object, any user-defined function (see See "Defining and calling functions")

    Depreciada?

    No

    Descrição

    The caller property is available only within the body of a function. If used outside a function declaration, the caller property is null.
    If the currently executing function was invoked by the top level of a JavaScript program, the value of caller is null.
    The this keyword does not refer to the currently executing function, so you must refer to functions and Function objects by name, even within the function body.
    The caller property is a reference to the calling function, so

    Exemplos

    The following code checks the value of a function's caller property.
    function myFunc() {
       if (myFunc.caller == null) {
          alert("The function was called from the top!")
       } else alert("This function's caller was " + myFunc.caller)
    }
    arguments array

    ceil

    Method. Returns the least integer greater than or equal to a number.

    Syntaxe

    Math.ceil(number)

    Parametros

    number is any numeric expression or a Propriedade de an existing object.

    Method de

    Math

    Exemplos

    The following function returns the ceil value of the variable x:
    function getCeil(x) {
       return Math.ceil(x)
    }
    If you pass getCeil the value 45.95, it returns 46; if you pass it the value -45.95, it returns -45.
    floor method

    charAt

    Method. Returns the character at the specified index.

    Syntaxe

    stringname.charAt(index)

    Parametros

    stringname is any string or a Propriedade de an existing object.
    index is any integer from zero to stringname.length - 1, or a Propriedade de an existing object.

    Método de

    String

    Descrição

    Characters in a string are indexed from left to right. The index of the first character is zero, and the index of the last character is stringname.length - 1. If the index you supply is out of range, JavaScript returns an empty string.

    Exemplos

    The following example displays characters at different locations in the string "Brave new world":
    var anyString="Brave new world"

    document.write("The character at index 0 is " + anyString.charAt(0))
    document.write("The character at index 1 is " + anyString.charAt(1))
    document.write("The character at index 2 is " + anyString.charAt(2))
    document.write("The character at index 3 is " + anyString.charAt(3))
    document.write("The character at index 4 is " + anyString.charAt(4))
    indexOf, lastIndexOf, split métodos

    Checkbox

    Object. A checkbox on an HTML form. A checkbox is a toggle switch that lets the user set a value on or off.

    HTML Syntaxe

    To define a checkbox, use standard HTML Syntaxe with the addition of JavaScript event handlers:
    <INPUT
       TYPE="checkbox"
       name="checkboxname"
       VALUE="checkboxValue"
       [CHECKED]
       [onBlur="handlerText"]
       [onClick="handlerText"]
       [onFocus="handlerText"]>
       textToDisplay

    HTML attributes

    name="checkboxname" specifies the name of the Checkbox object. You can access this value using the name property, and you can use this name when indexing the elements array.
    VALUE="checkboxValue" specifies a value that is returned to the server when the checkbox is selected and the form is submitted. This defaults to "on." You can access this value using the value property.
    CHECKED specifies that the checkbox is displayed as checked. You can access this value using the defaultChecked property.
    textToDisplay specifies the label to display beside the checkbox.

    Syntaxe

    To use a Checkbox object's properties and métodos:
    1. checkboxname.propertyname
    2. checkboxname.methodname(Parametros)
    3. formname.elements[index].propertyname
    4. formname.elements[index].methodname(Parametros)

    Parametros

    checkboxname is the value of the name attribute of a Checkbox object.
    formname is either the value of the name attribute of a Form objeto or an element in the forms array.
    index is an integer representing a Checkbox objeto on a form or the name of a Checkbox objeto as specified by the name attribute.
    propertyname is one of the properties listed below.
    methodname is one of the métodos listed below.

    Propriedade de

    Form object

    Descrição

    A Checkbox objeto on a form looks as follows:

    Overnight delivery

    A Checkbox objeto is a form element and must be defined within a <FORM> tag.
    Use the checked property to specify whether the checkbox is currently checked. Use the defaultChecked property to specify whether the checkbox is checked when the form is loaded or reset.

    Properties

    The Checkbox objeto has the following properties:
    Property Descrição
    checked
    Boolean property that reflects the current state of the checkbox: true for checked or false for unchecked. Lets you programmatically check a checkbox
    defaultChecked
    Boolean property that reflects the CHECKED attribute: true if checkbox is checked by default, false otherwise.
    form property
    Specifies the form containing the Checkbox object
    name
    Reflects the name attribute
    type
    Reflects the TYPE attribute
    value
    Reflects the VALUE attribute

    métodos

    The Checkbox objeto has the following métodos:
  • blur
  • click
  • eval
  • focus
  • toString
  • valueOf

  • Event handlers

    Exemplos

    Example 1. The following example displays a group of four checkboxes that all appear checked by default:
    <B>Specify your music preferences (check all that apply):</B>
    <BR><INPUT TYPE="checkbox" name="musicpref_rnb" CHECKED> R&B
    <BR><INPUT TYPE="checkbox" name="musicpref_jazz" CHECKED> Jazz
    <BR><INPUT TYPE="checkbox" name="musicpref_blues" CHECKED> Blues
    <BR><INPUT TYPE="checkbox" name="musicpref_newage" CHECKED> New Age
    Example 2. The following example contains a form with three text boxes and one checkbox. The user can use the checkbox to choose whether the text fields are converted to uppercase. Each text field has an onChange event handler that converts the field value to uppercase if the checkbox is checked. The checkbox has an onClick event handler that converts all fields to uppercase when the user checks the checkbox.
    <HTML>
    <HEAD>
    <TITLE>Checkbox objeto example</TITLE>
    </HEAD>
    <SCRIPT>
    function convertField(field) {
       if (document.form1.convertUpper.checked) {
          field.value = field.value.toUpperCase()}
    }
    function convertAllFields() {
       document.form1.lastname.value = document.form1.lastname.value.toUpperCase()
       document.form1.firstname.value = document.form1.firstname.value.toUpperCase()
       document.form1.cityname.value = document.form1.cityname.value.toUpperCase()
    }
    </SCRIPT>
    <BODY>
    <FORM name="form1">
    <B>Last name:</B>
    <INPUT TYPE="text" name="lastname" SIZE=20 onChange="convertField(this)">
    <BR><B>First name:</B>
    <INPUT TYPE="text" name="firstname" SIZE=20 onChange="convertField(this)">
    <BR><B>City:</B>
    <INPUT TYPE="text" name="cityname" SIZE=20 onChange="convertField(this)">
    <P><INPUT TYPE="checkBox" name="convertUpper"
       onClick="if (this.checked) {convertAllFields()}"
       > Convert fields to upper case
    </FORM>
    </BODY>
    </HTML>
    Form object, Radio objects

    checked

    Property. A Boolean value specifying the selection state of a Checkbox objeto or radio button.

    Syntaxe

    1. checkboxname.checked
    2. radioname[index].checked

    Parametros

    checkboxname is either the value of the name attribute of a Checkbox objeto or an element in the elements array.
    radioname is the value of the name attribute of a Radio object.
    index is an integer representing a radio button in a Radio object.

    Propriedade de

    Checkbox, Radio

    Depreciada?

    Sim

    Descrição

    If a checkbox or radio button is selected, the value of its checked property is true; otherwise, it is false.
    You can set the checked property at any time. The display of the checkbox or radio button updates immediately when you set the checked property.

    Exemplos

    The following example examines an array of radio buttons called musicType on the musicForm form to determine which button is selected. The VALUE attribute of the selected button is assigned to the checkedButton variable.
    function stateChecker() {
       var checkedButton = ""
       for (var i in document.musicForm.musicType) {
          if (document.musicForm.musicType[i].checked=="1") {
             checkedButton=document.musicForm.musicType[i].value
          }
       }
    }
    defaultChecked property

    clearTimeout

    Method. Cancels a timeout that was set with the setTimeout method.

    Syntaxe

    clearTimeout(timeoutID)

    Parametros

    timeoutID is a timeout setting that was returned by a previous call to the setTimeout method.

    Método de

    Frame object, window object

    Descrição

    See the Descrição for the setTimeout method.

    Exemplos

    See the Exemplos for the setTimeout method.
    setTimeout method

    click

    Method. Simulates a mouse-click on the calling form element.

    Syntaxe

    1. buttonname.click()
    2. radioname[index].click()
    3. checkboxname.click()

    Parametros

    buttonname is either the value of the name attribute of a Button, Reset, or Submit objeto or an element in the elements array.
    radioname is the value of the name attribute of a Radio objeto or an element in the elements array.
    index is an integer representing a radio button in a Radio object.
    checkboxname is either the value of the name attribute of a Checkbox objeto or an element in the elements array.

    Método de

    Button, Checkbox, Radio, Reset object, Submit object

    Descrição

    The effect of the click method varies according to the calling element:

    Exemplos

    The following example toggles the selection status of the first radio button in the musicType Radio objeto on the musicForm form:
    document.musicForm.musicType[0].click()
    The following example toggles the selection status of the newAge checkbox on the musicForm form:
    document.musicForm.newAge.click()

    close (document object)

    Method. Closes an output stream and forces data sent to layout to display.

    Syntaxe

    document.close()

    Método de

    document

    Descrição

    The close method closes a stream opened with the document.open() method. If the stream was opened to layout, the close method forces the content of the stream to display. Font style tags, such as <BIG> and <CENTER>, automatically flush a layout stream.
    The close method also stops the "meteor shower" in the Netscape icon and displays "Document: Done" in the status bar.

    Exemplos

    The following function calls document.close() to close a stream that was opened with document.open(). The document.close() method forces the content of the stream to display in the window.
    function windowWriter1() {
       var myString = "Hello, world!"
       msgWindow.document.open()
       msgWindow.document.write(myString + "<P>")
       msgWindow.document.close()
    }
    open (document object), write, writeln métodos

    close (window object)

    Method. Closes the specified window.

    Syntaxe

    windowReference.close()

    Parametros

    windowReference is a valid way of referring to a window, as described in the window object.

    Método de

    window object

    Descrição

    The close method closes the specified window. If you call close without specifying a windowReference, JavaScript closes the current window.
    The close method closes only windows opened by JavaScript using the open method. If you attempt to close any other window, a confirm is generated, which lets the user choose whether the window closes. This is a security feature to prevent "mail bombs" containing self.close(). However, if the window has only one document (the current one) in its session history, the close is allowed without any confirm. This is a special case for one-off windows that need to open other windows and then dispose of themselves.
    In event handlers, you must specify window.close() instead of simply using close(). Due to the scoping of static objects in JavaScript, a call to close() without specifying an objeto name is equivalent to document.close().

    Exemplos

    Any of the following Exemplos closes the current window:
    window.close()
    self.close()
    close()
    The following example closes the messageWin window:
    messageWin.close()
    This example assumes that the window was opened in a manner similar to the following:
    messageWin=window.open("")
    closed property; open (window object) method

    closed

    Property. Specifies whether a window is closed.

    Syntaxe

    [windowReference.]closed

    Parametros

    windowReference is a valid way of referring to a window, as described in the window object.

    Propriedade de

    window object

    Depreciada?

    No

    Descrição

    The closed property is a boolean value that specifies whether a window has been closed. When a window closes, the window objeto that represents it continues to exist, and its closed property is set to true.
    Use closed to determine whether a window that you opened, and to which you still hold a reference (from window.open()'s return value), is still open. Once a window is closed, you should not attempt to manipulate it.
    closed is a read-only property.

    Exemplos

    Example 1. The following code opens a window, win1, then later checks to see if that window has been closed. A function is called depending on whether win1 is closed.
    win1=window.open('opener1.html','window1','width=300,height=300')
    ...
    if (win1.closed)
       function1()
       else
       function2()
    Example 2. The following code determines if the current window's opener window is still closed, and calls the appropriate function.
    if (window.opener.closed)
       function1()
       else
       function2()
    close (window object), open (window object) métodos

    complete

    Property. A boolean value that indicates whether Navigator has completed its attempt to load an image.

    Syntaxe

    imagename.complete

    Parametros

    imagename is either the name of an Image objeto or an element in the images array.

    Propriedade de

    Image

    Depreciada?

    No

    Descrição

    complete is a read-only property.

    Exemplos

    The following example displays an image and three radio buttons. The user can click the radio buttons to choose which image is displayed. Clicking another button lets the user see the current value of the complete property.
    <B>Choose an image:</B>
    <BR><INPUT TYPE="radio" name="imageChoice" VALUE="image1" CHECKED
       onClick="document.images[0].src='f15e.gif'">F-15 Eagle
    <BR><INPUT TYPE="radio" name="imageChoice" VALUE="image2"
       onClick="document.images[0].src='f15e2.gif'">F-15 Eagle 2
    <BR><INPUT TYPE="radio" name="imageChoice" VALUE="image3"
       onClick="document.images[0].src='ah64.gif'">AH-64 Apache

    <BR><INPUT TYPE="button" VALUE="Is the image completely loaded?"
       onClick="alert('The value of the complete property is '
          + document.images[0].complete)">
    <BR>
    <IMG name="aircraft" SRC="f15e.gif" ALIGN="left" VSPACE="10"><BR>
    lowsrc, src properties

    confirm

    Method. Displays a Confirm dialog box with the specified message and OK and Cancel buttons.

    Syntaxe

    confirm("message")

    Parametros

    message is any string or a Propriedade de an existing object.

    Método de

    window object

    Descrição

    A confirm dialog box looks as follows:


    Use the confirm method to ask the user to make a decision that requires either an OK or a Cancel. The message argument specifies a message that prompts the user for the decision. The confirm method returns true if the user chooses OK and false if the user chooses Cancel.
    Although confirm is a Método de the window object, you do not need to specify a windowReference when you call it. For example, windowReference.confirm() is unnecessary.
    You cannot specify a title for a confirm dialog box, but you can use the open method to create your own "confirm" dialog. See open (window object).

    Exemplos

    This example uses the confirm method in the confirmCleanUp function to confirm that the user of an application really wants to quit. If the user chooses OK, the custom cleanUp function closes the application.
    function confirmCleanUp() {
       if (confirm("Are you sure you want to quit this application?")) {
          cleanUp()
       }
    }
    You can call the confirmCleanUp function in the onClick event handler of a form's pushbutton, as shown in the following example:
    <INPUT TYPE="button" VALUE="Quit" onClick="confirmCleanUp()">
    alert, prompt métodos

    constructor

    Property. Specifies the function that creates an objeto prototype.

    Syntaxe

    objectType.constructor

    Parametros

    objectType is the name of a constructor or function specifying an objeto type.

    Propriedade de

    constructor is a Propriedade de any prototype objeto (see "Creating new objects").

    Depreciada?

    No

    Descrição

    Each prototype objeto has a constructor property that refers to the function that created the object.

    Exemplos

    The following example creates a prototype object, Tree and an objeto of that type, theTree. The example then displays the constructor property for the objeto theTree.
    function Tree(name) {
       this.name=name
    }
    theTree = new Tree("Redwood")
    document.writeln("<B>theTree.constructor is</B> " +
       theTree.constructor + "<P>")
    This example displays the following output:
    theTree.constructor is function Tree(name) { this.name = name; }
    prototype property; "Creating new objects"

    cookie

    Property. String value of a cookie, which is a small piece of information stored by the Navigator in the cookies.txt file.

    Syntaxe

    document.cookie

    Propriedade de

    document

    Depreciada?

    Sim

    Descrição

    Use string métodos such as substring, charAt, indexOf, and lastIndexOf to determine the value stored in the cookie. See the Appendix D, "Netscape cookies" for a complete specification of the cookie Syntaxe.
    You can set the cookie property at any time.
    The "expires=" component in the cookie file sets an expiration date for the cookie, so it persists beyond the current browser session. This date string is formatted as follows:
    Wdy, DD-Mon-YY HH:MM:SS GMT
    This format represents the following values:

    Exemplos

    The following function uses the cookie property to record a reminder for users of an application. The cookie expiration date is set to one day after the date of the reminder.
    function RecordReminder(time, expression) {
       // Record a cookie of the form "@<T>=<E>" to map
       // from <T> in milliseconds since the epoch,
       // returned by Date.getTime(), onto an encoded expression,
       // <E> (encoded to contain no white space, semicolon,
       // or comma characters)
       document.cookie = "@" + time + "=" + expression + ";"
       // set the cookie expiration time to one day
       // beyond the reminder time
       document.cookie += "expires=" + cookieDate(time + 24*60*60*1000)
       // cookieDate is a function that formats the date
       //according to the cookie spec
    }
    Hidden object

    cos

    Method. Returns the cosine of a number.

    Syntaxe

    Math.cos(number)

    Parametros

    number is a numeric expression representing the size of an angle in radians, or a Propriedade de an existing object.

    Método de

    Math

    Descrição

    The cos method returns a numeric value between -1 and one, which represents the cosine of the angle.

    Exemplos

    The following function returns the cosine of the variable x:
    function getCos(x) {
       return Math.cos(x)
    }
    If x equals Math.PI/2, getCos returns 6.123031769111886e-017; if x equals Math.PI, getCos returns -1.
    acos, asin, atan, atan2, sin, tan métodos

    current

    Property. A string specifying the complete URL of the current history entry.

    Syntaxe

    history.current

    Propriedade de

    history object

    Depreciada?

    Sim

    Descrição

    The current property has a value only if data tainting is enabled; if data tainting is not enabled, current has no value.
    current is a read-only property.

    Exemplos

    The following example determines whether history.current contains the string "netscape.com". If it does, the function myFunction is called.
    if (history.current.indexOf("netscape.com") != -1) {
       myFunction(history.current)
    }
    next, previous properties; "Using data tainting for security"
    [Next reference file]