רכיב שמייצג אזור של טקסט עשיר. כל הטקסט ב-Document
נמצא ברכיבי Text
.
רכיב Text
יכול להופיע בתוך רכיב Equation
, Equation
, List
או Paragraph
, אבל הוא לא יכול להכיל רכיב אחר. למידע נוסף על מבנה המסמך, קראו את המדריך להרחבת Google Docs.
// Gets the body contents of the active tab. const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Use editAsText to obtain a single text element containing // all the characters in the tab. const text = body.editAsText(); // Insert text at the beginning of the tab. text.insertText(0, 'Inserted text.\n'); // Insert text at the end of the tab. text.appendText('\nAppended text.'); // Make the first half of the tab blue. text.setForegroundColor(0, text.getText().length / 2, '#00FFFF');
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
append | Text | הוספת הטקסט שצוין לסוף אזור הטקסט הזה. |
copy() | Text | הפונקציה מחזירה עותק מנותק ומעמיק של הרכיב הנוכחי. |
delete | Text | מחיקת טווח טקסט. |
edit | Text | הצגת גרסת Text של הרכיב הנוכחי לצורך עריכה. |
find | Range | חיפוש דפוס הטקסט שצוין בתוכן של האלמנט באמצעות ביטויים רגולריים. |
find | Range | חיפוש של דפוס הטקסט שצוין בתוכן הרכיב, החל מתוצאת חיפוש נתונה. |
get | Object | אחזור המאפיינים של האלמנט. |
get | Object | אחזור המאפיינים במרווח התווים שצוין. |
get | String | אחזור ההגדרה של צבע הרקע. |
get | String | אחזור של צבע הרקע במרווח התווים שצוין. |
get | String | אחזור ההגדרה של משפחת הגופנים. |
get | String | אחזור של משפחת הגופנים במרווח התווים שצוין. |
get | Number | אחזור ההגדרה של גודל הגופן. |
get | Number | אחזור גודל הגופן במרווח התווים שצוין. |
get | String | אחזור ההגדרה של צבע החזית. |
get | String | אחזור של צבע החזית במרווח התווים שצוין. |
get | String | אחזור כתובת ה-URL של הקישור. |
get | String | הפונקציה מאחזרת את כתובת ה-URL של הקישור במרווח התווים שצוין. |
get | Element | אחזור הרכיב הבא של הרכיב. |
get | Container | אחזור של רכיב ההורה של האלמנט. |
get | Element | אחזור של רכיב האח הקודם של הרכיב. |
get | String | אחזור התוכן של הרכיב כמחרוזת טקסט. |
get | Text | הפונקציה מקבלת את יישור הטקסט. |
get | Text | הפונקציה מקבלת את יישור הטקסט של תו יחיד. |
get | Integer[] | הפונקציה מאחזרת את קבוצת אינדקסי הטקסט שתואמים לתחילת רצפי עיצוב טקסט נפרדים. |
get | Element | אחזור הערך של Element ברכיב. |
insert | Text | הוספת הטקסט שצוין בהיסט התווים הנתון. |
is | Boolean | הפונקציה קובעת אם הרכיב נמצא בסוף ה-Document . |
is | Boolean | אחזור ההגדרה של הגופן המודגש. |
is | Boolean | אחזור ההגדרה של הגופן מודגש בהיסט התווים שצוין. |
is | Boolean | אחזור ההגדרה של הגופן הנטוי. |
is | Boolean | אחזור ההגדרה של הגופן הנטוי בהיסט התווים שצוין. |
is | Boolean | אחזור ההגדרה של קו המחיקה. |
is | Boolean | אחזור ההגדרה של קו המחיקה בהיסט התווים שצוין. |
is | Boolean | אחזור ההגדרה של קו התחתון. |
is | Boolean | אחזור ההגדרה של קו תחתון בהיסט התווים שצוין. |
merge() | Text | מיזוג הרכיב עם האח/ה הקודם/ה מאותו סוג. |
remove | Text | הסרת הרכיב מהרכיב ההורה שלו. |
replace | Element | מחליפה את כל המופעים של דפוס טקסט נתון במחרוזת החלפה נתונה, באמצעות ביטויים רגולריים. |
set | Text | מחילה את המאפיינים שצוינו על טווח התווים הנתון. |
set | Text | הגדרת המאפיינים של האלמנט. |
set | Text | הגדרת צבע הרקע של טווח התווים שצוין. |
set | Text | הגדרת צבע הרקע. |
set | Text | הגדרת העיצוב המודגש. |
set | Text | הגדרת הגופן מודגש לטווח התווים שצוין. |
set | Text | הגדרת משפחת הגופנים לטווח התווים שצוין. |
set | Text | הגדרת משפחת הגופנים. |
set | Text | הגדרת גודל הגופן של טווח התווים שצוין. |
set | Text | הגדרת גודל הגופן. |
set | Text | הגדרת צבע החזית של טווח התווים שצוין. |
set | Text | הגדרת צבע החזית. |
set | Text | הגדרת הגופן הנטוי. |
set | Text | הגדרת הגופן הנטוי לטווח התווים שצוין. |
set | Text | הגדרת כתובת ה-URL של הקישור לטווח התווים שצוין. |
set | Text | הגדרת כתובת ה-URL של הקישור. |
set | Text | הגדרת ההגדרה של קו המחיקה. |
set | Text | הגדרת ההגדרה של קו חוצה לטווח התווים שצוין. |
set | Text | הגדרת תוכן הטקסט. |
set | Text | הגדרת היישור של הטקסט בטווח תווים נתון. |
set | Text | הגדרת יישור הטקסט. |
set | Text | הגדרת ההגדרה של קו תחתון. |
set | Text | הגדרת ההגדרה של קו תחתון לטווח התווים שצוין. |
מסמכים מפורטים
append Text(text)
הוספת הטקסט שצוין לסוף אזור הטקסט הזה.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Adds the text, 'Sample body text,' to the end of the tab body. const text = body.editAsText().appendText('Sample body text');
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | String | הטקסט שרוצים לצרף. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
copy()
הפונקציה מחזירה עותק מנותק ומעמיק של הרכיב הנוכחי.
כל אלמנטי הצאצא שנמצאים באלמנט יועתקו גם כן. לאלמנט החדש אין הורה.
חזרה
Text
– העותק החדש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
delete Text(startOffset, endOffsetInclusive)
מחיקת טווח טקסט.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Deletes the first 10 characters in the body. const text = body.editAsText().deleteText(0, 9);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | הזזת התווים של התו הראשון למחיקה. |
end | Integer | הזזת התו של התו האחרון למחיקה. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
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 Text(searchPattern)
חיפוש דפוס הטקסט שצוין בתוכן של האלמנט באמצעות ביטויים רגולריים.
אין תמיכה מלאה בקבוצת משנה של תכונות הביטויים הרגולריים של JavaScript, כמו קבוצות תיעוד (capture groups) ומשתני שינוי מצב (mode modifiers).
תבנית הביטוי הרגולרי שצוינה מותאמת בנפרד לכל בלוק טקסט שמכיל את הרכיב הנוכחי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
search | String | הדפוס שרוצים לחפש |
חזרה
Range
– תוצאת חיפוש שמציינת את המיקום של טקסט החיפוש, או null אם אין התאמה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
find Text(searchPattern, from)
חיפוש של דפוס הטקסט שצוין בתוכן הרכיב, החל מתוצאת חיפוש נתונה.
אין תמיכה מלאה בקבוצת משנה של תכונות הביטויים הרגולריים של JavaScript, כמו קבוצות תיעוד (capture groups) ומשתני שינוי מצב (mode modifiers).
תבנית הביטוי הרגולרי שצוינה מותאמת בנפרד לכל בלוק טקסט שמכיל את הרכיב הנוכחי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
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 Attributes(offset)
אחזור המאפיינים במרווח התווים שצוין.
התוצאה היא אובייקט שמכיל מאפיין לכל מאפיין טקסט תקין, כאשר כל שם מאפיין תואם לפריט בספירה Document
.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Declares style attributes. const style = {}; style[DocumentApp.Attribute.BOLD] = true; style[DocumentApp.Attribute.ITALIC] = true; style[DocumentApp.Attribute.FONT_SIZE] = 29; // Sets the style attributes to the tab's body. const text = body.editAsText(); text.setAttributes(style); // Gets the style attributes applied to the eleventh character in the // body and logs them to the console. const attributes = text.getAttributes(10); console.log(attributes);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
Object
– המאפיינים של האלמנט.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Background Color()
אחזור ההגדרה של צבע הרקע.
חזרה
String
– צבע הרקע, בפורמט של סימון CSS (כמו '#ffffff'
), או null אם האלמנט מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Background Color(offset)
אחזור של צבע הרקע במרווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the background color of the first 3 characters in the body. const text = body.editAsText().setBackgroundColor(0, 2, '#FFC0CB'); // Gets the background color of the first character in the body. const backgroundColor = text.getBackgroundColor(0); // Logs the background color to the console. console.log(backgroundColor);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
String
— צבע הרקע, בפורמט של סימון CSS (כמו '#ffffff'
).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Font Family()
אחזור ההגדרה של משפחת הגופנים. השם יכול להיות כל גופן מתפריט הגופנים ב-Docs או ב-Google Fonts, והוא תלוי אותיות רישיות. השיטות get
ו-set
משתמשות עכשיו בשמות מחרוזות לגופנים במקום ב-enum
. למרות שה-enum הזה הוצא משימוש, הוא יישאר זמין לצורך תאימות עם סקריפטים ישנים יותר.Font
חזרה
String
– משפחת הגופן, או null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Font Family(offset)
אחזור של משפחת הגופנים במרווח התווים שצוין. השם יכול להיות כל גופן מתפריט הגופנים ב-Docs או ב-Google Fonts, והוא תלוי אותיות רישיות. השיטות get
ו-set
משתמשות עכשיו בשמות מחרוזות לגופנים במקום במערך הערכים
. למרות שה-enum הזה הוצא משימוש, הוא יישאר זמין לצורך תאימות עם סקריפטים ישנים יותר.
Font
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the font of the first 16 characters to Impact. const text = body.editAsText().setFontFamily(0, 15, 'Impact'); // Gets the font family of the 16th character in the tab body. const fontFamily = text.getFontFamily(15); // Logs the font family to the console. console.log(fontFamily);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
String
— משפחת הגופנים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Font Size()
אחזור ההגדרה של גודל הגופן.
חזרה
Number
– גודל הגופן, או null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Font Size(offset)
אחזור גודל הגופן במרווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the font size of the first 13 characters to 15. const text = body.editAsText().setFontSize(0, 12, 15); // Gets the font size of the first character. const fontSize = text.getFontSize(0); // Logs the font size to the console. console.log(fontSize);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
Number
— גודל הגופן.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Foreground Color()
אחזור ההגדרה של צבע החזית.
חזרה
String
– צבע החזית, בפורמט של סימון CSS (כמו '#ffffff'
), או null אם האלמנט מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Foreground Color(offset)
אחזור של צבע החזית במרווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the foreground color of the first 3 characters in the tab body. const text = body.editAsText().setForegroundColor(0, 2, '#0000FF'); // Gets the foreground color of the first character in the tab body. const foregroundColor = text.getForegroundColor(0); // Logs the foreground color to the console. console.log(foregroundColor);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
String
— צבע החזית, בפורמט של סימון CSS (כמו '#ffffff'
).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Link Url()
אחזור כתובת ה-URL של הקישור.
חזרה
String
– כתובת ה-URL של הקישור, או null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Link Url(offset)
הפונקציה מאחזרת את כתובת ה-URL של הקישור במרווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Applies a link to the first 10 characters in the body. const text = body.editAsText().setLinkUrl(0, 9, 'https://www.example.com/'); // Gets the URL of the link from the first character. const link = text.getLinkUrl(0); // Logs the link URL to the console. console.log(link);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
String
– כתובת ה-URL של הקישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Next Sibling()
אחזור הרכיב הבא של הרכיב.
לרכיב האח הבא יש אותו הורה והוא מופיע אחרי הרכיב הנוכחי.
חזרה
Element
– רכיב האח הבא.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
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 Previous Sibling()
אחזור של רכיב האח הקודם של הרכיב.
לרכיב האח הקודם יש אותו הורה והוא מופיע לפני הרכיב הנוכחי.
חזרה
Element
— רכיב האח/ה הקודם.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
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 Text Alignment(offset)
הפונקציה מקבלת את יישור הטקסט של תו יחיד. סוגי ההתאמה הזמינים הם Document
, Document
ו-Document
.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the text alignment of the tab's body to NORMAL. const text = body.editAsText().setTextAlignment(DocumentApp.TextAlignment.NORMAL); // Gets the text alignment of the ninth character. const alignment = text.getTextAlignment(8); // Logs the text alignment to the console. console.log(alignment.toString());
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
Text
– סוג היישור של הטקסט, או null
אם היישור של הטקסט מעולם לא הוגדר.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Text Attribute Indices()
הפונקציה מאחזרת את קבוצת אינדקסי הטקסט שתואמים לתחילת רצפי עיצוב טקסט נפרדים.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the text indices at which text formatting changes. const indices = body.editAsText().getTextAttributeIndices(); // Logs the indices to the console. console.log(indices.toString());
חזרה
Integer[]
— קבוצת אינדקסי הטקסט שבהם עיצוב הטקסט משתנה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
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 Text(offset, text)
הוספת הטקסט שצוין בהיסט התווים הנתון.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Inserts the text, 'Sample inserted text', at the start of the body content. const text = body.editAsText().insertText(0, 'Sample inserted text');
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזה של התווים שבה צריך להוסיף את הטקסט. |
text | String | הטקסט שרוצים להוסיף. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is At Document End()
הפונקציה קובעת אם הרכיב נמצא בסוף ה-Document
.
חזרה
Boolean
— אם הרכיב נמצא בסוף הכרטיסייה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Bold()
אחזור ההגדרה של הגופן המודגש.
חזרה
Boolean
– אם הטקסט מודגש, או null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Bold(offset)
אחזור ההגדרה של הגופן מודגש בהיסט התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Bolds the first 4 characters in the tab body. const text = body.editAsText().setBold(0, 3, true); // Gets whether or not the text is bold. const bold = text.editAsText().isBold(0); // Logs the text's bold setting to the console console.log(bold);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
Boolean
— ההגדרה של הגופן המודגש.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Italic()
אחזור ההגדרה של הגופן הנטוי.
חזרה
Boolean
– אם הטקסט נטוי, או null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Italic(offset)
אחזור ההגדרה של הגופן הנטוי בהיסט התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the first 13 characters of the tab body to italic. const text = body.editAsText().setItalic(0, 12, true); // Gets whether the fifth character in the tab body is set to // italic and logs it to the console. const italic = text.isItalic(4); console.log(italic);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
Boolean
— הגדרת הגופן הנטוי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Strikethrough()
אחזור ההגדרה של קו המחיקה.
חזרה
Boolean
– אם הטקסט מסומן בקו חוצה, או null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Strikethrough(offset)
אחזור ההגדרה של קו המחיקה בהיסט התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the first 17 characters of the tab body to strikethrough. const text = body.editAsText().setStrikethrough(0, 16, true); // Gets whether the first character in the tab body is set to // strikethrough and logs it to the console. const strikethrough = text.isStrikethrough(0); console.log(strikethrough);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
Boolean
— ההגדרה של הקו החוצה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Underline()
אחזור ההגדרה של קו התחתון.
חזרה
Boolean
– אם הטקסט מודגש או null אם הרכיב מכיל כמה ערכים למאפיין הזה
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is Underline(offset)
אחזור ההגדרה של קו תחתון בהיסט התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the first 13 characters of the tab body to underline. const text = body.editAsText().setUnderline(0, 12, false); // Gets whether the first character in the tab body is set to // underline and logs it to the console const underline = text.editAsText().isUnderline(0); console.log(underline);
פרמטרים
שם | סוג | תיאור |
---|---|---|
offset | Integer | הזזת התווים. |
חזרה
Boolean
— ההגדרה של קו התחתון.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
merge()
מיזוג הרכיב עם האח/ה הקודם/ה מאותו סוג.
אפשר למזג רק רכיבים מאותו Element
. כל רכיבי הצאצאים שמכיל הרכיב הנוכחי מועברים לרכיב האח הקודם.
הרכיב הנוכחי יוסר מהמסמך.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. const par1 = body.appendParagraph('Paragraph 1.'); const par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. const cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'], ]; // Build a table from the array. const table = body.appendTable(cells); // Get the first row in the table. const row = table.getRow(0); // Get the two cells in this row. const cell1 = row.getCell(0); const cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. const merged = cell2.merge();
חזרה
Text
– הרכיב הממוזג.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
remove From Parent()
הסרת הרכיב מהרכיב ההורה שלו.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Remove all images in the active tab's body. const imgs = body.getImages(); for (let i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
חזרה
Text
– הרכיב שהוסרה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replace Text(searchPattern, replacement)
מחליפה את כל המופעים של דפוס טקסט נתון במחרוזת החלפה נתונה, באמצעות ביטויים רגולריים.
דפוס החיפוש מועבר כמחרוזת, ולא כאובייקט של ביטוי רגולרי ב-JavaScript. לכן צריך להשתמש בתו בריחה (escape) לפני כל קו נטוי לאחור בתבנית.
השיטות האלה משתמשות בספריית הביטויים הרגולריים של Google, RE2, שמגבילה את התחביר הנתמך.
תבנית הביטוי הרגולרי שצוינה מותאמת בנפרד לכל בלוק טקסט שמכיל את הרכיב הנוכחי.
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(startOffset, endOffsetInclusive, attributes)
מחילה את המאפיינים שצוינו על טווח התווים הנתון.
פרמטר המאפיינים שצוין חייב להיות אובייקט שבו כל שם מאפיין הוא פריט בספירה של Document
וכל ערך מאפיין הוא הערך החדש שרוצים להחיל.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Declares style attributes for font size and font family. const style = {}; style[DocumentApp.Attribute.FONT_SIZE] = 20; style[DocumentApp.Attribute.FONT_FAMILY] = 'Impact'; // Sets the style attributes to the first 9 characters in the tab's body. const text = body.setAttributes(0, 8, style);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
attributes | Object | המאפיינים של האלמנט. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
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 | המאפיינים של האלמנט. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Background Color(startOffset, endOffsetInclusive, color)
הגדרת צבע הרקע של טווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the background color of the first 3 characters in the // tab body to hex color #0000FF. const text = body.editAsText().setBackgroundColor(0, 2, '#0000FF');
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
color | String | צבע הרקע, בפורמט של סימון CSS (כמו '#ffffff' ). |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Background Color(color)
הגדרת צבע הרקע.
פרמטרים
שם | סוג | תיאור |
---|---|---|
color | String | צבע הרקע, בפורמט של סימון CSS (כמו '#ffffff' ) |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Bold(bold)
הגדרת העיצוב המודגש.
פרמטרים
שם | סוג | תיאור |
---|---|---|
bold | Boolean | ההגדרה של הגופן המודגש |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Bold(startOffset, endOffsetInclusive, bold)
הגדרת הגופן מודגש לטווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to bold. const text = body.editAsText().setBold(0, 10, true);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
bold | Boolean | ההגדרה של הגופן המודגש. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Font Family(startOffset, endOffsetInclusive, fontFamilyName)
הגדרת משפחת הגופנים לטווח התווים שצוין. השם יכול להיות כל גופן מהתפריט 'גופן' ב-Docs או מ-Google Fonts, והוא תלוי אותיות רישיות.
שמות גופנים לא מזוהים יופיעו כ-Arial. השיטות get
ו-set
משתמשות עכשיו בשמות מחרוזות לגופנים במקום במערך הערכים
. למרות שה-enum הזה הוצא משימוש, הוא יישאר זמין לצורך תאימות עם סקריפטים ישנים יותר.
Font
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the font of the first 4 characters in the tab's body to Roboto. const text = body.editAsText().setFontFamily(0, 3, 'Roboto');
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
font | String | השם של משפחת הגופנים, מתפריט הגופנים ב-Docs או בגופנים של Google. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Font Family(fontFamilyName)
הגדרת משפחת הגופנים. השם יכול להיות כל גופן מתפריט הגופנים ב-Docs או ב-Google Fonts, והוא תלוי אותיות רישיות. שמות גופנים לא מזוהים יופיעו כ-Arial. השיטות get
ו-set
משתמשות עכשיו בשמות מחרוזות לגופנים במקום במערך הערכים הקבועים
. למרות שה-enum הזה הוצא משימוש, הוא יישאר זמין לצורך תאימות עם סקריפטים ישנים יותר.Font
פרמטרים
שם | סוג | תיאור |
---|---|---|
font | String | שם משפחת הגופנים, מתפריט הגופנים ב-Docs או בגופנים של Google |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Font Size(startOffset, endOffsetInclusive, size)
הגדרת גודל הגופן של טווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the size of the first 11 characters in the tab's body to 12. const text = body.editAsText().setFontSize(0, 10, 12);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
size | Number | גודל הגופן. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Font Size(size)
הגדרת גודל הגופן.
פרמטרים
שם | סוג | תיאור |
---|---|---|
size | Number | גודל הגופן |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Foreground Color(startOffset, endOffsetInclusive, color)
הגדרת צבע החזית של טווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the foreground color of the first 2 characters in the // tab's body to hex color #FF0000. const text = body.editAsText().setForegroundColor(0, 1, '#FF0000'); // Gets the foreground color for the second character in the tab's body. const foregroundColor = text.getForegroundColor(1); // Logs the foreground color to the console. console.log(foregroundColor);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
color | String | צבע החזית, בפורמט של סימון CSS (כמו '#ffffff' ). |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Foreground Color(color)
הגדרת צבע החזית.
פרמטרים
שם | סוג | תיאור |
---|---|---|
color | String | צבע החזית, בפורמט של סימון CSS (כמו '#ffffff' ) |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Italic(italic)
הגדרת הגופן הנטוי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
italic | Boolean | ההגדרה של הטקסט הנטוי |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Italic(startOffset, endOffsetInclusive, italic)
הגדרת הגופן הנטוי לטווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to italic. const text = body.editAsText().setItalic(0, 10, true);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
italic | Boolean | ההגדרה של הגופן הנטוי. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Link Url(startOffset, endOffsetInclusive, url)
הגדרת כתובת ה-URL של הקישור לטווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Applies a link to the first 11 characters in the body. const text = body.editAsText().setLinkUrl(0, 10, 'https://example.com');
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
url | String | כתובת ה-URL של הקישור. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Link Url(url)
הגדרת כתובת ה-URL של הקישור.
פרמטרים
שם | סוג | תיאור |
---|---|---|
url | String | כתובת ה-URL של הקישור |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Strikethrough(strikethrough)
הגדרת ההגדרה של קו המחיקה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
strikethrough | Boolean | ההגדרה של קו חוצה |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Strikethrough(startOffset, endOffsetInclusive, strikethrough)
הגדרת ההגדרה של קו חוצה לטווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to strikethrough. const text = body.editAsText().setStrikethrough(0, 10, true);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
strikethrough | Boolean | ההגדרה של הקו החוצה. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Text(text)
הגדרת תוכן הטקסט.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Replaces the contents of the body with the text, 'New body text.' const text = body.editAsText().setText('New body text.');
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | String | תוכן הטקסט החדש. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Text Alignment(startOffset, endOffsetInclusive, textAlignment)
הגדרת היישור של הטקסט בטווח תווים נתון. סוגי ההתאמה הזמינים הם Document
, Document
ו-Document
.
// Make the first character in the first paragraph of the active tab be // superscript. const documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); const text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(0, 0, DocumentApp.TextAlignment.SUPERSCRIPT);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח התווים. |
end | Integer | היסט הסיום של טווח התווים (כולל). |
text | Text | סוג היישור של הטקסט. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
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 | סוג יישור הטקסט שרוצים להחיל |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Underline(underline)
הגדרת ההגדרה של קו תחתון.
פרמטרים
שם | סוג | תיאור |
---|---|---|
underline | Boolean | הגדרת הקו התחתון |
חזרה
Text
– הרכיב הנוכחי
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Underline(startOffset, endOffsetInclusive, underline)
הגדרת ההגדרה של קו תחתון לטווח התווים שצוין.
// Opens the Docs file by its URL. If you created your script from within a // Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the URL with your own. const doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/DOCUMENT_ID/edit', ); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Sets the first 11 characters in the tab's body to underline. const text = body.editAsText().setUnderline(0, 10, true);
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Integer | היסט ההתחלה של טווח הטקסט. |
end | Integer | ההיסט של סוף טווח הטקסט. |
underline | Boolean | הגדרת הקו התחתון. |
חזרה
Text
– הרכיב הנוכחי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents