Class GradientCondition
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Градиентное состояние Доступ к условиям градиента (цвета) в Conditional Format Rule Apis
. Каждое правило условного форматирования может содержать одно условие градиента. Условие градиента определяется тремя точками на числовой шкале (min, mid и max), каждая из которых имеет цвет, значение и Interpolation Type
. Содержимое ячейки сравнивается со значениями на числовой шкале, и цвет, применяемый к ячейке, интерполируется на основе близости содержимого ячейки к минимальным, средним и максимальным точкам условия градиента.
// Logs all the information inside gradient conditional format rules on a sheet.
// The below snippet assumes all colors have ColorType.RGB.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (let i = 0; i < rules.length; i++) {
const gradient = rules[i].getGradientCondition();
const minColor = gradient.getMinColorObject().asRgbColor().asHexString();
const minType = gradient.getMinType();
const minValue = gradient.getMinValue();
const midColor = gradient.getMidColorObject().asRgbColor().asHexString();
const midType = gradient.getMidType();
const midValue = gradient.getMidValue();
const maxColor = gradient.getMaxColorObject().asRgbColor().asHexString();
const maxType = gradient.getMaxType();
const maxValue = gradient.getMaxValue();
Logger.log(`The conditional format gradient information for rule ${i}:
MinColor ${minColor}, MinType ${minType}, MinValue ${minValue},
MidColor ${midColor}, MidType ${midType}, MidValue ${midValue},
MaxColor ${maxColor}, MaxType ${maxType}, MaxValue ${maxValue}`);
}
Устаревшие методы
Метод | Тип возврата | Краткое описание |
---|
get Max Color()
| String | Получает набор цветов для максимального значения этого условия градиента. |
get Mid Color()
| String | Получает набор цветов для среднего значения этого условия градиента. |
get Min Color()
| String | Получает набор цветов для минимального значения этого условия градиента. |
Подробная документация
get Max Color Object()
Возвращает цвет, заданный для максимального значения этого условия градиента. Возвращает значение null
, если цвет не задан.
Возвращаться
Color
— цвет, заданный для максимального значения данного условия градиента или null
.
get Max Type()
Возвращает тип интерполяции для максимального значения этого условия градиента. Возвращает значение null
если максимальный тип градиента не установлен.
Возвращаться
Interpolation Type
— тип интерполяции для максимального значения данного градиентного условия или null
.
get Max Value()
Получает максимальное значение этого условия градиента. Возвращает пустую строку, если Interpolation Type
— MAX
или если максимальное значение не задано.
Возвращаться
String
— максимальное значение, если указано, или пустая строка.
get Mid Color Object()
Возвращает цвет, заданный для среднего значения этого условия градиента. Возвращает значение null
если цвет не задан.
Возвращаться
Color
— цвет, заданный для среднего значения этого условия градиента или null
.
get Mid Type()
Возвращает тип интерполяции для среднего значения этого условия градиента. Возвращает значение null
если средний тип градиента не задан.
Возвращаться
Interpolation Type
— тип интерполяции для среднего значения данного условия градиента или null
.
get Mid Value()
Получает среднее значение этого условия градиента. Возвращает пустую строку, если среднее значение градиента не задано.
Возвращаться
String
— среднее значение или пустая строка.
get Min Color Object()
Возвращает цвет, заданный для минимального значения этого условия градиента. Возвращает значение null
, если цвет не задан.
Возвращаться
Color
— цвет, заданный для минимального значения данного условия градиента или null
.
get Min Type()
Возвращает тип интерполяции для минимального значения этого условия градиента. Возвращает значение null
если минимальный тип градиента не установлен.
Возвращаться
Interpolation Type
— тип интерполяции для минимального значения данного условия градиента или null
.
get Min Value()
Получает минимальное значение этого условия градиента. Возвращает пустую строку, если Interpolation Type
— MIN
или минимальное значение не задано.
Возвращаться
String
— минимальное значение, если указано, или пустая строка.
Устаревшие методы
get Max Color()
Устарело. Заменено на get Max Color Object()
Возвращает цвет, заданный для максимального значения этого условия градиента. Возвращает пустую строку, если цвет не задан.
Возвращаться
String
— набор цветов для максимального значения этого условия градиента или пустая строка.
get Mid Color()
Устарело. Заменено на get Mid Color Object()
Возвращает цвет, заданный для среднего значения этого условия градиента. Возвращает пустую строку, если цвет не задан.
Возвращаться
String
— цвет, заданный для среднего значения этого условия градиента, или пустая строка.
get Min Color()
Устарело. Заменено на get Min Color Object()
Возвращает цвет, заданный для минимального значения этого условия градиента. Возвращает пустую строку, если цвет не задан.
Возвращаться
String
— набор цветов для минимального значения данного условия градиента или пустая строка.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-05 UTC.
[null,null,["Последнее обновление: 2025-08-05 UTC."],[[["\u003cp\u003eGradient conditions in Google Sheets allow you to apply color scales to cells based on their values, interpolating colors between minimum, midpoint, and maximum points.\u003c/p\u003e\n"],["\u003cp\u003eEach gradient condition is defined by three points (min, mid, max), each having a color, value, and interpolation type.\u003c/p\u003e\n"],["\u003cp\u003eYou can access and manipulate gradient conditions programmatically using Apps Script methods like \u003ccode\u003egetMinColorObject()\u003c/code\u003e, \u003ccode\u003egetMidValue()\u003c/code\u003e, and \u003ccode\u003egetMaxType()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDeprecated methods like \u003ccode\u003egetMinColor()\u003c/code\u003e, \u003ccode\u003egetMidColor()\u003c/code\u003e, and \u003ccode\u003egetMaxColor()\u003c/code\u003e have been replaced by object-based alternatives for color retrieval.\u003c/p\u003e\n"]]],["Gradient conditions, within conditional format rules, define cell colors based on a number scale with minimum, midpoint, and maximum values. Each point has a color, value, and interpolation type. Methods like `getMinColorObject()`, `getMidType()`, and `getMaxValue()` retrieve these attributes. Cell content is compared to these values to interpolate and apply a corresponding color. Deprecated methods (`getMinColor()`, `getMidColor()`, `getMaxColor()`) are replaced with `get[Point]ColorObject()`.\n"],null,["# Class GradientCondition\n\nGradientCondition\n\nAccess gradient (color) conditions in [ConditionalFormatRuleApis](/apps-script/reference/spreadsheet/conditional-format-rule).\nEach conditional format rule may contain a single gradient condition. A gradient condition is\ndefined by three points along a number scale (min, mid, and max), each of which has a color, a\nvalue, and a [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type). The content of a cell is\ncompared to the values in the number scale and the color applied to the cell is interpolated\nbased on the cell content's proximity to the gradient condition min, mid, and max points.\n\n```javascript\n// Logs all the information inside gradient conditional format rules on a sheet.\n// The below snippet assumes all colors have ColorType.RGB.\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst rules = sheet.getConditionalFormatRules();\nfor (let i = 0; i \u003c rules.length; i++) {\n const gradient = rules[i].getGradientCondition();\n\n const minColor = gradient.getMinColorObject().asRgbColor().asHexString();\n const minType = gradient.getMinType();\n const minValue = gradient.getMinValue();\n const midColor = gradient.getMidColorObject().asRgbColor().asHexString();\n const midType = gradient.getMidType();\n const midValue = gradient.getMidValue();\n const maxColor = gradient.getMaxColorObject().asRgbColor().asHexString();\n const maxType = gradient.getMaxType();\n const maxValue = gradient.getMaxValue();\n\n Logger.log(`The conditional format gradient information for rule ${i}:\n MinColor ${minColor}, MinType ${minType}, MinValue ${minValue},\n MidColor ${midColor}, MidType ${midType}, MidValue ${midValue},\n MaxColor ${maxColor}, MaxType ${maxType}, MaxValue ${maxValue}`);\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------|----------------------------------------------------------------------------|--------------------------------------------------------------------------------|\n| [getMaxColorObject()](#getMaxColorObject()) | [Color](/apps-script/reference/spreadsheet/color) | Gets the color set for the maximum value of this gradient condition. |\n| [getMaxType()](#getMaxType()) | [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) | Gets the interpolation type for the maximum value of this gradient condition. |\n| [getMaxValue()](#getMaxValue()) | `String` | Gets the max value of this gradient condition. |\n| [getMidColorObject()](#getMidColorObject()) | [Color](/apps-script/reference/spreadsheet/color) | Gets the color set for the midpoint value of this gradient condition. |\n| [getMidType()](#getMidType()) | [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) | Gets the interpolation type for the midpoint value of this gradient condition. |\n| [getMidValue()](#getMidValue()) | `String` | Gets the midpoint value of this gradient condition. |\n| [getMinColorObject()](#getMinColorObject()) | [Color](/apps-script/reference/spreadsheet/color) | Gets the color set for the minimum value of this gradient condition. |\n| [getMinType()](#getMinType()) | [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) | Gets the interpolation type for the minimum value of this gradient condition. |\n| [getMinValue()](#getMinValue()) | `String` | Gets the minimum value of this gradient condition. |\n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|---------------------------------|-------------|-----------------------------------------------------------------------|\n| [getMaxColor()](#getMaxColor()) | `String` | Gets the color set for the maximum value of this gradient condition. |\n| [getMidColor()](#getMidColor()) | `String` | Gets the color set for the midpoint value of this gradient condition. |\n| [getMinColor()](#getMinColor()) | `String` | Gets the color set for the minimum value of this gradient condition. |\n\nDetailed documentation\n----------------------\n\n### `get``Max``Color``Object()`\n\nGets the color set for the maximum value of this gradient condition. Returns `null` if\nthe color hasn't been set.\n\n#### Return\n\n\n[Color](/apps-script/reference/spreadsheet/color) --- The color set for the maximum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Max``Type()`\n\nGets the interpolation type for the maximum value of this gradient condition. Returns `null` if the gradient max type hasn't been set.\n\n#### Return\n\n\n[InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) --- The interpolation type for the maximum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Max``Value()`\n\nGets the max value of this gradient condition. Returns an empty string if the [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) is `MAX` or if the max value hasn't been\nset.\n\n#### Return\n\n\n`String` --- The maximum value if specified or an empty string.\n\n*** ** * ** ***\n\n### `get``Mid``Color``Object()`\n\nGets the color set for the midpoint value of this gradient condition. Returns `null` if\nthe color hasn't been set.\n\n#### Return\n\n\n[Color](/apps-script/reference/spreadsheet/color) --- The color set for the midpoint value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Mid``Type()`\n\nGets the interpolation type for the midpoint value of this gradient condition. Returns `null` if the gradient mid type hasn't been set.\n\n#### Return\n\n\n[InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) --- The interpolation type for the midpoint value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Mid``Value()`\n\nGets the midpoint value of this gradient condition. Returns an empty string if the gradient mid\nvalue hasn't been set.\n\n#### Return\n\n\n`String` --- The midpoint value or an empty string.\n\n*** ** * ** ***\n\n### `get``Min``Color``Object()`\n\nGets the color set for the minimum value of this gradient condition. Returns `null` if\nthe color hasn't been set.\n\n#### Return\n\n\n[Color](/apps-script/reference/spreadsheet/color) --- The color set for the minimum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Min``Type()`\n\nGets the interpolation type for the minimum value of this gradient condition. Returns `null` if the gradient min type hasn't been set.\n\n#### Return\n\n\n[InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) --- The interpolation type for the minimum value of this gradient condition or `null`.\n\n*** ** * ** ***\n\n### `get``Min``Value()`\n\nGets the minimum value of this gradient condition. Returns an empty string if the [InterpolationType](/apps-script/reference/spreadsheet/interpolation-type) is `MIN` or if the min value hasn't been\nset.\n\n#### Return\n\n\n`String` --- The minimum value if specified or an empty string.\n\nDeprecated methods\n------------------\n\n### `get``Max``Color()`\n\n\n**Deprecated.** Replaced by [getMaxColorObject()](#getMaxColorObject())\n\nGets the color set for the maximum value of this gradient condition. Returns an empty string if\nthe color hasn't been set.\n\n#### Return\n\n\n`String` --- The color set for the maximum value of this gradient condition or an empty string.\n\n*** ** * ** ***\n\n### `get``Mid``Color()`\n\n\n**Deprecated.** Replaced by [getMidColorObject()](#getMidColorObject())\n\nGets the color set for the midpoint value of this gradient condition. Returns an empty string\nif the color hasn't been set.\n\n#### Return\n\n\n`String` --- The color set for the midpoint value of this gradient condition or an empty string.\n\n*** ** * ** ***\n\n### `get``Min``Color()`\n\n\n**Deprecated.** Replaced by [getMinColorObject()](#getMinColorObject())\n\nGets the color set for the minimum value of this gradient condition. Returns an empty string if\nthe color hasn't been set.\n\n#### Return\n\n\n`String` --- The color set for the minimum value of this gradient condition or an empty string."]]