validation

модуль для работы с валидацией в ячейках

Example

// добавление правила валидации для ячейки B3 страницы 2
$$("ssheet").validation.add(
    3, 
    2, 
    {
      "type": "number",
      "integer": 1,
      "empty": 1,
      "condition": "greater",
      "value": "0",
      "inputMessage": "Rules:\n\n- integer greater than 0\n- include empty",
      "errorHandle": "info",
      "errorTitle": "Incorrect data!",
      "errorMessage": "Should be integer greater than 0!"
    }, 
    2
);

У модуля есть набор API методов для работы с валидацией:

• add() - добавляет правило валидации в ячейку. Принимает следующие параметры:
  • row (number) - ID строки
  • column (number) - ID колонки
  • rule (object) - правило валидации. У него есть следующие атрибуты:
    • type (string) - критерий валидации: "any" (содержимое любого типа), "date", "number", "text", "textLength", "range" (для валидации данных в заданном диапазоне ячеек)
    • integer (boolean) - (только для типа number) если задано true, принимаются только целые числа
    • ignoreEmpty (boolean) - игнорировать или нет пустые ячейки
    • condition (string) - условие валидации
    • value (string|array) - значение или массив из двух значений (для правил типа "between/not between"), которые сравниваются со значением указанной ячейки
    • inputMessage (string) - попап с текстом, заданным в этом свойстве, будет отображаться при выделении ячейки
    • errorHandle (string) - способ обработки ошибки (в соответствующем диалоговом окне):
      • "stop" - не позволяет задать некорректное значение
      • "warning" - позволяет отменить заданное значение
      • "information" - информирует, что значение не валидно
    • errorTitle (string) - хедер диалогового окна с ошибкой
    • errorMessage (string) - текст диалогового окна с ошибкой
  • page - (string) опциональный, название страницы. Если не указан, метод применяется к текущей странице
• remove() - удаляет правило валидации, примененное к ячейке. Принимает следующие параметры:
  • row (number) - ID строки
  • column (number) - ID колонки
  • page (number) - опциональный, название страницы. Если не указан, метод применяется к текущей странице
• get() - возвращает правило валидации, примененное к ячейке. Принимает следующие параметры:
  • row (number) - ID строки
  • column (number) - ID колонки
  • page (number) - опциональный, название страницы. Если не указан, метод применяется к текущей странице
• highlight() - добавляет/удаляет подсветку для ячейки с правилами валидации. Принимает следующие параметры:
  • state (boolean/"toggle") - true, чтобы применить подсветку, false, чтобы удалить
  • page - (string) опциональный, название страницы. Если не указан, метод применяется к текущей странице

Наверх