Редактирование и оформление текста

Редактируйте и оформляйте текст с помощью текстовых диапазонов , которые представлены типом TextRange . TextRange представляет собой сегмент текста внутри фигуры или ячейки таблицы. Вызов метода getText для фигуры или ячейки таблицы возвращает текстовый диапазон, охватывающий весь текст.

Если вы используете методы, изменяющие способ размещения текста внутри фигуры, любые параметры автоматической подгонки, примененные к фигуре, будут деактивированы.

Используйте диапазоны текста

Диапазон текста имеет два индекса, ограничивающих сегмент текста, охватываемый этим диапазоном: начальный индекс и конечный индекс . Эти индексы определяются с помощью функций getStartIndex и getEndIndex .

Начальный индекс текстового диапазона включается, а конечный индекс исключается. Оба индекса начинаются с нуля.

Для чтения содержимого текстового диапазона используйте функции asString или asRenderedString .

Для получения поддиапазона внутри текстового диапазона используйте функцию getRange .

Следующий скрипт создает текстовое поле на первом слайде и устанавливает в нем текстовое содержимое "Hello world!". Затем он извлекает поддиапазон, охватывающий только "Hello".

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    100,
    200,
    300,
    60,
  );
  const textRange = shape.getText();
  // Set text in TEXT_BOX
  textRange.setText("Hello world!");
  console.log(
    `Start: ${textRange.getStartIndex()}; End: ${textRange.getEndIndex()}; Content: ${textRange.asString()}`,
  );
  const subRange = textRange.getRange(0, 5);
  console.log(
    `Sub-range Start: ${subRange.getStartIndex()}; Sub-range End: ${subRange.getEndIndex()}; Sub-range Content: ${subRange.asString()}`,
  );
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

Диапазон текста, возвращаемый ячейкой фигуры или таблицы, всегда охватывает весь текст, даже если текст вставляется и удаляется. Поэтому в этом примере генерируются следующие сообщения в журнале:

Start: 0; End: 13; Content: Hello world!
Start: 0; End: 5; Content: Hello

Вставка и удаление текста

Вставлять и удалять текст в фигурах и ячейках таблиц можно с помощью текстовых диапазонов.

  • insertText и appendText позволяют вставлять текст.
  • setText заменяет текст в текстовом диапазоне предоставленным текстом.
  • clear удаляет текст, находящийся в пределах текстового диапазона.

Следующий скрипт демонстрирует использование этих функций:

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    100,
    200,
    300,
    60,
  );
  const textRange = shape.getText();
  textRange.setText("Hello world!");
  textRange.clear(6, 11);
  // Insert text in TEXT_BOX
  textRange.insertText(6, "galaxy");
  console.log(
    `Start: ${textRange.getStartIndex()}; End: ${textRange.getEndIndex()}; Content: ${textRange.asString()}`,
  );
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

Этот скрипт создает текстовое поле на первом слайде и устанавливает в нем текстовое содержимое "Hello world!". Затем он удаляет символы с 6 по 11 ("world") и вставляет вместо них текст "galaxy" с индексом 6. В результате выполнения этого примера появляется следующее сообщение в логе:

Start: 0; End: 14; Content: Hello galaxy!

Поиск и замена

Используйте функцию replaceAllText для презентации или страницы, чтобы выполнить глобальный поиск и замену по всей презентации или на определенной странице.

Функция find объекта `TextRange` возвращает экземпляры строки, находящиеся в заданном диапазоне. Ее можно использовать вместе с setText для поиска и замены в ячейке фигуры или таблицы.

Абзацы, пункты списка и блоки текста

TextRange предоставляет функции для возврата полезных коллекций текстовых объектов. Некоторые из этих функций включают в себя:

  • getParagraphs, предоставляет все абзацы, которые перекрывают заданный диапазон текста. Абзац — это последовательность текста, которая заканчивается символом новой строки «\n».
  • getListParagraphs, возвращает элементы списка в текущем текстовом диапазоне.
  • getRuns, предоставляет текстовые фрагменты, перекрывающие текущий диапазон текста. Текстовый фрагмент — это сегмент текста, в котором все символы имеют одинаковый стиль.

оформление текста

Стиль текста определяет отображение текстовых символов в вашей презентации, включая шрифт, цвет и гиперссылки.

Функция getTextStyle текстового диапазона предоставляет объект TextStyle , используемый для стилизации текста. Объект TextStyle охватывает тот же текст, что и родительский TextRange .

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    100,
    200,
    300,
    60,
  );
  const textRange = shape.getText();
  // Set text in TEXT_BOX
  textRange.setText("Hello ");
  // Append text in TEXT_BOX
  const insertedText = textRange.appendText("world!");
  // Style the text with url,bold
  insertedText
    .getTextStyle()
    .setBold(true)
    .setLinkUrl("www.example.com")
    .setForegroundColor("#ff0000");
  const helloRange = textRange.getRange(0, 5);
  console.log(
    `Text: ${helloRange.asString()}; Bold: ${helloRange.getTextStyle().isBold()}`,
  );
  console.log(
    `Text: ${insertedText.asString()}; Bold: ${insertedText.getTextStyle().isBold()}`,
  );
  console.log(
    `Text: ${textRange.asString()}; Bold: ${textRange.getTextStyle().isBold()}`,
  );
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

В приведенном выше примере сначала создается текстовое поле на первом слайде, содержимое которого устанавливается на "Привет". Затем добавляется текст "мир!". Новый добавленный текст выделяется жирным шрифтом, содержит ссылку на www.example.com и имеет красный цвет.

При чтении стилей функция возвращает null, если диапазон содержит несколько значений для стиля. Поэтому в этом примере выводятся следующие сообщения в лог:

Text: Hello; Bold: false
Text: world!; Bold: true
Text: Hello world!; Bold: null

Существует множество других стилей, которые можно применять к тексту. Более подробную информацию можно найти в справочной документации по TextStyle .

Оформление абзаца

Стили абзацев применяются ко всем абзацам целиком и включают в себя такие параметры, как выравнивание текста и межстрочный интервал. Функция getParagraphStyle в TextRange предоставляет объект ParagraphStyle для стилизации всех абзацев, перекрывающих родительский текстовый диапазон.

В следующем примере на первом слайде создается текстовое поле с четырьмя абзацами, а затем первые три абзаца выравниваются по центру.

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    50,
    50,
    300,
    300,
  );
  const textRange = shape.getText();
  // Set the text in the shape/TEXT_BOX
  textRange.setText("Paragraph 1\nParagraph2\nParagraph 3\nParagraph 4");
  const paragraphs = textRange.getParagraphs();
  // Style the paragraph alignment center.
  for (let i = 0; i <= 3; i++) {
    const paragraphStyle = paragraphs[i].getRange().getParagraphStyle();
    paragraphStyle.setParagraphAlignment(SlidesApp.ParagraphAlignment.CENTER);
  }
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

Оформление списка

Подобно ParagraphStyle , ListStyle можно использовать для оформления всех абзацев, которые перекрывают диапазон родительского текста.

slides/style/style.gs
try {
  // Get the first slide of active presentation
  const slide = SlidesApp.getActivePresentation().getSlides()[0];
  // Insert shape in the slide with dimensions
  const shape = slide.insertShape(
    SlidesApp.ShapeType.TEXT_BOX,
    50,
    50,
    300,
    300,
  );
  // Add and style the list
  const textRange = shape.getText();
  textRange
    .appendText("Item 1\n")
    .appendText("\tItem 2\n")
    .appendText("\t\tItem 3\n")
    .appendText("Item 4");
  // Preset patterns of glyphs for lists in text.
  textRange
    .getListStyle()
    .applyListPreset(SlidesApp.ListPreset.DIGIT_ALPHA_ROMAN);
  const paragraphs = textRange.getParagraphs();
  for (let i = 0; i < paragraphs.length; i++) {
    const listStyle = paragraphs[i].getRange().getListStyle();
    console.log(
      `Paragraph ${i + 1}'s nesting level: ${listStyle.getNestingLevel()}`,
    );
  }
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with an error %s ", err.message);
}

В приведенном выше примере на первом слайде создается текстовое поле, содержащее четыре абзаца: второй абзац имеет отступ один раз, а третий — два раза. Затем ко всем абзацам применяется предварительно заданный список. Наконец, в лог записывается уровень вложенности каждого абзаца. Уровень вложенности абзаца определяется количеством табуляций перед текстом абзаца. Таким образом, скрипт выдает следующие записи в лог:

Paragraph 1's nesting level: 0
Paragraph 2's nesting level: 1
Paragraph 3's nesting level: 2
Paragraph 4's nesting level: 0