--- title: slug: Web/HTML/Element/textarea tags: - Element - Forms - HTML - HTML forms - Reference - Web - textarea translation_of: Web/HTML/Element/textarea --- Sumari L'element HTML <textarea> representa un control d'edició de text multi-línia sense format. Context d'ùs Categories de contingut Contingut dinàmic, contingut textual, contingut interactiu, enumerat, etiquetable, reiniciable, i elements enviables associats a formularis. Contingut permès Dades caràcter Omissió de l'etiqueta {{no_tag_omission}} Elements pares permesos Qualsevol element que accepti contingut textual. Interfície DOM {{domxref("HTMLTextAreaElement")}} Atributs Aquest element inclou els atributs globals. {{htmlattrdef("autocapitalize")}} {{non-standard_inline}} 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: none: Completament desactivada la majúscula automàtica. sentences: Automàticament en majúscula la primera lletra d'una oració . words: Automàticament en majúscula la primera lletra de les paraules. characters: Automàticament en majúscula tots els caràcters . on: {{deprecated_inline()}} Desaprovat des de iOS 5. off: {{deprecated_inline()}} Desaprovat des de iOS 5. {{htmlattrdef("autocomplete")}} {{HTMLVersionInline("5")}} Aquest atribut indica si el valor del control es pot completar automàticament pel navegador. Els valors possibles són: off: 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. on: El navegador pot completar automàticament el valor basat en els valors que l'usuari ha entrat en usos anteriors. Si l'atribut autocomplete no s'especifica en un element <textarea>, el navegador utilitza el valor de l'atribut autocomplete del propietari del formulari de l'element <textarea>. El propietari del formulari és l'element {{HTMLElement("form")}} en el qual l'element <textarea> és un descendent o bé l'element de formulari que el seu id és especificat per l'atribut form de l'element d'entrada. Per obtenir més informació, consulteu {{htmlattrxref("autocomplete", "form")}} en {{HTMLElement("form")}}. {{ htmlattrdef("autofocus") }} {{ HTMLVersionInline("5") }} 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. {{ htmlattrdef("cols") }} 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 20 (HTML5). {{ htmlattrdef("disabled") }} 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 disabled, el control està activat) {{ htmlattrdef("form") }} {{ HTMLVersionInline("5") }} L'element formulari en el qual està associat l'element <textarea> (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 <textarea> ha de ser un descendent d'un element de formulari. Aquest atribut li permet col.locar elements <textarea> en qualsevol lloc dins d'un document, no només com descendents dels seus elements de formulari. {{ htmlattrdef("maxlength") }} {{ HTMLVersionInline("5") }} El nombre màxim de caràcters (punts de codi Unicode) que l'usuari pot introduir. Si no s'especifica aquest valor, l'usuari pot introduir un nombre il·limitat de caràcters {{ htmlattrdef("minlength") }} {{ HTMLVersionInline("5") }} El nombre mínim de caràcters (punts de codi Unicode) requerits que l'usuari ha d'introduir. {{ htmlattrdef("name") }} El nom del control. {{ htmlattrdef("placeholder") }} {{ HTMLVersionInline("5") }} 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. {{ htmlattrdef("readonly") }} Aquest atribut booleà indica que l'usuari no pot modificar el valor del control. A diferència de l'atribut disabled, l'atribut readonly 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. {{ htmlattrdef("required") }} {{ HTMLVersionInline("5") }} Aquest atribut especifica que l'usuari ha d'omplir un valor abans d'enviar un formulari. {{ htmlattrdef("rows") }} El nombre de línies de text visibles per al control. {{ htmlattrdef("selectionDirection") }} {{ HTMLVersionInline("5") }} 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. {{ htmlattrdef("selectionEnd") }} L'índex de l'últim caràcter de la selecció actual. Si no hi ha selecció, el valor és l'índex del caràcter que segueix a la posició del cursor d'entrada de text. {{ htmlattrdef("selectionStart") }} L'índex per al primer caràcter de la selecció actual. Si no hi ha selecció, aquest valor és l'índex del caràcter que segueix a la posició del cursor d'entrada de text. {{ htmlattrdef("spellcheck") }} {{ HTMLVersionInline(5) }} Establir el valor d'aquest atribut en true 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 false indica que l'element no ha de ser revisat. {{ htmlattrdef("wrap") }} {{ HTMLVersionInline("5") }} Indica com el control ajusta el text. Els valors possibles són: hard: 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 cols ha de ser especificat. soft: 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. Si no s'especifica aquest atribut, soft és el valor predeterminat. Interfície DOM Aquest element implementa la interfície HTMLTextAreaElement. {{ h1_gecko_minversion("Resizable textareas", "2.0") }} {{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: textarea { resize: none; } Interacció amb CSS Pel que fa a CSS, un <textarea> és un element reemplaçat. L'especificació HTML no defineix on està la línia de base d'un <textarea>. Així que diferents navegadors ajustan a diferents posicions. Per Gecko, la línia de base de un <textarea> 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 <textarea>. No utilitzeu {{cssxref ("vertical-align")}}: baseline, ja que el comportament serà impredictible. Un textarea té dimensions intrínseques, com una imatge ampliada. Example Contingut HTML <textarea name="textarea" rows="10" cols="50">Write something here</textarea> {{ EmbedLiveSample('Example','600','200') }} Especificacions Especificació Estat Comentari {{SpecName('HTML WHATWG', 'the-button-element.html#the-textarea-element', '<textarea>')}} {{Spec2('HTML WHATWG')}} {{SpecName('HTML5 W3C', 'forms.html#the-textarea-element', '<textarea>')}} {{Spec2('HTML5 W3C')}} {{SpecName('HTML4.01', 'interact/forms.html#h-17.7', '<textarea>')}} {{Spec2('HTML4.01')}} Navegadors compatibles {{Compat("html.elements.textarea")}} Veure 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") }}. {{HTMLRef}}
L'element HTML <textarea> representa un control d'edició de text multi-línia sense format.
<textarea>
Aquest element inclou els atributs globals.
none
sentences
words
characters
on
off
Si l'atribut autocomplete no s'especifica en un element <textarea>, el navegador utilitza el valor de l'atribut autocomplete del propietari del formulari de l'element <textarea>. El propietari del formulari és l'element {{HTMLElement("form")}} en el qual l'element <textarea> és un descendent o bé l'element de formulari que el seu id és especificat per l'atribut form de l'element d'entrada. Per obtenir més informació, consulteu {{htmlattrxref("autocomplete", "form")}} en {{HTMLElement("form")}}.
disabled
readonly
true
false
cols
Si no s'especifica aquest atribut, soft és el valor predeterminat.
Aquest element implementa la interfície HTMLTextAreaElement.
HTMLTextAreaElement
{{ h1_gecko_minversion("Resizable textareas", "2.0") }}
{{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:
textarea { resize: none; }
Pel que fa a CSS, un <textarea> és un element reemplaçat. L'especificació HTML no defineix on està la línia de base d'un <textarea>. Així que diferents navegadors ajustan a diferents posicions. Per Gecko, la línia de base de un <textarea> 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 <textarea>. No utilitzeu {{cssxref ("vertical-align")}}: baseline, ja que el comportament serà impredictible.
baseline
Un textarea té dimensions intrínseques, com una imatge ampliada.
<textarea name="textarea" rows="10" cols="50">Write something here</textarea>
{{ EmbedLiveSample('Example','600','200') }}
{{Compat("html.elements.textarea")}}
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") }}.
{{HTMLRef}}