diff options
Diffstat (limited to 'files/pt-br/web/api/window/prompt/index.html')
-rw-r--r-- | files/pt-br/web/api/window/prompt/index.html | 66 |
1 files changed, 66 insertions, 0 deletions
diff --git a/files/pt-br/web/api/window/prompt/index.html b/files/pt-br/web/api/window/prompt/index.html new file mode 100644 index 0000000000..e831fbcc4d --- /dev/null +++ b/files/pt-br/web/api/window/prompt/index.html @@ -0,0 +1,66 @@ +--- +title: Window.prompt() +slug: Web/API/Window/prompt +translation_of: Web/API/Window/prompt +--- +<div>{{ApiRef("Window")}}</div> + +<div>O <span style="font-family: Consolas,Monaco,'Andale Mono',monospace;">Window.prompt()</span> exibe uma caixa de diálogo com uma mensagem opcional solicitando ao usuário a entrada de algum texto.</div> + +<p> </p> + +<h2 id="Syntax" name="Syntax">Sintaxe</h2> + +<pre class="syntaxbox"><em>resultado</em> = window.prompt(<em>texto</em>, <em>valor</em>); +</pre> + +<ul> + <li><code>resultado</code> é uma cadeia de caracteres contendo o texto digitado pelo usuário, ou um valor nulo.</li> + <li><code>texto</code> é uma cadeia de caracteres para exibir ao usuário. Este parâmetro é opcional e pode ser omitido se não há nada para mostrar na janela de prompt.</li> + <li><code>valor</code> é uma cadeia de caracteres contendo o valor padrão exibido na caixa de entrada de texto. É um parâmetro opcional. Note que no Internet Explorer 7 e 8, se você não fornecer este parâmetro, a cadeia de caracteres "undefined" é o valor padrão.</li> +</ul> + +<h2 id="Example" name="Example">Exemplo</h2> + +<pre class="brush:js">var signo = prompt("Qual é o seu signo?"); + +if (signo.toLowerCase() == "escorpião") { + alert("Legal! Eu sou de Escorpião também!"); +} + +// há muitas formas de se usar o recurso prompt +var sign = window.prompt(); // abrir uma janela de promtpt em branco +var sign = prompt(); // abrir uma janela de promtpt em branco +var sign = window.prompt('Você está se sentindo com sorte'); // abrir uma janela com o texto "Você está se sentindo com sorte" +var sign = window.prompt('Você está se sentindo com sorte', 'certamente'); // abrir uma janela com o texto "Você está se sentindo com sorte" e com o valor padrão "certamente"</pre> + +<p>Quando o usuário pressiona o botão OK, o texto digitado no campo de texto é retornado. Se o usuário pressionar OK sem ter digitado qualquer texto, uma cadeia de caracteres vazia é retornada. Se o usuário pressionar o botão Cancelar, esta função retornará <code>null</code>.</p> + +<p>{{todo("external image!")}} O prompt acima aparece da seguinte forma (no Chrome do Windows 7):</p> + +<p><img src="https://lh4.googleusercontent.com/-uDx7r8y4tV8/UKv_PjG163I/AAAAAAAAHd0/Arwk0l4cpq0/s362/Prompt_Chrome_Windows7.png" style="width: 362px;"></p> + +<h2 id="Notes" name="Notes">Notas</h2> + +<p>Uma caixa de diálogo prompt contém uma caixa de texto de linha única, um botão Cancelar, e um botão OK, e retorna o (possivelmente vazio) texto que o usuário digitou naquela caixa de texto.</p> + +<p><span class="comment">The following text is shared between this article, DOM:window.confirm and DOM:window.alert</span>As caixas de diálogo são janelas modais; eles impedem o usuário de acessar o resto da interface do programa até que a caixa de diálogo seja fechada. Por esta razão, você não deve abusar de qualquer função que crie uma caixa de diálogo (ou janela modal).</p> + +<p>Por favor, note que o resultado é uma cadeia de caracteres. Isso significa que você deve, algumas vezes, converter o valor dado pelo usuário. Por exemplo, se a resposta deve ser um número, você deve converter o valor para <code>Number:</code> <span style='background-color: #f6f6f2; font-family: "Courier New","Andale Mono",monospace; font-size: 12px; line-height: normal;'>var aNumber = Number(window.prompt("Digite um número", "")); </span></p> + +<p>Os códigos do <a href="/en-US/docs/Chrome" title="Chrome">Mozilla Chrome</a> (e.g. Firefox extensions) ao invés disso, devem usar os métodos da interface {{interface("nsIPromptService")}}.</p> + +<p>No Safari, se o usuário clicar em Cancelar, a função retornará uma cadeia de caracteres vazia. Portanto, ele não diferenciará o cancelamento do usuário de uma cadeia de caracteres vazia na caixa de texto.</p> + +<p>Esta função não tem efeito na versão Modern UI/Metro do Internet Explorer para Windows 8. Ele não exibe o prompt para o usuário, e sempre retornará <code>undefined</code>. Não está claro se é um erro ou um comportamento intencional. Versões desktop do IE implementam esta função.</p> + +<p><strong style="font-size: 30px; font-weight: 700; letter-spacing: -1px; line-height: 30px;">Especificação</strong></p> + +<p>Especificado em HTML5.</p> + +<h2 id="See_also" name="See_also">Veja também</h2> + +<ul> + <li>{{domxref("window.alert", "alert")}}</li> + <li>{{domxref("window.confirm", "confirm")}}</li> +</ul> |