react-native-paper
Version:
Material design for React Native
209 lines (208 loc) • 7.73 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = void 0;
var React = _interopRequireWildcard(require("react"));
var _reactNative = require("react-native");
var _utils = require("./utils");
var _theming = require("../../core/theming");
var _addEventListener = require("../../utils/addEventListener");
var _Portal = _interopRequireDefault(require("../Portal/Portal"));
var _Text = _interopRequireDefault(require("../Typography/Text"));
function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
/**
* Tooltips display informative text when users hover over, focus on, or tap an element.
*
* Plain tooltips, when activated, display a text label identifying an element, such as a description of its function. Tooltips should include only short, descriptive text and avoid restating visible UI text.
*
* ## Usage
* ```js
* import * as React from 'react';
* import { IconButton, Tooltip } from 'react-native-paper';
*
* const MyComponent = () => (
* <Tooltip title="Selected Camera">
* <IconButton icon="camera" selected size={24} onPress={() => {}} />
* </Tooltip>
* );
*
* export default MyComponent;
* ```
*/
const Tooltip = ({
children,
enterTouchDelay = 500,
leaveTouchDelay = 1500,
title,
theme: themeOverrides,
titleMaxFontSizeMultiplier,
...rest
}) => {
const isWeb = _reactNative.Platform.OS === 'web';
const theme = (0, _theming.useInternalTheme)(themeOverrides);
const [visible, setVisible] = React.useState(false);
const [measurement, setMeasurement] = React.useState({
children: {},
tooltip: {},
measured: false
});
const showTooltipTimer = React.useRef([]);
const hideTooltipTimer = React.useRef([]);
const childrenWrapperRef = React.useRef(null);
const touched = React.useRef(false);
const isValidChild = React.useMemo(() => /*#__PURE__*/React.isValidElement(children), [children]);
React.useEffect(() => {
return () => {
if (showTooltipTimer.current.length) {
showTooltipTimer.current.forEach(t => clearTimeout(t));
showTooltipTimer.current = [];
}
if (hideTooltipTimer.current.length) {
hideTooltipTimer.current.forEach(t => clearTimeout(t));
hideTooltipTimer.current = [];
}
};
}, []);
React.useEffect(() => {
const subscription = (0, _addEventListener.addEventListener)(_reactNative.Dimensions, 'change', () => setVisible(false));
return () => subscription.remove();
}, []);
const handleTouchStart = React.useCallback(() => {
if (hideTooltipTimer.current.length) {
hideTooltipTimer.current.forEach(t => clearTimeout(t));
hideTooltipTimer.current = [];
}
if (isWeb) {
let id = setTimeout(() => {
touched.current = true;
setVisible(true);
}, enterTouchDelay);
showTooltipTimer.current.push(id);
} else {
touched.current = true;
setVisible(true);
}
}, [isWeb, enterTouchDelay]);
const handleTouchEnd = React.useCallback(() => {
touched.current = false;
if (showTooltipTimer.current.length) {
showTooltipTimer.current.forEach(t => clearTimeout(t));
showTooltipTimer.current = [];
}
let id = setTimeout(() => {
setVisible(false);
setMeasurement({
children: {},
tooltip: {},
measured: false
});
}, leaveTouchDelay);
hideTooltipTimer.current.push(id);
}, [leaveTouchDelay]);
const handlePress = React.useCallback(() => {
var _props$onPress;
if (touched.current) {
return null;
}
if (!isValidChild) return null;
const props = children.props;
if (props.disabled) return null;
return (_props$onPress = props.onPress) === null || _props$onPress === void 0 ? void 0 : _props$onPress.call(props);
}, [children.props, isValidChild]);
const handleHoverIn = React.useCallback(() => {
handleTouchStart();
if (isValidChild) {
var _onHoverIn, _ref;
(_onHoverIn = (_ref = children.props).onHoverIn) === null || _onHoverIn === void 0 || _onHoverIn.call(_ref);
}
}, [children.props, handleTouchStart, isValidChild]);
const handleHoverOut = React.useCallback(() => {
handleTouchEnd();
if (isValidChild) {
var _onHoverOut, _ref2;
(_onHoverOut = (_ref2 = children.props).onHoverOut) === null || _onHoverOut === void 0 || _onHoverOut.call(_ref2);
}
}, [children.props, handleTouchEnd, isValidChild]);
const handleOnLayout = ({
nativeEvent: {
layout
}
}) => {
var _childrenWrapperRef$c;
(_childrenWrapperRef$c = childrenWrapperRef.current) === null || _childrenWrapperRef$c === void 0 || _childrenWrapperRef$c.measure((_x, _y, width, height, pageX, pageY) => {
setMeasurement({
children: {
pageX,
pageY,
height,
width
},
tooltip: {
...layout
},
measured: true
});
});
};
const mobilePressProps = {
onPress: handlePress,
onLongPress: () => handleTouchStart(),
onPressOut: () => handleTouchEnd(),
delayLongPress: enterTouchDelay
};
const webPressProps = {
onHoverIn: handleHoverIn,
onHoverOut: handleHoverOut
};
return /*#__PURE__*/React.createElement(React.Fragment, null, visible && /*#__PURE__*/React.createElement(_Portal.default, null, /*#__PURE__*/React.createElement(_reactNative.View, {
onLayout: handleOnLayout,
style: [styles.tooltip, {
backgroundColor: theme.isV3 ? theme.colors.onSurface : theme.colors.tooltip,
...(0, _utils.getTooltipPosition)(measurement, children),
borderRadius: theme.roundness,
...(measurement.measured ? styles.visible : styles.hidden)
}],
testID: "tooltip-container"
}, /*#__PURE__*/React.createElement(_Text.default, {
accessibilityLiveRegion: "polite",
numberOfLines: 1,
selectable: false,
variant: "labelLarge",
style: {
color: theme.colors.surface
},
maxFontSizeMultiplier: titleMaxFontSizeMultiplier
}, title))), /*#__PURE__*/React.createElement(_reactNative.Pressable, _extends({
ref: childrenWrapperRef,
style: styles.pressContainer
}, isWeb ? webPressProps : mobilePressProps), /*#__PURE__*/React.cloneElement(children, {
...rest,
...(isWeb ? webPressProps : mobilePressProps)
})));
};
Tooltip.displayName = 'Tooltip';
const styles = _reactNative.StyleSheet.create({
tooltip: {
alignSelf: 'flex-start',
justifyContent: 'center',
paddingHorizontal: 16,
height: 32,
maxHeight: 32
},
visible: {
opacity: 1
},
hidden: {
opacity: 0
},
pressContainer: {
...(_reactNative.Platform.OS === 'web' && {
cursor: 'default'
})
}
});
var _default = exports.default = Tooltip;
//# sourceMappingURL=Tooltip.js.map