রিফ্রেশ তারিখ: ২০২৬-০৯-২৫ রোবটস: নোইনডেক্স
বর্ণনা
অমনিবক্স এপিআই আপনাকে গুগল ক্রোমের অ্যাড্রেস বারে একটি কীওয়ার্ড নিবন্ধন করার সুযোগ দেয়, যা অমনিবক্স নামেও পরিচিত।
যখন ব্যবহারকারী আপনার এক্সটেনশনের কীওয়ার্ডটি টাইপ করেন, তখন তিনি শুধুমাত্র আপনার এক্সটেনশনটির সাথেই ইন্টারঅ্যাক্ট করা শুরু করেন। প্রতিটি কীস্ট্রোক আপনার এক্সটেনশনে পাঠানো হয় এবং আপনি তার জবাবে সাজেশন দিতে পারেন।
সাজেশনগুলো বিভিন্ন উপায়ে আকর্ষণীয়ভাবে ফরম্যাট করা যেতে পারে। যখন ব্যবহারকারী কোনো সাজেশন গ্রহণ করেন, তখন আপনার এক্সটেনশনকে জানানো হয় এবং সেটি প্রয়োজনীয় ব্যবস্থা নিতে পারে।
প্রকাশ
অমনিবক্স এপিআই ব্যবহার করার জন্য আপনাকে ম্যানিফেস্টে অবশ্যই একটি omnibox keyword ফিল্ড অন্তর্ভুক্ত করতে হবে। এছাড়াও আপনাকে একটি ১৬x১৬-পিক্সেলের আইকন নির্দিষ্ট করতে হবে, যা ব্যবহারকারীদের কীওয়ার্ড মোডে প্রবেশ করার পরামর্শ দেওয়ার সময় অ্যাড্রেস বারে প্রদর্শিত হবে।
উদাহরণস্বরূপ:
{
"name": "Aaron's omnibox extension",
"version": "1.0",
"omnibox": { "keyword" : "aaron" },
"icons": {
"16": "16-full-color.png"
},
"background": {
"persistent": false,
"scripts": ["background.js"]
}
}
উদাহরণ
এই API-টি ব্যবহার করার জন্য, chrome-extension-samples রিপোজিটরি থেকে omnibox API উদাহরণটি ইনস্টল করুন।
প্রকারভেদ
DefaultSuggestResult
একটি প্রস্তাবিত ফলাফল।
বৈশিষ্ট্য
- বর্ণনা
স্ট্রিং
ইউআরএল ড্রপডাউনে যে টেক্সটটি প্রদর্শিত হয়। এতে স্টাইলিংয়ের জন্য এক্সএমএল-স্টাইলের মার্কআপ থাকতে পারে। সমর্থিত ট্যাগগুলো হলো 'url' (আক্ষরিক ইউআরএল-এর জন্য), 'match' (ব্যবহারকারীর কোয়েরির সাথে মিলে যাওয়া টেক্সট হাইলাইট করার জন্য), এবং 'dim' (সহায়ক টেক্সটকে অনুজ্জ্বল করার জন্য)। স্টাইলগুলো নেস্টেড হতে পারে, যেমন—dimmed match।
DescriptionStyleType
শৈলীর ধরণ।
এনাম
"ইউআরএল" "ম্যাচ" "ম্লান"
OnInputEnteredDisposition
অমনিবক্স কোয়েরির জন্য উইন্ডো ডিসপোজিশন। ফলাফল প্রদর্শনের জন্য এটিই প্রস্তাবিত প্রেক্ষাপট। উদাহরণস্বরূপ, যদি অমনিবক্স কমান্ডটি কোনো নির্দিষ্ট ইউআরএল-এ নেভিগেট করার জন্য হয়, তাহলে 'newForegroundTab' ডিসপোজিশনের অর্থ হলো নেভিগেশনটি একটি নতুন নির্বাচিত ট্যাবে সম্পন্ন হবে।
এনাম
"বর্তমান ট্যাব" "newForegroundTab" "নতুন ব্যাকগ্রাউন্ড ট্যাব"
SuggestResult
একটি প্রস্তাবিত ফলাফল।
বৈশিষ্ট্য
- বিষয়বস্তু
স্ট্রিং
যে টেক্সটটি ইউআরএল বারে রাখা হয় এবং ব্যবহারকারী এই এন্ট্রিটি বেছে নিলে যা এক্সটেনশনে পাঠানো হয়।
- মুছে ফেলা যায়
বুলিয়ান ঐচ্ছিক
ক্রোম ৬৩+ব্যবহারকারী প্রস্তাবিত ফলাফলটি মুছে ফেলতে পারবেন কিনা।
- বর্ণনা
স্ট্রিং
ইউআরএল ড্রপডাউনে যে টেক্সটটি প্রদর্শিত হয়। স্টাইলিংয়ের জন্য এতে এক্সএমএল-স্টাইলের মার্কআপ থাকতে পারে। সমর্থিত ট্যাগগুলো হলো 'url' (আক্ষরিক ইউআরএল-এর জন্য), 'match' (ব্যবহারকারীর কোয়েরির সাথে মিলে যাওয়া টেক্সট হাইলাইট করার জন্য), এবং 'dim' (ডিম হেল্পার টেক্সটের জন্য)। স্টাইলগুলো নেস্টেড হতে পারে, যেমন ডিমড ম্যাচ। পাঁচটি পূর্বনির্ধারিত এনটিটিকে টেক্সট হিসেবে প্রদর্শন করতে হলে আপনাকে অবশ্যই সেগুলোকে এস্কেপ করতে হবে: stackoverflow.com/a/1091953/89484
পদ্ধতি
setDefaultSuggestion()
chrome.omnibox.setDefaultSuggestion(
suggestion: DefaultSuggestResult,
callback?: function,
): Promise<void>
ডিফল্ট সাজেশনের বিবরণ এবং স্টাইলিং নির্ধারণ করে। ডিফল্ট সাজেশন হলো সেই টেক্সট যা ইউআরএল বারের নিচে প্রথম সাজেশন সারিতে প্রদর্শিত হয়।
প্যারামিটার
- পরামর্শ
'content' প্যারামিটারটি ছাড়া একটি আংশিক SuggestResult অবজেক্ট।
- কলব্যাক
ফাংশন ঐচ্ছিক
ক্রোম ১০০+callbackপ্যারামিটারটি দেখতে এইরকম:() => void
ফেরত
প্রতিশ্রুতি<শূন্য>
ক্রোম ১০০+প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।
ইভেন্টগুলি
onDeleteSuggestion
chrome.omnibox.onDeleteSuggestion.addListener(
callback: function,
)
ব্যবহারকারী একটি প্রস্তাবিত ফলাফল মুছে দিয়েছেন।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:(text: string) => void
- পাঠ্য
স্ট্রিং
onInputCancelled
chrome.omnibox.onInputCancelled.addListener(
callback: function,
)
ব্যবহারকারী ইনপুট গ্রহণ না করেই কীওয়ার্ড ইনপুট সেশনটি শেষ করেছেন।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:() => void
onInputChanged
chrome.omnibox.onInputChanged.addListener(
callback: function,
)
ব্যবহারকারী অমনিবক্সে টাইপ করা বিষয়বস্তু পরিবর্তন করেছেন।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:(text: string, suggest: function) => void
- পাঠ্য
স্ট্রিং
- পরামর্শ দিন
ফাংশন
suggestপ্যারামিটারটি দেখতে এইরকম:(suggestResults: SuggestResult[]) => void
- ফলাফল প্রস্তাব করুন
পরামর্শমূলক ফলাফলের অ্যারে
onInputEntered
chrome.omnibox.onInputEntered.addListener(
callback: function,
)
ব্যবহারকারী অমনিবক্সে যা টাইপ করা হয়েছে তা গ্রহণ করেছেন।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:(text: string, disposition: OnInputEnteredDisposition) => void
- পাঠ্য
স্ট্রিং
- স্বভাব
onInputStarted
chrome.omnibox.onInputStarted.addListener(
callback: function,
)
ব্যবহারকারী এক্সটেনশনের কীওয়ার্ড টাইপ করে একটি কীওয়ার্ড ইনপুট সেশন শুরু করেছেন। এটি প্রতি ইনপুট সেশনে ঠিক একবার এবং যেকোনো onInputChanged ইভেন্টের আগে পাঠানো হবে বলে নিশ্চিত করা হয়েছে।
প্যারামিটার
- কলব্যাক
ফাংশন
callbackপ্যারামিটারটি দেখতে এইরকম:() => void