TouchableWithoutFeedback¶

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

TouchableWithoutFeedback поддерживает только один дочерний элемент. Если вы хотите иметь несколько дочерних компонентов, оберните их в View. Важно отметить, что TouchableWithoutFeedback работает путем клонирования своего дочернего компонента и применения к нему пропса responder. Поэтому необходимо, чтобы любые промежуточные компоненты передавали эти пропсы базовому компоненту React Native.

Шаблон использования¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

function MyComponent(props: MyComponentProps) {
    return (
        <View
            {...props}
            style={{ flex: 1, backgroundColor: '#fff' }}
        >
            <Text>My Component</Text>
        </View>
    );
}

<TouchableWithoutFeedback onPress={() => alert('Pressed!')}>
    <MyComponent />
</TouchableWithoutFeedback>;

Пример¶

Свойства¶

accessibilityIgnoresInvertColors¶

accessible¶

Когда true, указывает, что представление является доступным элементом. По умолчанию все осязаемые элементы являются доступными.

accessibilityLabel¶

Переопределяет текст, который считывается программой чтения с экрана, когда пользователь взаимодействует с элементом. По умолчанию метка строится путем обхода всех дочерних элементов и накопления всех узлов Text, разделенных пробелом.

accessibilityLanguage ¶

Значение, указывающее, какой язык должен использоваться программой чтения с экрана, когда пользователь взаимодействует с элементом. Оно должно соответствовать спецификации BCP 47.

Дополнительную информацию см. в документе iOS accessibilityLanguage doc.

accessibilityHint¶

Подсказка доступности помогает пользователям понять, что произойдет, когда они выполнят действие над элементом доступности, если результат не ясен из надписи доступности.

accessibilityRole¶

accessibilityRole передает назначение компонента пользователю вспомогательной технологии.

accessibilityRole может быть одним из следующих:

• 'none' - Используется, когда элемент не имеет роли.
• 'button' - Используется, когда элемент должен рассматриваться как кнопка.
• 'link' - Используется, когда элемент должен рассматриваться как ссылка.
• 'search' - Используется, когда элемент текстового поля должен также рассматриваться как поле поиска.
• 'image' - Используется, когда элемент должен рассматриваться как изображение. Может сочетаться, например, с кнопкой или ссылкой.
• 'keyboardkey' - Используется, когда элемент действует как клавиша клавиатуры.
• 'text' - Используется, когда элемент должен рассматриваться как статичный текст, который не может изменяться.
• 'adjustable' - Используется, когда элемент может быть "отрегулирован" (например, ползунок).
• 'imagebutton' - Используется, когда элемент должен рассматриваться как кнопка, а также является изображением.
• 'header' - Используется, когда элемент действует как заголовок для раздела содержимого (например, заголовок навигационной панели).
• 'summary' - Используется, когда элемент может быть использован для предоставления краткой информации о текущих условиях в приложении при первом запуске.
• 'alert' - Используется, когда элемент содержит важный текст, который должен быть представлен пользователю.
• 'checkbox' - Используется, когда элемент представляет флажок, который может быть отмечен, снят или иметь смешанное состояние.
• 'combobox' - Используется, когда элемент представляет собой комбинированное окно, которое позволяет пользователю выбирать из нескольких вариантов.
• 'menu' - Используется, когда компонент представляет собой меню выбора.
• 'menubar' - Используется, когда компонент представляет собой контейнер нескольких меню.
• 'menuitem' - Используется для представления пункта в меню.
• 'progressbar' - Используется для представления компонента, который показывает прогресс выполнения задачи.
• 'radio' - Используется для представления радиокнопки.
• 'radiogroup' - Используется для представления группы радиокнопок.
• 'scrollbar' - Используется для представления полосы прокрутки.
• 'spinbutton' - Используется для представления кнопки, которая открывает список вариантов.
• 'switch' - Используется для представления переключателя, который можно включать и выключать.
• 'tab' - Используется для представления вкладки.
• 'tablist' - Используется для представления списка вкладок.
• 'timer' - Используется для представления таймера.
• 'toolbar' - Используется для представления панели инструментов (контейнер кнопок действий или компонентов).

accessibilityState¶

Описывает текущее состояние компонента для пользователя вспомогательной технологии.

См. руководство Accessibility guide для получения дополнительной информации.

