התוכן של כרטיסייה במסמך Google Docs. התג Body עשוי להכיל את הרכיבים List, Paragraph, Table ו-Table. מידע נוסף על מבנה המסמך זמין במדריך להרחבת Google Docs.
התג Body בדרך כלל מכיל את כל התוכן של הכרטיסייה, חוץ מהתגים Header, Footer וכל רכיבי Footnote.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a paragraph and a page break to the tab's body section directly. body.appendParagraph('A paragraph.'); body.appendPageBreak();
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
append | Horizontal | יוצרת Horizontal חדש ומצרפת אותו. |
append | Inline | יוצר ומצרף Inline חדש מבלוב התמונה שצוין. |
append | Inline | הוספה של Inline שצוין. |
append | List | הוספה של List שצוין. |
append | List | יוצרת ומצרפת רכיב List חדש שמכיל את תוכן הטקסט שצוין. |
append | Page | יוצרת Page חדש ומצרפת אותו. |
append | Page | הוספה של Page שצוין. |
append | Paragraph | הוספה של Paragraph שצוין. |
append | Paragraph | יוצרת ומצרפת רכיב Paragraph חדש שמכיל את תוכן הטקסט שצוין. |
append | Table | יוצרת Table חדש ומצרפת אותו. |
append | Table | מוסיפה Table חדש שמכיל Table לכל ערך מחרוזת שצוין. |
append | Table | הוספה של Table שצוין. |
clear() | Body | מחיקת התוכן של הרכיב. |
copy() | Body | מחזירה עותק מנותק ועמוק של הרכיב הנוכחי. |
edit | Text | מקבלים גרסה Text של הרכיב הנוכחי לצורך עריכה. |
find | Range | מחפש בתוכן של הרכיב צאצא מסוג מסוים. |
find | Range | הפונקציה מחפשת בתוכן של הרכיב צאצא מסוג מסוים, החל מRange שצוין. |
find | Range | מחפשת בתוכן של הרכיב את תבנית הטקסט שצוינה באמצעות ביטויים רגולריים. |
find | Range | מחפש בתוכן של הרכיב את תבנית הטקסט שצוינה, החל מתוצאת חיפוש נתונה. |
get | Object | מאחזר את המאפיינים של האלמנט. |
get | Element | מאחזר את רכיב הצאצא באינדקס הצאצא שצוין. |
get | Integer | מאחזר את אינדקס הצאצא של רכיב הצאצא שצוין. |
get | Object | הפונקציה מאחזרת את קבוצת המאפיינים של Paragraph שצוין. |
get | Inline | מאחזר את כל ה-Inline שמופיעים בקטע. |
get | List | מאחזר את כל ה-List שמופיעים בקטע. |
get | Number|null | הפונקציה מאחזרת את השוליים התחתונים, בנקודות. |
get | Number|null | מאחזרת את השוליים השמאליים, בנקודות. |
get | Number|null | מאחזר את השוליים הימניים. |
get | Number|null | הפונקציה מחזירה את השוליים העליונים. |
get | Integer | מאחזר את מספר הילדים. |
get | Number|null | מאחזר את גובה הדף, בנקודות. |
get | Number|null | מאחזר את רוחב הדף, בנקודות. |
get | Paragraph[]|null | מאחזר את כל ה-Paragraphs שמופיעים בקטע (כולל List). |
get | Container | מאחזר את אלמנט ההורה של האלמנט. |
get | Table[]|null | מאחזר את כל ה-Tables שמופיעים בקטע. |
get | String | מאחזרת את התוכן של הרכיב כמחרוזת טקסט. |
get | Text | מקבל את יישור הטקסט. |
get | Element | אחזור Element של הרכיב. |
insert | Horizontal | יוצרת ומכניסה אובייקט Horizontal חדש באינדקס שצוין. |
insert | Inline | יוצרת ומכניסה Inline מבלוב התמונה שצוין, באינדקס שצוין. |
insert | Inline | הפונקציה מוסיפה את Inline שצוין באינדקס שצוין. |
insert | List | הפונקציה מוסיפה את List שצוין באינדקס שצוין. |
insert | List | יוצרת ומכניסה List חדש באינדקס שצוין, שמכיל את תוכן הטקסט שצוין. |
insert | Page | יוצרת ומכניסה אובייקט Page חדש באינדקס שצוין. |
insert | Page | הפונקציה מוסיפה את Page שצוין באינדקס שצוין. |
insert | Paragraph | הפונקציה מוסיפה את Paragraph שצוין באינדקס שצוין. |
insert | Paragraph | יוצרת ומכניסה Paragraph חדש באינדקס שצוין, שמכיל את תוכן הטקסט שצוין. |
insert | Table | יוצרת ומכניסה אובייקט Table חדש באינדקס שצוין. |
insert | Table | הפונקציה יוצרת תא חדש Table שמכיל את התאים שצוינו, ומכניסה אותו לאינדקס שצוין. |
insert | Table | הפונקציה מוסיפה את Table שצוין באינדקס שצוין. |
remove | Body | הסרת רכיב הבן שצוין. |
replace | Element | הפונקציה מחליפה את כל המופעים של תבנית טקסט נתונה במחרוזת חלופית נתונה, באמצעות ביטויים רגולריים. |
set | Body | הגדרת המאפיינים של האלמנט. |
set | Body | הגדרת המאפיינים של Paragraph שצוין. |
set | Body | מגדיר את השוליים התחתונים, בנקודות. |
set | Body | הגדרה של השוליים השמאליים, בנקודות. |
set | Body | מגדיר את השוליים הימניים, בנקודות. |
set | Body | הגדרת השוליים העליונים. |
set | Body | הגדרת גובה הדף, בנקודות. |
set | Body | הגדרה של רוחב הדף, בנקודות. |
set | Body | הגדרת התוכן כטקסט פשוט. |
set | Body | הגדרת יישור הטקסט. |
תיעוד מפורט
append Horizontal Rule()
יוצרת Horizontal חדש ומצרפת אותו.
התג Horizontal ייכלל בתג Paragraph חדש.
חזרה
Horizontal — הקו האופקי החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Image(image)
יוצר ומצרף Inline חדש מבלוב התמונה שצוין.
התמונה תופיע בתוך תג Paragraph חדש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
image | Blob | נתוני התמונה. |
חזרה
Inline – התמונה שצורפה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Image(image)
הוספה של Inline שצוין.
התג Inline ייכלל בתג Paragraph חדש.
משתמשים בגרסה הזו של append כשמצרפים עותק של Inline קיים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
image | Inline | נתוני התמונה. |
חזרה
Inline – התמונה שצורפה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append List Item(listItem)
הוספה של List שצוין.
משתמשים בגרסה הזו של append כשמצרפים עותק של List קיים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
list | List | הפריט ברשימה שרוצים לצרף. |
חזרה
List — הפריט שנוסף לרשימה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append List Item(text)
יוצרת ומצרפת רכיב List חדש שמכיל את תוכן הטקסט שצוין.
פריטים עוקבים ברשימה מתווספים כחלק מאותה רשימה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | String | תוכן הטקסט של הפריט ברשימה. |
חזרה
List — הפריט החדש ברשימה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Page Break()
append Page Break(pageBreak)
הוספה של Page שצוין.
התג Page ייכלל בתג Paragraph חדש.
משתמשים בגרסה הזו של append כשמצרפים עותק של Page קיים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
page | Page | מעבר הדף שרוצים לצרף. |
חזרה
Page — מעבר הדף שנוסף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Paragraph(paragraph)
הוספה של Paragraph שצוין.
משתמשים בגרסה הזו של append כשמצרפים עותק של Paragraph קיים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
paragraph | Paragraph | הפסקה שרוצים לצרף. |
חזרה
Paragraph – הפסקה שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Paragraph(text)
יוצרת ומצרפת רכיב Paragraph חדש שמכיל את תוכן הטקסט שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | String | תוכן הטקסט של הפסקה. |
חזרה
Paragraph — הפיסקה החדשה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Table()
יוצרת Table חדש ומצרפת אותו.
בשיטה הזו יצורף גם פסק ריק אחרי הטבלה, כי מסמכי Google Docs לא יכולים להסתיים בטבלה.
חזרה
Table — הטבלה החדשה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Table(cells)
מוסיפה Table חדש שמכיל Table לכל ערך מחרוזת שצוין.
בשיטה הזו יצורף גם פסק ריק אחרי הטבלה, כי מסמכי Google Docs לא יכולים להסתיים בטבלה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
cells | String[][] | תוכן הטקסט של תאי הטבלה שרוצים להוסיף לטבלה החדשה. |
חזרה
Table — הטבלה שצורפה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
append Table(table)
הוספה של Table שצוין.
משתמשים בגרסה הזו של append כשמצרפים עותק של Table קיים.
בשיטה הזו יצורף גם פסק ריק אחרי הטבלה, כי מסמכי Google Docs לא יכולים להסתיים בטבלה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
table | Table | הטבלה שאליה רוצים לצרף. |
חזרה
Table — הטבלה שצורפה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
clear()
copy()
מחזירה עותק מנותק ועמוק של הרכיב הנוכחי.
כל רכיבי הצאצא שקיימים ברכיב מועתקים גם הם. לאלמנט החדש אין אלמנט אב.
חזרה
Body – העותק החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
edit As Text()
מקבלים גרסה Text של הרכיב הנוכחי לצורך עריכה.
משתמשים ב-edit כדי לשנות את תוכן הרכיבים כטקסט עשיר. במצב edit המערכת מתעלמת מאלמנטים שהם לא טקסט (כמו Inline ו-Horizontal).
רכיבי צאצא שכלולים באופן מלא בטווח טקסט שנמחק מוסרים מהרכיב.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, 'An editAsText sample.'); body.insertHorizontalRule(0); body.insertParagraph(0, 'An example.'); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
חזרה
Text – גרסת טקסט של הרכיב הנוכחי
find Element(elementType)
מחפש בתוכן של הרכיב צאצא מסוג מסוים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
element | Element | סוג הרכיב לחיפוש. |
חזרה
Range — תוצאת חיפוש שמציינת את המיקום של רכיב החיפוש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
find Element(elementType, from)
הפונקציה מחפשת בתוכן של הרכיב צאצא מסוג מסוים, החל מRange שצוין.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Define the search parameters. let searchResult = null; // Search until the paragraph is found. while ( (searchResult = body.findElement( DocumentApp.ElementType.PARAGRAPH, searchResult, ))) { const par = searchResult.getElement().asParagraph(); if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) { // Found one, update and stop. par.setText('This is the first header.'); break; } }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
element | Element | סוג הרכיב לחיפוש. |
from | Range | תוצאת החיפוש שממנה מתחילים את החיפוש. |
חזרה
Range — תוצאת חיפוש שמציינת את המיקום הבא של רכיב החיפוש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
find Text(searchPattern)
מחפשת בתוכן של הרכיב את תבנית הטקסט שצוינה באמצעות ביטויים רגולריים.
קבוצת משנה של תכונות הביטוי הרגולרי של JavaScript לא נתמכות באופן מלא, כמו קבוצות לכידה ומשני מצב.
תבנית הביטוי הרגולרי שצוינה מותאמת באופן עצמאי לכל בלוק טקסט שנכלל ברכיב הנוכחי.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
search | String | התבנית לחיפוש |
חזרה
Range – תוצאת חיפוש שמציינת את המיקום של טקסט החיפוש, או null אם אין התאמה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
find Text(searchPattern, from)
מחפש בתוכן של הרכיב את תבנית הטקסט שצוינה, החל מתוצאת חיפוש נתונה.
קבוצת משנה של תכונות הביטוי הרגולרי של JavaScript לא נתמכות באופן מלא, כמו קבוצות לכידה ומשני מצב.
תבנית הביטוי הרגולרי שצוינה מותאמת באופן עצמאי לכל בלוק טקסט שנכלל ברכיב הנוכחי.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
search | String | התבנית לחיפוש |
from | Range | תוצאת החיפוש שממנה רוצים לחפש |
חזרה
Range — תוצאת חיפוש שמציינת את המיקום הבא של טקסט החיפוש, או null אם אין התאמה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Attributes()
מאחזר את המאפיינים של האלמנט.
התוצאה היא אובייקט שמכיל מאפיין לכל מאפיין תקין של רכיב, כאשר כל שם מאפיין תואם לפריט בספירה Document.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Append a styled paragraph. const par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. const atts = par.getAttributes(); // Log the paragraph attributes. for (const att in atts) { Logger.log(`${att}:${atts[att]}`); }
חזרה
Object – מאפייני הרכיב.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Child(childIndex)
מאחזר את רכיב הצאצא באינדקס הצאצא שצוין.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. const firstChild = body.getChild(0); // If it's a paragraph, set its contents. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { firstChild.asParagraph().setText('This is the first paragraph.'); }
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס של רכיב הצאצא לאחזור. |
חזרה
Element – רכיב הצאצא באינדקס שצוין.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Child Index(child)
מאחזר את אינדקס הצאצא של רכיב הצאצא שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Element | רכיב הצאצא שעבורו רוצים לאחזר את האינדקס. |
חזרה
Integer — אינדקס הילד.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Heading Attributes(paragraphHeading)
הפונקציה מאחזרת את קבוצת המאפיינים של Paragraph שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
paragraph | Paragraph | הכותרת שצריך לאחזר את המאפיינים שלה. |
חזרה
Object – מיפוי של המאפיינים והערכים הנוכחיים שלהם.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Images()
מאחזר את כל ה-Inline שמופיעים בקטע.
חזרה
Inline — תמונות של החלק.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get List Items()
מאחזר את כל ה-List שמופיעים בקטע.
חזרה
List — הפריטים ברשימת הקטעים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Margin Bottom()
הפונקציה מאחזרת את השוליים התחתונים, בנקודות.
חזרה
Number|null – השוליים התחתונים, בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Margin Left()
מאחזרת את השוליים השמאליים, בנקודות.
חזרה
Number|null — השוליים השמאליים, בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Margin Right()
מאחזר את השוליים הימניים.
חזרה
Number|null – השוליים הימניים, בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Margin Top()
מחזירה את השוליים העליונים.
חזרה
Number|null — השוליים העליונים, בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Num Children()
מאחזר את מספר הילדים.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Log the number of elements in the tab. Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);
חזרה
Integer – מספר הילדים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Page Height()
מאחזר את גובה הדף, בנקודות.
חזרה
Number|null – גובה הדף, בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Page Width()
מאחזר את רוחב הדף, בנקודות.
חזרה
Number|null — רוחב הדף, בנקודות.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Paragraphs()
מאחזר את כל ה-Paragraphs שמופיעים בקטע (כולל List).
חזרה
Paragraph[]|null – פסקאות הקטע.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Parent()
מאחזר את אלמנט ההורה של האלמנט.
רכיב ההורה מכיל את הרכיב הנוכחי.
חזרה
Container – רכיב ההורה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Tables()
get Text()
מאחזרת את התוכן של הרכיב כמחרוזת טקסט.
חזרה
String – התוכן של הרכיב כמחרוזת טקסט
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Text Alignment()
מקבל את יישור הטקסט. סוגי היישור הזמינים הם Document, Document ו-Document.
חזרה
Text – סוג יישור הטקסט, או null אם הטקסט מכיל כמה סוגים של יישור טקסט או אם יישור הטקסט לא הוגדר אף פעם
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Type()
אחזור Element של הרכיב.
משתמשים ב-get כדי לקבוע את הסוג המדויק של רכיב נתון.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Obtain the first element in the active tab's body. const firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
חזרה
Element – סוג הרכיב.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Horizontal Rule(childIndex)
יוצרת ומכניסה אובייקט Horizontal חדש באינדקס שצוין.
התג Horizontal ייכלל בתג Paragraph חדש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו רוצים להוסיף את הרכיב. |
חזרה
Horizontal — הקו האופקי החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Image(childIndex, image)
יוצרת ומכניסה Inline מבלוב התמונה שצוין, באינדקס שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו רוצים להוסיף את הרכיב. |
image | Blob | נתוני התמונה. |
חזרה
Inline — התמונה המוטבעת שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Image(childIndex, image)
הפונקציה מוסיפה את Inline שצוין באינדקס שצוין.
התמונה תופיע בתוך תג Paragraph חדש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו רוצים להוסיף את הרכיב. |
image | Inline | התמונה להוספה. |
חזרה
Inline — התמונה המוטבעת שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert List Item(childIndex, listItem)
הפונקציה מוסיפה את List שצוין באינדקס שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו יתווסף הערך. |
list | List | הפריט ברשימה שרוצים להוסיף. |
חזרה
List – הפריט שנוסף לרשימה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert List Item(childIndex, text)
יוצרת ומכניסה List חדש באינדקס שצוין, שמכיל את תוכן הטקסט שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו יתווסף הערך. |
text | String | תוכן הטקסט של הפריט ברשימה. |
חזרה
List — הפריט החדש ברשימה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Page Break(childIndex)
יוצרת ומכניסה אובייקט Page חדש באינדקס שצוין.
התג Page ייכלל בתג Paragraph חדש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו רוצים להוסיף את הרכיב. |
חזרה
Page — מעבר הדף החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Page Break(childIndex, pageBreak)
הפונקציה מוסיפה את Page שצוין באינדקס שצוין.
התג Page ייכלל בתג Paragraph חדש.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו רוצים להוסיף את הרכיב. |
page | Page | מעבר הדף שרוצים להוסיף. |
חזרה
Page – מעבר הדף שנוסף.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Paragraph(childIndex, paragraph)
הפונקציה מוסיפה את Paragraph שצוין באינדקס שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו יתווסף הערך. |
paragraph | Paragraph | הפסקה שרוצים להוסיף. |
חזרה
Paragraph – הפיסקה שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Paragraph(childIndex, text)
יוצרת ומכניסה Paragraph חדש באינדקס שצוין, שמכיל את תוכן הטקסט שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו יתווסף הערך. |
text | String | תוכן הטקסט של הפסקה. |
חזרה
Paragraph — הפיסקה החדשה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Table(childIndex)
יוצרת ומכניסה אובייקט Table חדש באינדקס שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו יתווסף הערך. |
חזרה
Table — הטבלה החדשה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Table(childIndex, cells)
הפונקציה יוצרת תא חדש Table שמכיל את התאים שצוינו, ומכניסה אותו לאינדקס שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו יתווסף הערך. |
cells | String[][] | תוכן הטקסט של תאי הטבלה שרוצים להוסיף לטבלה החדשה. |
חזרה
Table — הטבלה החדשה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Table(childIndex, table)
הפונקציה מוסיפה את Table שצוין באינדקס שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
child | Integer | האינדקס שבו יתווסף הערך. |
table | Table | הטבלה שרוצים להוסיף. |
חזרה
Table – הטבלה שנוספה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
remove Child(child)
replace Text(searchPattern, replacement)
הפונקציה מחליפה את כל המופעים של תבנית טקסט נתונה במחרוזת חלופית נתונה, באמצעות ביטויים רגולריים.
תבנית החיפוש מועברת כמחרוזת, ולא כאובייקט ביטוי רגולרי של JavaScript. לכן, צריך להשתמש בתו בריחה (escape) לכל קו נטוי הפוך בתבנית.
השיטה הזו משתמשת בספריית הביטויים הרגולריים RE2 של Google, שמגבילה את התחביר הנתמך.
תבנית הביטוי הרגולרי שצוינה מותאמת באופן עצמאי לכל בלוק טקסט שנכלל ברכיב הנוכחי.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText('^.*Apps ?Script.*$', 'Apps Script');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
search | String | תבנית הביטוי הרגולרי לחיפוש |
replacement | String | הטקסט שבו רוצים להשתמש להחלפה |
חזרה
Element – הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Attributes(attributes)
הגדרת המאפיינים של האלמנט.
פרמטר המאפיינים שצוין צריך להיות אובייקט שבו כל שם מאפיין הוא פריט בספירה Document וכל ערך מאפיין הוא הערך החדש שיוחל.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Define a custom paragraph style. const style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. const par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
attributes | Object | המאפיינים של הרכיב. |
חזרה
Body – הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Heading Attributes(paragraphHeading, attributes)
הגדרת המאפיינים של Paragraph שצוין.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
paragraph | Paragraph | הכותרת שצריך להגדיר את המאפיינים שלה. |
attributes | Object | מיפוי של מאפיינים והערכים שצריך להגדיר להם. |
חזרה
Body – הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Margin Bottom(marginBottom)
מגדיר את השוליים התחתונים, בנקודות.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
margin | Number | השוליים התחתונים, בנקודות. |
חזרה
Body – הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
set Margin Left(marginLeft)
set Margin Right(marginRight)
set Margin Top(marginTop)
set Page Height(pageHeight)
set Page Width(pageWidth)
set Text(text)
set Text Alignment(textAlignment)
הגדרת יישור הטקסט. סוגי היישור הזמינים הם Document, Document ו-Document.
// Make the entire first paragraph in the active tab be superscript. const documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); const text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | Text | סוג יישור הטקסט שרוצים להחיל |
חזרה
Body – הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents