Сегодня мы продолжим изучать скрипты в гугл таблицах и наш разговор пойдет о работе со свойствами ячейки. Нам понадобятся знания, полученные на прошлом уроке, поэтому, если пропустили, обязательно почитайте:
Давайте создадим новую книгу Гугл таблиц:
Напомню, что, как обычно мы начинаем писать нашу функцию с шаблона (заготовки). Откроем редактор скриптов и введем нашу заготовку
function myFunction() {
let ss = SpreadsheetApp.getActiveSpreadsheet();
let aktSheet = ss.getSheetByName('Лист1');
}
В ячейке B3 у нас есть данные (слово "Тест"). Давайте немного поиграемся со свойствами ячейки B3.
Background -Фон
Давайте попробуем установить фон яейки
Для того, чтобы обратиться к определенной ячейке, нужно построить конструкцию:
aktSheet.getRange("B3").setBackground("Green");
Дословно эта комбинация звучит как: "Для листа (actSheet - "Лист1") для диапазона B3 установить фоновый цвет (setBackground) - Зеленый (Green)
Напомню, что set-установить (назначить), а get - получить (взять). Другими словами мы можем установить цвет (в этом случае конечно же нужен аргумент, например "Green") - setBackground, либо мы можем узнать цвет getBackground (в этом случае аргумент не нужен).
Как будет выглядеть наша функция полностью:
function myFunction() {
let ss = SpreadsheetApp.getActiveSpreadsheet();
let aktSheet = ss.getSheetByName('Лист1');
aktSheet.getRange("B3").setBackground("Green");
}
Цвета можно задавать как текстом: white, green, blue и т.д., так и кодировкой, например #ffffff. Например
aktSheet.getRange("B3:B7").setBackground("#ffffff");
Border - Рамки
Для установки рамок (бордюров) используется функция setBorder
aktSheet.getRange("B3:D7").setBorder(true, true, true, true, false, false);
Дословно: Для диапазона B3:D7 установить рамки (setBorder)
В этой функции через запятую мы указываем какие рамки нам нужно установить (true) или снять (false), последовательно перечисляя (против часовой стрелки): верхняя, левая, нижняя, правая, потом вертикальные внутри диапазона, горизонтальные внутри диапазона.
FontColor - Цвет шрифта
Эта функция отвечает за цвет шрифта в ячейке (или диапазоне). Принцип действия аналогичен функции Background, например:
aktSheet.getRange("B3:D7").setFontColor("red");
Цвет так-же можно указывать либо прописью, либо с помощью кода. Указывать можно либо целый диапазон ("B3:D7"), либо конкретную ячейку ("B3")
FontFamily -Шрифт
Можно поменять шрифт у определенного диапазона
aktSheet.getRange("B3:D7").setFontFamily("Helvetica");
Названия шрифта указывается прописью: Helvetica, Arial и т.д.
FontLine - зачеркивание/подчеркивание
Можно сделать подчеркнуть или зачеркнуть текст в ячейке
aktSheet.getRange("B3").setFontLine("underline");
Возможные варианты:
"underline" - подчеркнутый
"line-through" - зачеркнутый
"none" - без выделения
FontSize - Размер шрифта
Можно задать размер шрифта. Размер шрифта указывается в скобках. Пример:
aktSheet.getRange("B3").setFontSize(20);
FontStyle - Курсив
Можно задать написание курсивом
aktSheet.getRange("B3").setFontStyle("italic");
Варианты:
"italic" - курсив
"normal" - обычный
FontWeight - Полужирный
Можно выделить шрифт полужирным
aktSheet.getRange("B3").setFontWeight("bold");
Варианты:
"bold" - полужирный
"normal" - обычный
HorizontalAlignment - выравнивание по горизонтали
С помощью этой функции можно задать выравнивание текста по горизонтали
aktSheet.getRange("B3").setHorizontalAlignment("right");
Возможные варианты:
"left" - выравнивание по левому краю
"right" - выравнивание по правому краю
"center" или "normal" - выравнивание по центру
нулевой (отсутствующий) параметр сбрасывает настройки выравнивания текста в ячейке
VerticalAlignment - выравнивание по вертикали
С помощью этой функции можно выравнивать текст внутри ячейки по вертикали
aktSheet.getRange("B3").setVerticalAlignment("top");
Возможные варианты аргументов
"top" - по верхней границе
"middle" - по середине ячейки
"bottom" - по нижней границе
нулевой (отсутствующий) параметр сбрасывает настройки выравнивания текста в ячейке
Note - Примечание
aktSheet.getRange("B3").setNote("Это примечание");
Эта функция добавит примечание к ячейке
Собственно говоря, мы разобрали все основные функции по работе с ячейками.
Если Вам понравилась статья, ставьте лайк и подписывайтесь на канал.
Все остальные уроки по Гугл таблицам Вы можете посмотреть, посетив страницу с содержанием:
Без рекламы и только про Гугл таблицы можно почитать здесь: