ট্যাব দিয়ে কাজ করুন

গুগল ডক্সের জন্য অ্যাপস স্ক্রিপ্ট আপনাকে ডকুমেন্টের যেকোনো ট্যাব থেকে কন্টেন্ট অ্যাক্সেস করতে দেয়।

ট্যাব কি?

গুগল ডক্সে ট্যাব নামে একটি সাংগঠনিক স্তর রয়েছে। ডক্স ব্যবহারকারীদের একটি একক ডকুমেন্টের মধ্যে এক বা একাধিক ট্যাব তৈরি করতে দেয়, যেমনটি আজকাল শীটগুলিতে ট্যাব রয়েছে। প্রতিটি ট্যাবের নিজস্ব শিরোনাম এবং একটি আইডি থাকে (URL-এ সংযুক্ত)। একটি ট্যাবে চাইল্ড ট্যাবও থাকতে পারে, যা এমন ট্যাব যা অন্য ট্যাবের নীচে নেস্ট করা থাকে।

ট্যাব অ্যাক্সেস করুন

Document.getTabs() দিয়ে ট্যাব প্রোপার্টি এবং কন্টেন্ট অ্যাক্সেসযোগ্য, যা Tab গুলির একটি তালিকা প্রদান করে। পরবর্তী বিভাগগুলি Tab ক্লাসের একটি সংক্ষিপ্ত সারসংক্ষেপ দেয়; ট্যাব ক্লাস ডকুমেন্টেশন আরও বিস্তারিত তথ্য প্রদান করে।

ট্যাব বৈশিষ্ট্য

Tab.getId() এবং Tab.getTitle() এর মতো পদ্ধতি ব্যবহার করে ট্যাব বৈশিষ্ট্যগুলি পুনরুদ্ধার করা যেতে পারে।

ট্যাবের বিষয়বস্তু

প্রতিটি ট্যাবের মধ্যে থাকা ডকুমেন্টের বিষয়বস্তু Tab.asDocumentTab() ব্যবহার করে পুনরুদ্ধার করা যেতে পারে। Changes to Document Class structure বিভাগে এটি কীভাবে ব্যবহার করা যেতে পারে তা বর্ণনা করা হয়েছে।

ট্যাব শ্রেণিবিন্যাস

Google Apps স্ক্রিপ্টে চাইল্ড ট্যাবগুলি Tab.getChildTabs() এর মাধ্যমে উন্মুক্ত করা হয়। সমস্ত ট্যাব থেকে কন্টেন্ট অ্যাক্সেস করার জন্য চাইল্ড ট্যাবের "ট্রি" অতিক্রম করতে হবে। উদাহরণস্বরূপ, এমন একটি ডকুমেন্ট বিবেচনা করুন যেখানে নিম্নলিখিতভাবে একটি ট্যাব শ্রেণিবিন্যাস রয়েছে:

ট্যাব 3.1.2 অ্যাক্সেস করার জন্য, আপনি নিম্নলিখিতগুলি করতে পারেন:

// Print the ID of Tab 3.1.2.
const doc = DocumentApp.getActiveDocument();
const tab = doc.getTabs()[2].getChildTabs()[0].getChildTabs()[1];
console.log(tab.getId());

পরবর্তী বিভাগগুলিতে নমুনা কোড ব্লকগুলি দেখুন, যা একটি নথির সমস্ত ট্যাব জুড়ে পুনরাবৃত্তির জন্য নমুনা কোড প্রদান করে।

ট্যাব পুনরুদ্ধারের অন্যান্য উপায়

ট্যাবগুলি পুনরুদ্ধার করার আরও দুটি উপায় রয়েছে:

• Document.getTab(tabId) : নির্দিষ্ট আইডি সহ ট্যাবটি ফেরত পাঠায়।
• Document.getActiveTab() : ব্যবহারকারীর সক্রিয় ট্যাবটি ফেরত পাঠায়। শুধুমাত্র সেই স্ক্রিপ্টগুলিতে কাজ করে যা একটি ডকুমেন্টের সাথে আবদ্ধ । পরবর্তী বিভাগগুলিতে এটি আরও বিশদে বর্ণনা করা হয়েছে।

ডকুমেন্ট ক্লাস কাঠামোর পরিবর্তন

অতীতে, ডকুমেন্টগুলিতে ট্যাবের ধারণা ছিল না, তাই ডকুমেন্ট ক্লাস ডকুমেন্টের টেক্সট কন্টেন্ট সরাসরি অ্যাক্সেস এবং পরিবর্তন করার পদ্ধতিগুলি প্রকাশ করেছিল। নিম্নলিখিত পদ্ধতিগুলি এই বিভাগে পড়ে:

• Document.addBookmark(position)
• Document.addFooter()
• Document.addHeader()
• Document.addNamedRange(name, range)
• Document.getBody()
• Document.getBookmark(id)
• Document.getBookmarks()
• Document.getFooter()
• Document.getFootnotes()
• Document.getHeader()
• Document.getNamedRangeById(id)
• Document.getNamedRanges()
• Document.getNamedRanges(name)
• Document.newPosition(element, offset)
• Document.newRange()

ট্যাবগুলির অতিরিক্ত কাঠামোগত শ্রেণিবিন্যাসের সাথে, এই পদ্ধতিগুলি আর ডকুমেন্টের সমস্ত ট্যাব থেকে টেক্সট কন্টেন্টকে শব্দার্থিকভাবে উপস্থাপন করে না। টেক্সট কন্টেন্ট এখন একটি ভিন্ন স্তরে উপস্থাপন করা হবে; উপরে উল্লিখিত সমস্ত টেক্সট পদ্ধতি DocumentTab এর মাধ্যমে অ্যাক্সেসযোগ্য।

Document ক্লাসের এই বিদ্যমান পদ্ধতিগুলি সক্রিয় ট্যাব (একটি নির্দিষ্ট ডকুমেন্টের সাথে আবদ্ধ স্ক্রিপ্টগুলিতে) অথবা প্রথম ট্যাব (যদি কোনও সক্রিয় উপলব্ধ না থাকে) থেকে কন্টেন্ট অ্যাক্সেস বা সংশোধন করবে।

একটি নির্দিষ্ট ট্যাবের মধ্যে টেক্সট কন্টেন্ট অ্যাক্সেস করুন

Document এর বাইরে টেক্সট পদ্ধতি ব্যবহার করার পরিবর্তে, DocumentTab ক্লাসের বাইরে উপলব্ধ পদ্ধতিগুলি ব্যবহার করার পরামর্শ দেওয়া হচ্ছে (যা Tab.asDocumentTab() পদ্ধতির মাধ্যমে উপলব্ধ)। উদাহরণস্বরূপ:

// Print the text from the body of the active tab.
const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();
console.log(body.getText());

ব্যবহারকারী নির্বাচনে পরিবর্তন

দ্রষ্টব্য: ব্যবহারকারীর নির্বাচনের ধারণাটি কেবলমাত্র প্রাসঙ্গিক এবং কেবলমাত্র নথির সাথে আবদ্ধ স্ক্রিপ্টগুলি দ্বারা ব্যবহার বা পরিবর্তন করা যেতে পারে।

টেক্সট নির্বাচন পদ্ধতি

Document ক্লাসটি সক্রিয় ডকুমেন্টের মধ্যে ব্যবহারকারীর টেক্সটের কোন অংশ নির্বাচন করা হচ্ছে তা পরিচালনা করার জন্য গেটার এবং সেটার প্রদান করে। এই পদ্ধতিগুলি স্ক্রিপ্টটি চালানো ব্যবহারকারীর সক্রিয় ট্যাবের প্রেক্ষাপটে কাজ করে।

• Document.getCursor() : সক্রিয় ট্যাবে ব্যবহারকারীর কার্সার অবস্থান ফেরত পাঠায়।
• Document.getSelection() : সক্রিয় ট্যাবে ব্যবহারকারীর নির্বাচন পরিসর ফেরত পাঠায়।
• Document.setCursor(position) : সক্রিয় ডকুমেন্টে ব্যবহারকারীর কার্সার অবস্থান সেট করে। যদি অবস্থানটি একটি নিষ্ক্রিয় ট্যাবে থাকে, তাহলে ব্যবহারকারীর সক্রিয় ট্যাবটিও সেই অবস্থানের সাথে সম্পর্কিত ট্যাবে স্যুইচ করা হয়।
• Document.setSelection(range) : সক্রিয় ডকুমেন্টে ব্যবহারকারীর নির্বাচনের পরিসর সেট করে। যদি পরিসরটি একটি নিষ্ক্রিয় ট্যাবে থাকে, তাহলে ব্যবহারকারীর সক্রিয় ট্যাবটিও সেই পরিসরের সাথে সম্পর্কিত ট্যাবে স্যুইচ করা হয়।

ট্যাব নির্বাচন পদ্ধতি এবং ব্যবহারের ধরণ

ট্যাব চালু করার সাথে সাথে, স্ক্রিপ্টটি চালানো ব্যবহারকারীর সক্রিয় ট্যাবটি পেতে এবং সেট করা কার্যকর হতে পারে। এটি নিম্নলিখিত পদ্ধতিগুলি ব্যবহার করে করা যেতে পারে:

• Document.getActiveTab() : সক্রিয় ডকুমেন্টে ব্যবহারকারীর সক্রিয় Tab ফেরত পাঠায়।
• Document.setActiveTab(tabId) : বর্তমান ডকুমেন্টে ব্যবহারকারীর নির্বাচিত Tab নির্দিষ্ট আইডি সহ ট্যাবে সেট করে।

ব্যবহারকারীর সামগ্রিক "নির্বাচন" সক্রিয় ট্যাবের সংমিশ্রণে গঠিত, যার মধ্যে বর্তমান কার্সার অবস্থান অথবা নির্বাচন পরিসর অন্তর্ভুক্ত। একটি সক্রিয় নির্বাচনের সাথে কাজ করার জন্য দুটি প্যাটার্ন হল ব্যবহারকারীর সক্রিয় ট্যাবকে স্পষ্টভাবে একটি নির্দিষ্ট ট্যাবে পরিবর্তন করা অথবা ব্যবহারকারীর সক্রিয় ট্যাব ব্যবহার করা।

ব্যবহারকারীর সক্রিয় ট্যাবটি স্পষ্টভাবে পরিবর্তন করার জন্য Document.setActiveTab(tabId) ব্যবহার করা যেতে পারে। বিকল্পভাবে, একটি নিষ্ক্রিয় ট্যাব থেকে একটি Position বা Range সহ Document.setCursor(position) অথবা Document.setSelection(range) কল করলে সেই ট্যাবটি নতুনভাবে সক্রিয় হবে।

যদি স্ক্রিপ্টের উদ্দেশ্য ব্যবহারকারীর সক্রিয় ট্যাব পরিবর্তন না করে ব্যবহার করা হয়, তাহলে Document.setActiveTab(tabId) প্রয়োজন হয় না। Document.getCursor() এবং Document.getSelection() পদ্ধতিগুলি ইতিমধ্যেই সক্রিয় ট্যাবের উপর কাজ করবে, ব্যবহারকারী যে ট্যাব থেকে স্ক্রিপ্টটি চালাচ্ছেন তার উপর ভিত্তি করে।

মনে রাখবেন যে একটি ডকুমেন্ট একাধিক ট্যাব নির্বাচন বা বিভিন্ন ট্যাব জুড়ে একাধিক অবস্থান বা রেঞ্জ সমর্থন করে না। অতএব, Document.setActiveTab(tabId) ব্যবহার করলে পূর্ববর্তী কার্সার অবস্থান বা নির্বাচন পরিসর মুছে যাবে।

একটি নির্দিষ্ট ট্যাবের জন্য অবস্থান এবং পরিসর পদ্ধতি

নির্দিষ্ট ট্যাব হল Position এবং Range এর টেক্সট নির্বাচন ধারণাগুলিকে অর্থপূর্ণ করে তোলে। অন্য কথায়, একটি কার্সার অবস্থান বা একটি নির্বাচন পরিসর কেবল তখনই অর্থপূর্ণ হয় যদি স্ক্রিপ্টটি নির্দিষ্ট ট্যাবটি জানে যে অবস্থান বা পরিসরটি কোনটিতে অবস্থিত।

এটি DocumentTab.newPosition(element, offset) এবং DocumentTab.newRange() পদ্ধতি ব্যবহার করে অর্জন করা হয়, যা একটি অবস্থান বা পরিসর তৈরি করে যা নির্দিষ্ট DocumentTab লক্ষ্য করে যেখান থেকে পদ্ধতিটি কল করা হয়েছে। বিপরীতে, Document.newPosition(element, offset) এবং Document.newRange() একটি অবস্থান বা পরিসর তৈরি করবে যা সক্রিয় ট্যাবকে (অথবা প্রথম ট্যাব, যদি স্ক্রিপ্টটি আবদ্ধ না থাকে) লক্ষ্য করে।

পরবর্তী বিভাগগুলিতে নমুনা কোড ব্লকগুলি দেখুন, যা নির্বাচনের সাথে কাজ করার জন্য নমুনা কোড প্রদান করে।

ট্যাবগুলির জন্য সাধারণ ব্যবহারের ধরণ

নিম্নলিখিত কোড নমুনাগুলি ট্যাবগুলির সাথে ইন্টারঅ্যাক্ট করার বিভিন্ন উপায় বর্ণনা করে।

ডকুমেন্টের সমস্ত ট্যাব থেকে ট্যাবের কন্টেন্ট পড়ুন

ট্যাব বৈশিষ্ট্যের আগে যে কোডগুলি এটি করেছিল, সেগুলি ট্যাব ট্রি ট্র্যাভার্স করে এবং Tab এবং Document পরিবর্তে DocumentTab থেকে গেটার পদ্ধতিগুলি কল করে সাপোর্ট ট্যাবগুলিতে স্থানান্তরিত করা যেতে পারে। নিম্নলিখিত আংশিক কোড নমুনাটি দেখায় যে কীভাবে একটি ডকুমেন্টের প্রতিটি ট্যাব থেকে সমস্ত টেক্সট সামগ্রী মুদ্রণ করতে হয়। এই ট্যাব ট্র্যাভার্সাল কোডটি অন্যান্য অনেক ব্যবহারের ক্ষেত্রে অভিযোজিত হতে পারে যা ট্যাবগুলির প্রকৃত কাঠামো সম্পর্কে চিন্তা করে না।

/** Logs all text contents from all tabs in the active document. */
function logAllText() {
  // Generate a list of all the tabs in the document, including any
  // nested child tabs. DocumentApp.openById('abc123456') can also
  // be used instead of DocumentApp.getActiveDocument().
  const doc = DocumentApp.getActiveDocument();
  const allTabs = getAllTabs(doc);

  // Log the content from each tab in the document.
  for (const tab of allTabs) {
    // Get the DocumentTab from the generic Tab object.
    const documentTab = tab.asDocumentTab();
    // Get the body from the given DocumentTab.
    const body = documentTab.getBody();
    // Get the body text and log it to the console.
    console.log(body.getText());
  }
}

/**
 * Returns a flat list of all tabs in the document, in the order
 * they would appear in the UI (i.e. top-down ordering). Includes
 * all child tabs.
 */
function getAllTabs(doc) {
  const allTabs = [];
  // Iterate over all tabs and recursively add any child tabs to
  // generate a flat list of Tabs.
  for (const tab of doc.getTabs()) {
    addCurrentAndChildTabs(tab, allTabs);
  }
  return allTabs;
}

/**
 * Adds the provided tab to the list of all tabs, and recurses
 * through and adds all child tabs.
 */
function addCurrentAndChildTabs(tab, allTabs) {
  allTabs.push(tab);
  for (const childTab of tab.getChildTabs()) {
    addCurrentAndChildTabs(childTab, allTabs);
  }
}

ডকুমেন্টের প্রথম ট্যাব থেকে ট্যাবের বিষয়বস্তু পড়ুন

এটি সমস্ত ট্যাব পড়ার মতো।

/** 
 * Logs all text contents from the first tab in the active 
 * document. 
 */
function logAllText() {
  // Generate a list of all the tabs in the document, including any
  // nested child tabs.
  const doc = DocumentApp.getActiveDocument();
  const allTabs = getAllTabs(doc);

  // Log the content from the first tab in the document.
  const firstTab = allTabs[0];
  // Get the DocumentTab from the generic Tab object.
  const documentTab = firstTab.asDocumentTab();
  // Get the body from the DocumentTab.
  const body = documentTab.getBody();
  // Get the body text and log it to the console.
  console.log(body.getText());
}

