diff options
author | MDN <actions@users.noreply.github.com> | 2021-07-08 00:34:19 +0000 |
---|---|---|
committer | MDN <actions@users.noreply.github.com> | 2021-07-08 00:34:19 +0000 |
commit | ff9ea0cf9f0ea6217deefa7ad0dba35bf7f6c45e (patch) | |
tree | d11054dc18b78736aa981b3102bfd731f86bcd43 /files/es/orphaned/web/api | |
parent | 874d81c43e8e5d7d498b452a8d82bd6879aa5716 (diff) | |
download | translated-content-ff9ea0cf9f0ea6217deefa7ad0dba35bf7f6c45e.tar.gz translated-content-ff9ea0cf9f0ea6217deefa7ad0dba35bf7f6c45e.tar.bz2 translated-content-ff9ea0cf9f0ea6217deefa7ad0dba35bf7f6c45e.zip |
[CRON] sync translated content
Diffstat (limited to 'files/es/orphaned/web/api')
-rw-r--r-- | files/es/orphaned/web/api/htmlorforeignelement/focus/index.html | 165 |
1 files changed, 165 insertions, 0 deletions
diff --git a/files/es/orphaned/web/api/htmlorforeignelement/focus/index.html b/files/es/orphaned/web/api/htmlorforeignelement/focus/index.html new file mode 100644 index 0000000000..80a6e53783 --- /dev/null +++ b/files/es/orphaned/web/api/htmlorforeignelement/focus/index.html @@ -0,0 +1,165 @@ +--- +title: HTMLElement.focus() +slug: orphaned/Web/API/HTMLOrForeignElement/focus +tags: + - API + - HTML DOM + - HTMLElement + - Referencia + - metodo +translation_of: Web/API/HTMLOrForeignElement/focus +original_slug: Web/API/HTMLOrForeignElement/focus +--- +<div>{{ APIRef("HTML DOM") }}</div> + +<p>El método <code><strong>HTMLElement.focus()</strong></code> fija el foco del cursor en el elemento indicado, si éste puede ser enfocado.</p> + +<h2 id="Sintaxis" name="Sintaxis">Sintaxis</h2> + +<pre class="syntaxbox">element.focus(); +element.focus(focusOption); // Object parameter</pre> + +<h3 id="Parámetros" name="Parámetros">Parámetros</h3> + +<dl> + <dt><code>focusOptions</code> {{optional_inline}} {{experimental_inline}}</dt> + <dd>Es un objeto con la siguiente propiedad:</dd> + <dd> + <dl> + <dt><code>preventScroll</code> {{optional_inline}}</dt> + <dd>Es un valor <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" title="The Boolean object is an object wrapper for a boolean value."><code>Boolean</code></a>: + <ul> + <li>Si es <code>false</code>, el método hará scroll hasta que el elemento esté visible en la ventana del navegador</li> + <li>Si es <code>true</code>, el método NO hará scroll hasta que el elemento esté visible en la ventana del navegador.</li> + </ul> + </dd> + </dl> + </dd> +</dl> + +<h2 id="Ejemplos" name="Ejemplos">Ejemplos</h2> + +<h3 id="Enfocar_un_campo_de_texto" name="Enfocar_un_campo_de_texto">Enfocar un campo de texto</h3> + +<h4 id="JavaScript">JavaScript</h4> + +<pre class="brush: js">focusMethod = function getFocus() { + document.getElementById("myTextField").focus(); +}</pre> + +<h4 id="HTML">HTML</h4> + +<pre class="brush: html"><input type="text" id="myTextField" value="Campo de texto."> +<p></p> +<button type="button" onclick="focusMethod()">¡Púlsame para enfocar el campo de texto!</button> +</pre> + +<h4 id="Resultado">Resultado</h4> + +<p>{{ EmbedLiveSample('Focus_on_a_text_field') }}</p> + +<h3 id="Enfocar_un_botón" name="Enfocar_un_botón">Enfocar un botón</h3> + +<h4 id="JavaScript_2">JavaScript</h4> + +<pre class="brush: js">focusMethod = function getFocus() { + document.getElementById("myButton").focus(); +} +</pre> + +<h4 id="HTML_2">HTML</h4> + +<pre class="brush: html"><button type="button" id="myButton">Púlsame!</button> +<p></p> +<button type="button" onclick="focusMethod()">¡Púlsame para enfocar el botón!</button> +</pre> + +<h4 id="Resultado_2">Resultado</h4> + +<p>{{ EmbedLiveSample('Focus_on_a_button') }}</p> + + + +<h3 id="Enfocar_con_focusOption" name="Enfocar_con_focusOption">Enfocar con focusOption</h3> + +<h4 id="JavaScript_3">JavaScript</h4> + +<pre class="brush: js">focusScrollMethod = function getFocus() { + document.getElementById("myButton").focus({preventScroll:false}); +} +focusNoScrollMethod = function getFocusWithoutScrolling() { + document.getElementById("myButton").focus({preventScroll:true}); +} + +</pre> + +<h4 id="HTML_3">HTML</h4> + +<pre class="brush: html"><button type="button" onclick="focusScrollMethod()">¡Púlsame para enfocar el botón!</button> +<button type="button" onclick="focusNoScrollMethod()">¡Púlsame para enfocar el botón sin hacer scroll!</button> + +<div id="container" style="height: 1000px; width: 1000px;"> +<button type="button" id="myButton" style="margin-top: 500px;">¡Púlsame!</button> +</div> + +</pre> + +<h4 id="Resultado_3">Resultado</h4> + +<p>{{ EmbedLiveSample('Focus_prevent_scroll') }}</p> + +<h2 id="Especificación" name="Especificación">Especificación</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Especificación</th> + <th scope="col">Estado</th> + <th scope="col">Comentarios</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'editing.html#dom-focus', 'focus')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('HTML5.1', 'editing.html#focus()-0', 'focus')}}</td> + <td>{{Spec2('HTML5.1')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'editing.html#dom-focus', 'focus')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('DOM2 HTML', 'html.html#ID-32130014', 'focus')}}</td> + <td>{{Spec2('DOM2 HTML')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('DOM1', 'level-one-html.html#method-focus', 'focus')}}</td> + <td>{{Spec2('DOM1')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Notas">Notas</h2> + +<p>Si se llama a <code>HTMLElement.focus()</code> desde un gestor de eventos "mousedown" (ratón presionado), se debe también llamar al método <code>event.preventDefault()</code> para evitar que el foco abandone <code>HTMLElement</code><strong>.</strong></p> + +<h2 id="Compatibilidad_en_navegadores">Compatibilidad en navegadores</h2> + + + +<p>{{Compat("api.HTMLElement.focus")}}</p> + +<h2 id="Ver_también" name="Ver_también">Ver también</h2> + +<ul> + <li>Método DOM {{domxref("HTMLElement.blur()")}} para quitar el foco sobre un elemento.</li> + <li>{{ domxref("document.activeElement") }} para saber cuál es el elemento enfocado actualmente.</li> +</ul> |