টেক্সট ফিল্ডে স্টাইলাস ইনপুট

Compose-এর মাধ্যমে চেষ্টা করুন
Jetpack Compose হল Android-এর জন্য সাজেস্ট করা UI টুলকিট। Compose-এ কীভাবে স্টাইলাস ব্যবহার করতে হয় তা জানুন।

Android 14 (API লেভেল 34) এবং তার পরবর্তী ভার্সনে ব্যবহারকারীরা স্টাইলাস ব্যবহার করে যেকোনও অ্যাপের যেকোনও টেক্সট ইনপুট ফিল্ডে লিখতে পারবেন। Android টেক্সট এন্ট্রি ফিল্ড, যার মধ্যে EditText কম্পোনেন্ট এবং WebView টেক্সট উইজেট অন্তর্ভুক্ত, ডিফল্ট হিসেবে স্টাইলাস ইনপুট সমর্থন করে।

তবে, আপনার অ্যাপে কাস্টম টেক্সট ইনপুট ফিল্ডের (কাস্টম টেক্সট এডিটর দেখুন) প্রয়োজন হলে অথবা ড্রয়িং সারফেসের উপর টেক্সট এন্ট্রি ফিল্ড ওভারলে সহ জটিল লেআউট থাকলে, আপনাকে অ্যাপ কাস্টমাইজ করতে হবে।

ছবি ১. স্টাইলাস ব্যবহার করে হাতে লেখা ইনপুট।

EditText

Android 14 ও তার পরবর্তী যেকোনও ভার্সনে ডিফল্ট হিসেবে সব EditText ফিল্ডের জন্য স্টাইলাস হ্যান্ডরাইটিং চালু করা থাকে। ভিউয়ের হাতের লেখা বাউন্ডের মধ্যে স্টাইলাস মোশন ইভেন্ট শনাক্ত করা হলে, EditText-এর জন্য হাতের লেখা মোড শুরু হয়।

হাতে লেখার বাউন্ডে ৪০ ডিপি উল্লম্ব প্যাডিং এবং ১০ ডিপি অনুভূমিক প্যাডিং ভিউয়ের চারপাশে অন্তর্ভুক্ত থাকে। setHandwritingBoundsOffsets()-এর সাহায্যে হাতে লেখার বাউন্ড অ্যাডজাস্ট করুন। setAutoHandwritingEnabled(false)-এর মাধ্যমে হাতের লেখা বন্ধ করুন।

স্টাইলাস মোশন ইভেন্ট শনাক্ত করার জন্য বাউন্ড নির্দেশ করে এমন চতুর্ভুজ সহ ইনপুট ফিল্ড।
ছবি ২. EditTextটি ফিল্ডের হাতের লেখার বাউন্ড।

ইনপুট ডেলিগেশন

অ্যাপগুলি প্লেসহোল্ডার UI এলিমেন্ট দেখাতে পারে যা টেক্সট ইনপুট ফিল্ডের মতো দেখায় কিন্তু আসলে টেক্সট ইনপুট করার ক্ষমতা ছাড়াই শুধু স্ট্যাটিক UI এলিমেন্ট। সার্চ ফিল্ড হল একটি সাধারণ উদাহরণ। স্ট্যাটিক UI এলিমেন্টে ট্যাপ করলে, নতুন UI-তে ট্রানজিশন ট্রিগার হয়। এতে ইনপুটের জন্য ফোকাস করা একটি ফাংশনাল টেক্সট ইনপুট ফিল্ড থাকে।

ছবি ৩. স্ট্যাটিক UI এলিমেন্ট থেকে টেক্সট ইনপুট ফিল্ডে ইনপুট ডেলিগেশন।

স্টাইলাস ইনপুট ডেলিগেশন

প্লেসহোল্ডার ইনপুট ফিল্ডের জন্য স্টাইলাস হ্যান্ডরাইটিং ইনপুটকে সমর্থন করতে হ্যান্ডরাইটিং ডেলিগেশন API ব্যবহার করুন (দেখুন setHandwritingDelegatorCallback() এবং setIsHandwritingDelegate())। প্লেসহোল্ডার UI এলিমেন্টটি একটি ফাংশনাল ইনপুট ফিল্ডে হ্যান্ডরাইটিং ডেলিগেট করার জন্য কনফিগার করা হয়েছে, উদাহরণস্বরূপ:

