Animated.Value
Стандартное значение для управления анимациями. Одно значение может управлять несколькими свойствами синхронно, но может управляться только одним механизмом за раз. Использование нового механизма (например, запуск новой анимации или вызов setValue) остановит все предыдущие.
Обычно инициализируется с помощью new Animated.Value(0);
Ссылка
Методы
setValue()
setValue(value);
Непосредственно установить значение. Это остановит любые анимации, выполняемые со значением, и обновит все привязанные свойства.
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| value | число | Да | Значение |
setOffset()
setOffset(offset);
Устанавливает смещение, которое применяется поверх текущего значения, независимо от того, было ли оно установлено с помощью setValue, анимации или Animated.event. Полезно для компенсации действий, таких как начало жеста панорамирования.
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| offset | число | Да | Значение смещения |
flattenOffset()
flattenOffset();
Объединяет значение смещения со значением основы и сбрасывает смещение до нуля. Конечный результат значения не меняется.
extractOffset()
extractOffset();
Устанавливает значение смещения в значение основы и сбрасывает значение основы до нуля. Конечный результат значения не меняется.
addListener()
addListener(callback);
Добавляет асинхронного слушателя к значению, чтобы вы могли наблюдать обновления от анимаций. Это полезно, так как нет способа синхронно прочитать значение, поскольку оно может быть управляется нативно.
Возвращает строку, которая служит идентификатором для слушателя.
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| callback | функция | Да | Функция обратного вызова, которая получит объект с ключом value, установленным в новое значение. |
removeListener()
removeListener(id);
Отменить регистрацию слушателя. Параметр id должен совпадать с идентификатором, ранее возвращенным addListener().
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| id | строка | Да | Идентификатор слушателя, который будет удален. |
removeAllListeners()
removeAllListeners();
Удалить всех зарегистрированных слушателей.
stopAnimation()
stopAnimation([callback]);
Останавливает любую выполняющуюся анимацию или отслеживание. callback вызывается с конечным значением после остановки анимации, что полезно для обновления состояния для соответствия позиции анимации с макетом.
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| callback | функция | Нет | Функция, которая получит конечное значение. |
resetAnimation()
resetAnimation([callback]);
Останавливает любую анимацию и сбрасывает значение до исходного.
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| callback | функция | Нет | Функция, которая получит исходное значение. |
interpolate()
interpolate(config);
Интерполирует значение перед обновлением свойства, например, сопоставляет 0-1 с 0-10.
См. AnimatedInterpolation.js
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| config | объект | Да | См. ниже. |
Объект config состоит из следующих ключей:
-
inputRange: массив чисел -
outputRange: массив чисел или строк -
easing(необязательно): функция, которая возвращает число, учитывая входное число -
extrapolate(необязательно): строка, такая как 'extend', 'identity' или 'clamp' -
extrapolateLeft(необязательно): строка, такая как 'extend', 'identity' или 'clamp' -
extrapolateRight(необязательно): строка, такая как 'extend', 'identity' или 'clamp'
animate()
animate(animation, callback);
Обычно используется только внутри, но может использоваться классом пользовательской анимации.
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| animation | Анимация | Да | См. Animation.js. |
| callback | функция | Да | Функция обратного вызова. |
stopTracking()
stopTracking();
Обычно используется только внутри.
track()
track(tracking);
Обычно используется только внутри.
Параметры:
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| tracking | AnimatedNode | Да | См. AnimatedNode.js
|
© 2022 Facebook Inc.
Licensed under the Creative Commons Attribution 4.0 International Public License.
https://reactnative.dev/docs/animatedvalue