প্রথম ট্যাবে ট্যাবের বিষয়বস্তু আপডেট করুন

নিম্নলিখিত আংশিক কোড নমুনাটি দেখায় যে আপডেট করার সময় কীভাবে একটি নির্দিষ্ট ট্যাবকে লক্ষ্য করতে হয়।

/** Inserts text into the first tab of the active document. */
function insertTextInFirstTab() {
  // Get the first tab's body.
  const doc = DocumentApp.getActiveDocument();
  const firstTab = doc.getTabs()[0];
  const firstDocumentTab = firstTab.asDocumentTab();
  const firstTabBody = firstDocumentTab.getBody();

  // Append a paragraph and a page break to the first tab's body
  // section.
  firstTabBody.appendParagraph("A paragraph.");
  firstTabBody.appendPageBreak();
}

সক্রিয় বা নির্বাচিত ট্যাবে ট্যাবের বিষয়বস্তু আপডেট করুন

নিম্নলিখিত আংশিক কোড নমুনাটি দেখায় যে আপডেট করার সময় সক্রিয় ট্যাবটিকে কীভাবে লক্ষ্য করতে হয়।

/**
 * Inserts text into the active/selected tab of the active
 * document.
 */
function insertTextInActiveTab() {
  // Get the active/selected tab's body.
  const doc = DocumentApp.getActiveDocument();
  const activeTab = doc.getActiveTab();
  const activeDocumentTab = activeTab.asDocumentTab();
  const activeTabBody = activeDocumentTab.getBody();

  // Append a paragraph and a page break to the active tab's body
  // section.
  activeTabBody.appendParagraph("A paragraph.");
  activeTabBody.appendPageBreak();
}

সক্রিয় ট্যাবে কার্সারের অবস্থান বা নির্বাচনের পরিসর সেট করুন

নিম্নলিখিত আংশিক কোড নমুনাটি দেখায় কিভাবে ব্যবহারকারীর সক্রিয় ট্যাবের মধ্যে কার্সার অবস্থান বা নির্বাচন পরিসর আপডেট করতে হয়। এটি শুধুমাত্র বাউন্ড স্ক্রিপ্টের ক্ষেত্রে প্রাসঙ্গিক।

/**
 * Changes the user's selection to select all tables within the tab
 * with the provided ID.
 */
function selectAllTables(tabId) {
  const doc = DocumentApp.getActiveDocument();
  const tab = doc.getTab(tabId);
  const documentTab = tab.asDocumentTab();

  // Build a range that encompasses all tables within the specified
  // tab.
  const rangeBuilder = documentTab.newRange();
  const tables = documentTab.getBody().getTables();
  for (let i = 0; i < tables.length; i++) {
    rangeBuilder.addElement(tables[i]);
  }
  // Set the document's selection to the tables within the specified
  // tab. Note that this actually switches the user's active tab as
  // well.
  doc.setSelection(rangeBuilder.build());
}

সক্রিয় অথবা নির্বাচিত ট্যাব সেট করুন

নিম্নলিখিত আংশিক কোড নমুনাটি ব্যবহারকারীর সক্রিয় ট্যাব কীভাবে পরিবর্তন করতে হয় তা দেখায়। এটি কেবল বাউন্ড স্ক্রিপ্টের ক্ষেত্রেই প্রাসঙ্গিক।

/**
 * Changes the user's selected tab to the tab immediately following
 * the currently selected one. Handles child tabs.
 *
 * 
Only changes the selection if there is a tab following the
 * currently selected one.
 */
function selectNextTab() {
  const doc = DocumentApp.getActiveDocument();
  const allTabs = getAllTabs(doc);
  const activeTab = doc.getActiveTab();

  // Find the index of the currently active tab.
  let activeTabIndex = -1;
  for (let i = 0; i < allTabs.length; i++) {
    if (allTabs[i].getId() === activeTab.getId()) {
      activeTabIndex = i;
    }
  }

  // Update the user's selected tab if there is a valid next tab.
  const nextTabIndex = activeTabIndex + 1;
  if (nextTabIndex < allTabs.length) {
    doc.setActiveTab(allTabs[nextTabIndex].getId());
  }
}