Kotlin

if (Build.VERSION.SDK_INT >= 34) {
    placeholderInputField.setHandwritingDelegatorCallback {
        showAndFocusDelegateInputField()
    }
    delegateInputField.setIsHandwritingDelegate(true)
}

জাভা

if (Build.VERSION.SDK_INT >= 34) {
    placeholderInputField.setHandwritingDelegatorCallback(this::showAndFocusInputFieldDelegate);
    delegateInputField.setIsHandwritingDelegate(true);
}

প্লেসহোল্ডার টেক্সট ইনপুট ফিল্ড ভিউয়ের উপর স্টাইলাস মোশন কলব্যাককে ইনভোক করে। কলব্যাকটি UI ট্রানজিশন ট্রিগার করে যাতে ফাংশনাল ইনপুট ফিল্ড দেখানো এবং ফোকাস করা যায়। কলব্যাক প্রয়োগ করার পদ্ধতি সাধারণত প্লেসহোল্ডার এলিমেন্টে ক্লিক লিসনার প্রয়োগ করার পদ্ধতির মতোই হয়। ফাংশনাল ইনপুট ফিল্ড InputConnection তৈরি করলে, স্টাইলাস হ্যান্ডরাইটিং মোড শুরু হয়।

ছবি ৪. স্ট্যাটিক UI এলিমেন্ট থেকে টেক্সট ইনপুট ফিল্ডে স্টাইলাস ইনপুট ডেলিগেশন।

মেটেরিয়াল ডিজাইন

com.google.android.material.search লাইব্রেরি SearchBar এবং SearchView ক্লাস প্রদান করে যাতে প্লেসহোল্ডার UI প্যাটার্ন প্রয়োগ করা সহজ হয়।

প্লেসহোল্ডার এবং ফাংশনাল সার্চ ভিউ setUpWithSearchBar()-এর সাথে লিঙ্ক করা আছে।

হ্যান্ডরাইটিং ডেলিগেশন মেটেরিয়াল লাইব্রেরিতে কনফিগার করা আছে, তাই আপনার অ্যাপে অতিরিক্ত ডেভেলপমেন্টের প্রয়োজন নেই।

ড্রয়িং সারফেসের সাথে ওভারল্যাপ করা

আপনার অ্যাপে যদি টেক্সট ফিল্ড ওভারলেয়িং সারফেস সহ ড্রয়িং সারফেস থাকে, তাহলে ব্যবহারকারীকে আঁকার অনুমতি দিতে আপনাকে স্টাইলাস হাতের লেখা বন্ধ করতে হতে পারে। setAutoHandwritingEnabled() দেখুন।

পরীক্ষা করা

Android 14 ও তার পরবর্তী যেকোনও ভার্সনের ডিভাইসে স্টাইলাস হাতের লেখা কাজ করে। এর জন্য মানানসই স্টাইলাস ইনপুট ডিভাইস ও ইনপুট পদ্ধতি এডিটর (IME) থাকতে হবে যা Android 14 স্টাইলাস হাতের লেখার API-এর সাথে কাজ করে।

আপনার কাছে স্টাইলাস ইনপুট ডিভাইস না থাকলে, নিম্নলিখিত Android ডিবাগ ব্রিজ (adb) কমান্ড ব্যবহার করে রুট অ্যাক্সেস (এমুলেটর সহ) সহ যেকোনও ডিভাইসে স্টাইলাস ইনপুট সিমুলেট করুন:


// Android 14
adb shell setprop persist.debug.input.simulate_stylus_with_touch true && adb shell stop && adb shell start

// Android 15 and higher
// Property takes effect after screen reconfiguration such as orientation change.
adb shell setprop debug.input.simulate_stylus_with_touch true

আপনি যদি এমন কোনও ডিভাইস ব্যবহার করেন যা স্টাইলাস সমর্থন করে না, তাহলে পরীক্ষা করার জন্য Gboard বিটা ব্যবহার করুন।

অতিরিক্ত রিসোর্স