Pressable

Pressable — это обёртка для базового компонента, которая может определять различные стадии нажатия на любом из своих дочерних элементов.

<Pressable onPress={onPressFunction}>
  <Text>I'm pressable!</Text>
</Pressable>

Как это работает

На элементе, обернутом в Pressable:

• onPressIn вызывается при активации нажатия.
• onPressOut вызывается при деактивации жеста нажатия.

После нажатия onPressIn произойдёт одно из двух:

1. Человек уберёт палец, что вызовет onPressOut, за которым последует onPress.
2. Если человек удерживает палец дольше 500 миллисекунд перед его удалением, срабатывает onLongPress. (onPressOut всё равно сработает, когда он уберёт палец.)

Палец — не самый точный инструмент, и пользователи часто случайно активируют не тот элемент или пропускают область активации. Для помощи, у Pressable есть необязательная HitRect, которую вы можете использовать, чтобы определить, насколько далеко прикосновение может регистрироваться от обернутого элемента. Нажатия могут начинаться в любой точке в пределах HitRect.

PressRect позволяет нажатиям перемещаться за пределы элемента и его HitRect, сохраняя при этом активацию и подпадая под «нажатие» — представьте, как вы медленно скользите пальцем от кнопки, на которую вы нажали.

Область касания никогда не выходит за пределы области родительского элемента, а индекс Z элементов-потомков всегда имеет приоритет, если касание происходит к двум перекрывающимся элементам.

Pressable использует API Pressability React Native. Для получения дополнительной информации о работе механизма состояния Pressability, ознакомьтесь с реализацией Pressability.

Свойства

android_disableSound

Android

Если true, то при нажатии не воспроизводится системный звук Android.

android_ripple

Android

Включает эффект ripple Android и настраивает его свойства.

children

Дочерние элементы или функция, принимающая булево значение, отражающее, нажата ли кнопка в данный момент.

unstable_pressDelay

Время ожидания (в миллисекундах) после нажатия перед вызовом onPressIn.

delayLongPress

Время (в миллисекундах) от onPressIn до вызова onLongPress.

disabled

Отключено ли поведение нажатия.

hitSlop

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

onLongPress

Вызывается, если время после onPressIn длится дольше 500 миллисекунд. Этот период можно настроить с помощью delayLongPress.

onPress

Вызывается после onPressOut.

onPressIn

Вызывается сразу при задействовании касания, до onPressOut и onPress.

onPressOut

Вызывается при отпускании касания.

pressRetentionOffset

Дополнительное расстояние за пределами этого элемента, в котором касание считается нажатием до вызова onPressOut.

style

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

testOnly_pressed

Используется только для документации или тестирования (например, тестирование снимков).

Определения типов

RippleConfig

Конфигурация эффекта ripple для свойства android_ripple.

Свойства: