diff options
Diffstat (limited to 'files/ca/web/html/element/textarea/index.html')
| -rw-r--r-- | files/ca/web/html/element/textarea/index.html | 182 |
1 files changed, 182 insertions, 0 deletions
diff --git a/files/ca/web/html/element/textarea/index.html b/files/ca/web/html/element/textarea/index.html new file mode 100644 index 0000000000..c208fe6102 --- /dev/null +++ b/files/ca/web/html/element/textarea/index.html @@ -0,0 +1,182 @@ +--- +title: <textarea> +slug: Web/HTML/Element/textarea +tags: + - Element + - Forms + - HTML + - HTML forms + - Reference + - Web + - textarea +translation_of: Web/HTML/Element/textarea +--- +<h2 id="Sumari">Sumari</h2> + +<p>L'<strong>element HTML <code><textarea></code></strong> representa un control d'edició de text multi-línia sense format.</p> + +<h2 id="Context_d'ùs">Context d'ùs</h2> + +<table class="properties"> + <tbody> + <tr> + <th scope="row"><a href="/en-US/docs/HTML/Content_categories" title="HTML/Content_categories">Categories de contingut</a></th> + <td><a href="/en-US/docs/HTML/Content_categories#Flow_content" title="HTML/Content categories#Flow content">Contingut dinàmic</a>, <a href="/en-US/docs/HTML/Content_categories#Phrasing_content" title="HTML/Content categories#Phrasing content">contingut textual</a>, <a href="/en-US/docs/HTML/Content_categories#Interactive_content" title="HTML/Content categories#Interactive content">contingut interactiu</a>, <a href="/en-US/docs/HTML/Content_categories#Form_listed" title="HTML/Content categories#Form listed">enumerat</a>, <a href="/en-US/docs/HTML/Content_categories#Form_labelable" title="HTML/Content categories#Form labelable">etiquetable</a>, <a href="/en/HTML/Content_categories#form_resettable" title="en/HTML/Content categories#form resettable">reiniciable</a>, i elements <a href="/en-US/docs/HTML/Content_categories#Form_submittable" title="HTML/Content categories#Form submittable">enviables associats a formularis</a>.</td> + </tr> + <tr> + <th scope="row">Contingut permès</th> + <td>Dades <span class="short_text" id="result_box" lang="ca"><span>caràcter</span></span></td> + </tr> + <tr> + <th scope="row">Omissió de l'etiqueta</th> + <td>{{no_tag_omission}}</td> + </tr> + <tr> + <th scope="row">Elements pares permesos</th> + <td>Qualsevol element que accepti <a href="/en-US/docs/HTML/Content_categories#Phrasing_content" title="HTML/Content categories#Phrasing content">contingut textual</a>.</td> + </tr> + <tr> + <th scope="row">Interfície DOM</th> + <td>{{domxref("HTMLTextAreaElement")}}</td> + </tr> + </tbody> +</table> + +<h2 id="Atributs">Atributs</h2> + +<p>Aquest element inclou els<span style="line-height: 21px;"> </span><a href="https://developer.mozilla.org/en-US/docs/HTML/Global_attributes" style="line-height: 21px;" title="HTML/Global attributes">atributs globals</a><span style="line-height: 21px;">.</span></p> + +<dl> + <dt>{{htmlattrdef("autocapitalize")}} {{non-standard_inline}}</dt> + <dd>Aquest és un atribut no estàndard amb el suport de WebKit en iOS (per tant, gairebé tots els navegadors que s'executen en iOS, incloent Safari, Firefox i Chrome) el qual controla si i com el valor de text ha de ser automàticament en majúscula quan és entrat/editat per l'usuari. Els valors no desaprovats estan disponibles en IOS 5 i posteriors. Els valors possibles són: + <ul> + <li><code>none</code>: <span id="result_box" lang="ca"><span>Completament</span> <span>desactiva</span>da <span>la majúscula</span></span><span lang="ca"> <span>automàtica.</span></span></li> + <li><code>sentences</code>: <span id="result_box" lang="ca"><span>Automàticament</span> <span>en majúscula</span> <span>la primera lletra</span> <span>d'una oració</span></span> .</li> + <li><code>words</code>: <span id="result_box" lang="ca"><span>Automàticament</span> <span>en majúscula</span> <span>la primera lletra</span> <span>de les</span> <span>paraules</span></span>.</li> + <li><code>characters</code>: <span class="short_text" id="result_box" lang="ca"><span>Automàticament</span> <span>en</span> <span>majúscula</span> <span>tots</span> <span>els</span> <span>caràcters</span></span> .</li> + <li><code>on</code>: {{deprecated_inline()}} Desaprovat des de iOS 5.</li> + <li><code>off</code>: {{deprecated_inline()}} Desaprovat des de iOS 5.</li> + </ul> + </dd> + <dt>{{htmlattrdef("autocomplete")}} {{HTMLVersionInline("5")}}</dt> + <dd><span id="result_box" lang="ca"><span>Aquest</span> <span>atribut</span> <span>indica</span> <span>si el valor del</span> <span>control</span> <span>es</span> <span>pot completar</span> <span>automàticament</span> <span>pel navegador.</span> <span>Els</span> <span>valors</span> <span>possibles</span> <span>són</span><span>:</span></span> + <ul> + <li><code>off</code>: L'usuari ha d'introduir explícitament un valor en aquest camp per a cada ús, o el document proporciona el seu propi mètode d'autocompletat; el navegador no completa l'entrada automàticament.</li> + <li><code>on</code>: <span id="result_box" lang="ca"><span>El navegador</span> <span>pot completar</span> <span>automàticament el</span> <span>valor basat</span> <span>en els valors</span> <span>que l'usuari ha</span> <span>entrat</span> <span>en usos</span> <span>anteriors.</span></span></li> + </ul> + + <p>Si l'atribut <strong>autocomplete</strong> no s'especifica en un element <code><textarea></code>, el navegador utilitza el valor de l'atribut <strong>autocomplete</strong> del propietari del formulari de l'element <code><textarea></code>. El propietari del formulari és l'element {{HTMLElement("form")}} en el qual l'element <code><textarea></code> és un descendent o bé l'element de formulari que el seu <strong>id</strong> és especificat per l'atribut <strong>form</strong> de l'element d'entrada. Per obtenir més informació, consulteu {{htmlattrxref("autocomplete", "form")}} en {{HTMLElement("form")}}.</p> + </dd> + <dt>{{ htmlattrdef("autofocus") }} {{ HTMLVersionInline("5") }}</dt> + <dd>Aquest atribut booleà permet especificar que un control de formulari ha de tenir el focus d'entrada quan es carrega la pàgina, llevat que l'usuari el redefineixi, per exemple escrivint en un control diferent. Només un element de formularu associat a un document pot tenir aquest atribut especificat.</dd> + <dt>{{ htmlattrdef("cols") }}</dt> + <dd>L'ample visible del control de text, en caràcters d'amplària mitjana. Si s'especifica, ha de ser un nombre enter positiu. Si no s'especifica, el valor per defecte és <span style="font-family: courier new;">20</span> (HTML5).</dd> + <dt>{{ htmlattrdef("disabled") }}</dt> + <dd>Aquest atribut booleà indica que l'usuari no pot interactuar amb el control. (Si no s'especifica aquest atribut, el control hereta la seva configuració des de l'element que conté, per exemple {{HTMLElement ("fieldset")}};. Si no hi ha cap element que contimgui l'atribut <code>disabled</code>, el control està activat)</dd> + <dt>{{ htmlattrdef("form") }} {{ HTMLVersionInline("5") }}</dt> + <dd>L'element formulari en el qual està associat l'element <code><textarea></code> (el seu "propietari formulari"). El valor de l'atribut ha de ser l'ID d'un element de formulari en el mateix document. Si no s'especifica aquest atribut, l'element <code><textarea></code> ha de ser un descendent d'un element de formulari. Aquest atribut li permet col.locar elements <code><textarea></code> en qualsevol lloc dins d'un document, no només com descendents dels seus elements de formulari.</dd> + <dt>{{ htmlattrdef("maxlength") }} {{ HTMLVersionInline("5") }}</dt> + <dd><span id="result_box" lang="ca"><span>El nombre</span> <span>màxim</span> <span>de caràcters</span> <span>(</span><span>punts</span> <span>de codi</span> <span>Unicode</span><span>)</span> <span>que l'usuari pot</span> <span>introduir.</span> <span>Si no s'especifica</span> <span>aquest valor,</span> <span>l'usuari pot</span> <span>introduir un</span> <span>nombre il·limitat</span> <span>de caràcters</span></span></dd> + <dt>{{ htmlattrdef("minlength") }} {{ HTMLVersionInline("5") }}</dt> + <dd>El nombre mínim de caràcters (punts de codi Unicode) requerits que l'usuari ha d'introduir.</dd> + <dt>{{ htmlattrdef("name") }}</dt> + <dd>El nom del control.</dd> + <dt>{{ htmlattrdef("placeholder") }} {{ HTMLVersionInline("5") }}</dt> + <dd>Un indici a l'usuari del que pot ser introduït en el control. Els retorns de carro o salts de línia dins del text de marcador de posició han de ser tractats com salts de línia quan es representa l'indici.</dd> + <dt>{{ htmlattrdef("readonly") }}</dt> + <dd>Aquest atribut booleà indica que l'usuari no pot modificar el valor del control. A diferència de l'atribut <code>disabled</code>, l'atribut <code>readonly</code> no impedeix que l'usuari faci clic o seleccioni en el control. El valor d'un control de només lectura segueix sent enviat en el formulari.</dd> + <dt>{{ htmlattrdef("required") }} {{ HTMLVersionInline("5") }}</dt> + <dd><span id="result_box" lang="ca"><span>Aquest</span> <span>atribut</span> <span>especifica</span> <span>que l'usuari</span> <span>ha d'omplir</span> <span>un valor</span> <span>abans</span> <span>d'enviar un</span> <span>formulari.</span></span></dd> + <dt>{{ htmlattrdef("rows") }}</dt> + <dd><span id="result_box" lang="ca"><span>El nombre</span> <span>de línies</span> <span>de text</span> <span>visibles</span> <span>per al control.</span></span></dd> + <dt>{{ htmlattrdef("selectionDirection") }} {{ HTMLVersionInline("5") }}</dt> + <dd>La direcció en què es va produir la selecció. És "cap endavant (forward)" si la selecció es va fer d'esquerra a dreta en una configuració regional LTR o de dreta a esquerra en una configuració regional RTL, o "cap enrere (backward)" si la selecció es va fer en la direcció oposada. Això pot ser "cap (none)" si la direcció de la selecció és desconegut.</dd> + <dt>{{ htmlattrdef("selectionEnd") }}</dt> + <dd><span id="result_box" lang="ca"><span>L'índex</span> <span>de l'últim</span> <span>caràcter</span> <span>de la selecció</span> <span>actual.</span> <span>Si no hi ha</span> <span>selecció,</span> <span>el valor és</span> <span>l'índex</span> <span>del caràcter que</span> <span>segueix a</span> <span>la posició del cursor</span> <span>d'entrada de</span> <span>text.</span></span></dd> + <dt>{{ htmlattrdef("selectionStart") }}</dt> + <dd><span id="result_box" lang="ca"><span>L'índex</span> <span>per al primer</span> <span>caràcter</span> <span>de la selecció</span> <span>actual.</span> <span>Si no hi ha</span> <span>selecció</span><span>, aquest valor</span> <span>és l'índex</span> <span>del caràcter que</span> <span>segueix a</span> <span>la posició del cursor</span> <span>d'entrada de</span> <span>text.</span></span></dd> + <dt>{{ htmlattrdef("spellcheck") }} {{ HTMLVersionInline(5) }}</dt> + <dd>Establir el valor d'aquest atribut en <code>true</code> indica que l'element ha de tenir la seva ortografia i gramàtica revisada. El valor per omissió indica que l'element està actuant d'acord amb un comportament predeterminat, possiblement basat en el valor de la revisió ortogràfica de l'element pare. El valor <code>false</code> indica que l'element no ha de ser revisat.</dd> + <dt>{{ htmlattrdef("wrap") }} {{ HTMLVersionInline("5") }}</dt> + <dd>Indica com el control ajusta el text. Els valors possibles són: + <ul> + <li><span style="font-family: courier new;">hard</span>: El navegador insereix automàticament salts de línia (CR + LF) de manera que cada línia tingui nomes l'ample del control; l'atribut <code>cols</code> ha de ser especificat.</li> + <li><span style="font-family: courier new;">soft</span>: El navegador s'assegura que tots els salts de línia en el valor consisteixen en un parell CR + LF, però no insereix salts de línia addicionals.</li> + </ul> + + <p>Si no s'especifica aquest atribut, <span style="font-family: courier new;">soft</span> és el valor predeterminat.</p> + </dd> +</dl> + +<h2 id="Interfície_DOM">Interfície DOM</h2> + +<p>Aquest element implementa la interfície <code><a href="/en/DOM/HTMLTextAreaElement" title="en/DOM/textarea">HTMLTextAreaElement</a></code>.</p> + +<p>{{ h1_gecko_minversion("Resizable textareas", "2.0") }}</p> + +<p>{{Gecko ("2.0")}} introdueix suport per les textareas redimensionables. Això és controlat per la propietat CSS {{ cssxref("resize") }}. Canviar la mida de les àrees de text està activat per defecte, però es pot desactivar de forma explícita mitjançant la inclusió de la següent CSS:</p> + +<pre>textarea { + resize: none; +} +</pre> + +<h2 id="Interacció_amb_CSS">Interacció amb CSS</h2> + +<p>Pel que fa a CSS, un <code><textarea></code> és un <a href="https://developer.mozilla.org/en-US/docs/CSS/Replaced_element" title="/en-US/docs/CSS/Replaced_element">element reemplaçat</a>. L'especificació HTML no defineix on està la línia de base d'un <code><textarea></code>. Així que diferents navegadors ajustan a diferents posicions. Per Gecko, la línia de base de un <code><textarea></code> es troba en la línia de base de la primera línia de la primera línia del textarea, en altre navegador pot ajustar a la part inferior del quadre del <code><textarea></code>. No utilitzeu {{cssxref ("vertical-align")}}: <code>baseline</code>, ja que el comportament serà impredictible.</p> + +<p>Un <em>textarea</em> té dimensions intrínseques, com una imatge ampliada.</p> + +<h2 id="Example" name="Example">Example</h2> + +<h3 id="Contingut_HTML">Contingut HTML</h3> + +<pre class="brush: html"><textarea name="textarea" rows="10" cols="50">Write something here</textarea></pre> + +<p>{{ EmbedLiveSample('Example','600','200') }}</p> + + +<h2 id="Specifications" name="Specifications">Especificacions</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Especificació</th> + <th scope="col">Estat</th> + <th scope="col">Comentari</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', 'the-button-element.html#the-textarea-element', '<textarea>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'forms.html#the-textarea-element', '<textarea>')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML4.01', 'interact/forms.html#h-17.7', '<textarea>')}}</td> + <td>{{Spec2('HTML4.01')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Navegadors_compatibles">Navegadors compatibles</h2> + +<div> + + +<p>{{Compat("html.elements.textarea")}}</p> +</div> + +<p> </p> + +<h2 id="Veure">Veure</h2> + +<p>Altres elements relacionats amb formularis: {{ HTMLElement("form") }}, {{ HTMLElement("button") }}, {{ HTMLElement("datalist") }}, {{ HTMLElement("legend") }}, {{ HTMLElement("label") }}, {{ HTMLElement("select") }}, {{ HTMLElement("optgroup") }}, {{ HTMLElement("option") }}, {{ HTMLElement("input") }}, {{ HTMLElement("keygen") }}, {{ HTMLElement("fieldset") }}, {{ HTMLElement("output") }}, {{ HTMLElement("progress") }} and {{ HTMLElement("meter") }}.</p> + +<p>{{HTMLRef}}</p> |