Перейти к основному содержимому

Подпись

Виджет подписи позволяет захватывать подпись. Этот виджет отслеживает движение пальца или указателя мыши по экрану и соответственно рисует линию на панели для подписи.

Вы можете использовать этот виджет, чтобы получить согласие пользователя на соглашение или договор в цифровой форме.

Добавление виджета Подпись​

Вот пример того, как вы можете добавить виджет Подпись в свой проект:

  1. Сначала перетащите виджет Подпись из вкладки Элементы форм (в панели виджетов) или добавьте его непосредственно из дерева виджетов.
  2. Перейдите в панель свойств, прокрутите вниз до раздела Подпись и настройте ширину и высоту виджета.

Сохранение подписи в документ Firestore​

Возможно, вы используете базу данных Firestore для хранения данных вашего приложения в модели коллекция-документ. Давайте разберем, как сохранить подпись в документ Firestore.

Нарисованная подпись сначала загружается и сохраняется как изображение в Firebase Storage с помощью действия Upload Signature. Это возвращает URL загруженного файла, который можно сохранить в документе Firestore для последующего доступа.

Предварительные требования

Убедитесь, что вы учли все указанные предварительные требования.

Сохранение подписи в документ Firestore включает следующие шаги:

1. Создание поля Image Path​

Создайте коллекцию Firestore со схемой, которая содержит поле с типом данных Image Path. поле-пути-к-изображению

2. Действие Upload signature [Action]​

С помощью этого действия вы можете загрузить нарисованную подпись в Firebase Storage. Это действие возвращает URL загруженного файла, который вы можете использовать для отображения содержимого или сохранения в базе данных для последующего доступа.

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

  1. Выберите виджет (например, кнопку), для которого вы хотите определить действие.
  2. Выберите Actions в панели свойств (правое меню) и нажмите Open. Это откроет Action Flow Editor в новом всплывающем окне.
    1. Нажмите + Add Action.
    2. С правой стороны выполните поиск и выберите Upload Signature.
    3. Установите Signature to Upload в имя виджета подписи (по умолчанию Signature).
  3. Нажмите Close.

3. Передача URL изображения подписи в поле документа​

Действие Upload Signature (добавленное на предыдущем шаге) возвращает URL изображения подписи. Вы можете использовать его для передачи в поле документа, добавив действие, которое создает или обновляет документ, такое как Create Document или Update Document.

Вот шаги подробно:

  1. Выберите виджет (например, кнопку), для которого вы хотите добавить действие.
  2. Выберите Actions в панели свойств (правое меню) и нажмите Open. Это откроет Action Flow Editor в новом всплывающем окне.
    1. Выберите уже добавленное действие Upload Signature Action, нажмите на кнопку + в нижней части блока и выберите Add Action.
    2. С правой стороны выполните поиск и выберите Create Document или Update Document.
    3. Если вы выбрали Create Document.
      1. Установите Collection в имя вашей коллекции (например, todo).
    4. Если вы выбрали Update Document, установите ссылку на обновляемый документ.
      1. Если у вас есть доступ к документу, установите Source в actual document и Available Options в reference.
    5. В разделе Set Fields нажмите кнопку + Field.
    6. Нажмите на имя поля, пока не увидите поля, хранящие значение подписи.
      1. Установите Value Source в From Variable.
      2. Нажмите на UNSET (это откроет всплывающее окно слева).
      3. Выберите Widget State, а затем Uploaded Signature URL.
    7. Закройте редактор потоков действий.

Очистка подписи [Action]​

Вы можете позволить пользователям удалить подпись, если они допустили ошибку или хотят получить идеальную подпись. Для этого добавьте действие Clear Signature.

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

  1. Выберите виджет (например, IconButton с иконкой отмены или удаления), для которого вы хотите определить действие.
  2. Выберите Actions в панели свойств (правое меню) и нажмите + Add Action.
    1. Выполните поиск и выберите Clear Signatures.
    2. Выберите Signature Fields из списка ниже. Это полезно, когда на странице несколько виджетов подписи и вы хотите очистить только выбранные.
  3. Нажмите Close.

Настройка​

Вы можете настроить внешний вид и поведение этого виджета с помощью различных свойств, доступных в панели свойств.

Настройка пера​

Чтобы изменить цвет пера и ширину штриха:

  1. Выберите виджет Подпись из дерева виджетов или области холста.
  2. Перейдите в панель свойств и прокрутите вниз до раздела Подпись.
  3. Найдите свойство Pen Color и нажмите на поле рядом с уже выбранным цветом, выберите цвет, затем нажмите Use Color или нажмите на уже выбранный цвет и введите Hex-код напрямую.
  4. Найдите свойство Pen Stroke Width и введите значение. Чем выше значение, тем толще штрих.