TextArea

TextArea बहुपंक्ति टेक्स्ट प्रविष्टि है। आधार TextInput के ऊपर, यह जोड़ता है: word-wrap, पंक्ति संरचना, ऊर्ध्वाधर रोलिंग, 2D निर्देशांक मैपिंग और बहुपंक्ति layout। यह दाईं ओर आइकन (प्रति दृश्य पंक्ति एक) और एक रोलेबल read-only मोड (लंबे टेक्स्ट को दिखाने के लिए जिसे उपयोगकर्ता केवल स्क्रॉल करता है) का समर्थन करता है।

TextField के विपरीत, TextArea में न मास्क है न पासवर्ड मोड; ENTER पंक्ति विच्छेद डालता है और getText() \n को संरक्षित रखता है।

🟡 · पैकेज: dev.crossfly.ui · विस्तार करता है: TextInput · शैली: TextAreaStyle

कब उपयोग करें

टिप्पणियाँ, comments, विवरण, पते — कोई भी कई पंक्तियों वाला टेक्स्ट।
एक लंबा रोलेबल ब्लॉक दिखाना (editable=false के साथ)।

कब उपयोग न करें

एक पंक्ति की प्रविष्टि (नाम, ई-मेल, मान) → TextField उपयोग करें।
मास्क / पासवर्ड मोड → TextField उपयोग करें (TextArea इनका समर्थन नहीं करता)।

रूप-रंग

TextAreaStyle की पृष्ठभूमि/बॉर्डर वाला आयत, पंक्तियों में टूटा हुआ टेक्स्ट (आंतरिक चौड़ाई पर word-wrap), सामग्री के ऊँचाई से अधिक होने पर ऊर्ध्वाधर रोलिंग के साथ। पसंदीदा ऊँचाई rowCount (दृश्य पंक्तियों की संख्या) × पंक्ति ऊँचाई + ingap से आती है। दाईं ओर के आइकन, जब परिभाषित हों, अपना एक स्तंभ लेते हैं, प्रति दृश्य पंक्ति एक।

पूरा उदाहरण (कॉपी करें, पेस्ट करें और चलाएँ)

package com.exemplo;

import dev.crossfly.ui.*;
import dev.crossfly.ui.layout.*;

/** चलाने योग्य मुख्य स्क्रीन। launcher (classname) की ओर संकेत करें और चलाएँ: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      // बहु-पंक्ति फ़ील्ड; LAY_FILL स्क्रॉल क्षेत्र को ऊँचाई देता है
      TextArea obs = new TextArea().caption("Observações");
      add(LAY_FILL, obs);

      // आउटपुट Label
      Label saida = new Label("Escreva algo e toque em Enviar");
      add(LAY_AUTO, saida);

      // हर कुंजी पर onChange नहीं है: भेजते समय getText() पढ़ें (\n संरक्षित रखता है)
      Button enviar = new Button("Enviar")
         .onAction(c -> saida.setText("Você escreveu " + obs.getText().length() + " caracteres"));
      add(LAY_AUTO, enviar);
   }
}

नीचे के अंश केवल मूल भाग दिखाते हैं (जो onShow() के अंदर जाता है)। चलाने के लिए, उन्हें ऊपर दिए MainWindow कंकाल में रखें।

बुनियादी उपयोग

TextArea obs = new TextArea().caption("Observações");
container.add(0.4f, obs);
// ...
String texto = obs.getText();   // \n संरक्षित रखता है

Constructors

Constructor	विवरण
`TextArea()`	खाली
`TextArea(String text)`	प्रारंभिक टेक्स्ट के साथ (`\r\n`/`\r` को `\n` में सामान्यीकृत)

गुण और अनुकूलन

गुण / विधि	प्रकार	डिफ़ॉल्ट	क्या करता है
`text(String)` / `setText(String)`	`TextArea` / `void`	—	टेक्स्ट सेट करता है (विच्छेद सामान्यीकृत करता है; cursor आरंभ में)
`getText()`	`String`	—	कच्चा टेक्स्ट, `\n` संरक्षित करते हुए
`caption(String)`	`TextArea` (fluente)	`null`	placeholder
`rightIcons(Icon...)`	`TextArea` (fluente)	—	दाईं ओर आइकन, प्रति दृश्य पंक्ति एक
`rightIconAction(int row, Action)`	`TextArea` (fluente)	—	पंक्ति `row` (0-based) के आइकन की क्रिया
`clearText()`	`void`	—	पूरा टेक्स्ट साफ़ करता है
`getNumberOfTextLines()`	`int`	—	कुल तार्किक पंक्तियाँ (word-wrapped)
`scrollToTop()` / `scrollToBottom()` / `scrollToLine(int)`	`void`	—	प्रोग्रामेटिक रोलिंग
शैली `.rowCount(int)`	`int`	—	दृश्य पंक्तियों की संख्या (पसंदीदा ऊँचाई परिभाषित करती है)
शैली `.maxLength(int)`	`int`	`0` (असीमित)	वर्ण सीमा
शैली `.validChars(String)`	`String`	`null`	अनुमत वर्ण (`\n` हमेशा स्वीकृत)
शैली `.editable(false)`	`boolean`	`true`	रोलेबल read-only
शैली `.spaceBetweenLines(int)`	`int`	—	पंक्तियों के बीच अतिरिक्त स्थान

Callbacks और घटनाएँ

Callback	कब ट्रिगर होता है
`onAction(Action)` (विरासत में)	`onTouchUp` में, कीबोर्ड खुलने के बाद
`onFocus()` / `onBlur()` (विरासत में)	फ़ोकस प्राप्ति / हानि
`rightIconAction(row, Action)`	उस पंक्ति के आइकन को स्पर्श (और छोड़ने) पर

अवस्थाएँ

focused: cursor झपकता है, स्पर्श पर कीबोर्ड खुलता है; ↑/↓ तीर पंक्तियों के बीच नेविगेट करते हैं।
selection: खींचकर 2D चयन; long-touch सब कुछ चुनता है और ActionSheet खोलता है।
read-only (editable=false): cursor/संपादन रहित; खींचना सामग्री को रोल करता है; माउस व्हील भी रोल करता है।

सीमा वाला टिप्पणी फ़ील्ड

TextArea obs = new TextArea().caption("Observações");
obs.style(Styles.theme()
   .textArea(State.NORMAL)
   .rowCount(4)
   .maxLength(500));
container.add(LAY_AUTO, obs);

केवल-पठन, रोलेबल टेक्स्ट ब्लॉक

TextArea termos = new TextArea(textoDosTermos);
termos.style(Styles.theme()
   .textArea(State.NORMAL)
   .editable(false)      // सिर्फ़ स्क्रॉल, संपादन नहीं
   .rowCount(8));
container.add(LAY_FILL, termos);
termos.scrollToTop();

दाईं ओर क्रिया आइकन वाली पंक्तियाँ

TextArea lista = new TextArea("Item A\nItem B\nItem C");
lista.rightIcons(
   new MaterialIcon(""),   // पंक्ति 0 पर "delete"
   new MaterialIcon(""),
   new MaterialIcon(""));
lista.rightIconAction(0, c -> removerLinha(0));
container.add(0.3f, lista);

अच्छे अभ्यास

दृश्य ऊँचाई नियंत्रित करने के लिए शैली में rowCount परिभाषित करें; layout में LAY_AUTO के साथ संयोजित करें।
संपादन के बिना लंबा टेक्स्ट दिखाने के लिए editable(false) उपयोग करें — खींचना चयन के बजाय रोल करने लगता है।
persist करने के लिए getText() उपयोग करें (\n संरक्षित करता है); \r\n का सामान्यीकरण प्रविष्टि पर पहले ही हो जाता है।

सामान्य गलतियाँ

मास्क या पासवर्ड मोड की अपेक्षा करना: TextArea इनका समर्थन नहीं करता — TextField उपयोग करें।
बहुत सारे rightIcons परिभाषित करना: केवल visibleRows (दृश्य पंक्तियों की संख्या) तक ही चित्रित होते हैं; इससे अधिक आइकन अनदेखे रहते हैं।

यह भी देखें

क्षेत्र गाइड: ui/ · रेसिपी: cookbook/
अवधारणा (फ़ोकस, चयन, scroll): concepts/
संबंधित घटक: TextInput · TextField · Keypad