accessibilityActions¶

Действия доступности позволяют ассистивной технологии программно вызывать действия компонента. Свойство accessibilityActions должно содержать список объектов действий. Каждый объект действия должен содержать имя поля и метку.

Дополнительную информацию см. в Руководстве по доступности.

aria-busy¶

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

aria-checked¶

Указывает на состояние элемента с флажком. Это поле может принимать либо булево значение, либо строку "mixed" для представления смешанных флажков.

aria-disabled¶

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

aria-expanded¶

Указывает, является ли расширяемый элемент в данный момент развернутым или свернутым.

aria-hidden¶

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

Например, в окне, содержащем родственные представления A и B, установка aria-hidden в true для представления B заставляет VoiceOver игнорировать элементы в представлении B.

aria-label¶

Определяет строковое значение, которое маркирует интерактивный элемент.

aria-live ¶

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

• off Службы доступности не должны объявлять об изменениях в этом представлении.
• polite Службы доступности должны объявлять об изменениях в этом представлении.
• assertive Службы доступа должны прерывать текущую речь, чтобы немедленно объявить об изменениях в этом представлении.

aria-modal ¶

Булево значение, указывающее, должен ли VoiceOver игнорировать элементы в представлениях, которые являются родными братьями и сестрами приемника. Имеет приоритет над accessibilityViewIsModal prop.

aria-selected¶

Указывает, выбран ли в данный момент элемент с возможностью выбора или нет.

onAccessibilityAction¶

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

Дополнительную информацию см. в Руководстве по доступности.

accessibilityValue¶

Представляет текущее значение компонента. Это может быть текстовое описание значения компонента, или для компонентов, основанных на диапазоне, таких как ползунки и прогресс-бары, оно содержит информацию о диапазоне (минимальное, текущее и максимальное).

Дополнительную информацию см. в Руководстве по доступности.

aria-valuemax¶

Представляет максимальное значение для компонентов, основанных на диапазоне, таких как ползунки и прогресс-бары. Имеет приоритет над значением max в пропсе accessibilityValue.

aria-valuemin¶

Представляет минимальное значение для компонентов, основанных на диапазоне, таких как ползунки и прогресс-бары. Имеет приоритет над значением min в пропсе accessibilityValue.

aria-valuenow¶

Представляет текущее значение для компонентов, основанных на диапазоне, таких как ползунки и прогресс-бары. Имеет приоритет над значением now в пропсе accessibilityValue.

aria-valuetuetext¶

Представляет текстовое описание компонента. Имеет приоритет над значением text в пропсе accessibilityValue.

delayLongPress¶

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

delayPressIn¶

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

delayPressOut¶

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

disabled¶

Если true, отключите все взаимодействия для этого компонента.

hitSlop¶

Определяет, насколько далеко ваше прикосновение может отходить от кнопки. Это значение добавляется к pressRetentionOffset при отходе от кнопки.

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

id¶

Используется для определения местоположения данного представления в родном коде. Имеет приоритет над nativeID.

onBlur¶

Вызывается, когда элемент теряет фокус.

onFocus¶

Вызывается, когда элемент получает фокус.

onLayout¶

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

onLongPress¶

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

onPress¶

Вызывается при отпускании касания, но не при отмене (например, при прокрутке, которая крадет блокировку ответчика). Первый аргумент функции - событие в форме PressEvent.

onPressIn¶

Вызывается сразу после нажатия на сенсорный элемент и вызывается даже до onPress. Это может быть полезно при выполнении сетевых запросов. Первым аргументом функции является событие в форме PressEvent.

onPressOut¶

Вызывается, как только прикосновение отпускается, еще до onPress. Первым аргументом функции является событие в форме PressEvent.

pressRetentionOffset¶

Когда вид прокрутки отключен, этот параметр определяет, насколько далеко ваше прикосновение может отойти от кнопки, прежде чем кнопка будет деактивирована. После деактивации попробуйте переместить ее обратно, и вы увидите, что кнопка снова активирована! Переместите ее вперед-назад несколько раз, пока вид прокрутки отключен. Убедитесь, что вы передали константу, чтобы уменьшить выделение памяти.

nativeID¶

testID¶

Используется для определения местоположения данного представления в сквозных тестах.

touchSoundDisabled ¶

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

Комментарии