mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Alex Hunt
4f709afa6d
Summary: Pull Request resolved: https://github.com/facebook/react-native/pull/50225 Updates `index.js.flow` to export (what should be) all public types for `react-native`, closely matching the resolved exported types of `types/index.d.ts` (current manual TS defs). - Note that this first pass doesn't have to be exhaustive (not yet load bearing) — however, I've done a best-effort scan, which passes our current `__typetests__` fixtures. **Approach: Explicit type imports in `index.js.flow`** We have a number of options for how we organise and re-export values and types from the new index file — for now, we're opting for explicitly exporting each symbol here. - While this clutters the index file somewhat, it also provides a single scannable source of truth — without introducing / altering each contributing module's type exports (we might want to do this eventually, but we're far from having strong organisation denoting the public API boundary). It's self-documenting that the index file contains all root exports by name. - At the same time, we currently have some exceptions that use `export [type] *` to line up with TypeScript `namespace`s. We aim to review and update these within this release cycle, to enforce the above system. Changelog: [Internal] - The `react-native` package now exports all public types in Flow (fbsource) Reviewed By: rubennorte Differential Revision: D71741575 fbshipit-source-id: 770e2b490e494ee195f4240358fec39f69145a94
109 lines
3.2 KiB
JavaScript
109 lines
3.2 KiB
JavaScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @flow strict-local
|
|
* @format
|
|
*/
|
|
|
|
import type {HostInstance} from '../../src/private/types/HostInstance';
|
|
import type {ImageBackgroundProps} from './ImageProps';
|
|
|
|
import View from '../Components/View/View';
|
|
import flattenStyle from '../StyleSheet/flattenStyle';
|
|
import StyleSheet from '../StyleSheet/StyleSheet';
|
|
import Image from './Image';
|
|
import * as React from 'react';
|
|
|
|
export type {ImageBackgroundProps} from './ImageProps';
|
|
|
|
/**
|
|
* Very simple drop-in replacement for <Image> which supports nesting views.
|
|
*
|
|
* ```ReactNativeWebPlayer
|
|
* import React, { Component } from 'react';
|
|
* import { AppRegistry, View, ImageBackground, Text } from 'react-native';
|
|
*
|
|
* class DisplayAnImageBackground extends Component {
|
|
* render() {
|
|
* return (
|
|
* <ImageBackground
|
|
* style={{width: 50, height: 50}}
|
|
* source={{uri: 'https://reactnative.dev/img/opengraph.png'}}
|
|
* >
|
|
* <Text>React</Text>
|
|
* </ImageBackground>
|
|
* );
|
|
* }
|
|
* }
|
|
*
|
|
* // App registration and rendering
|
|
* AppRegistry.registerComponent('DisplayAnImageBackground', () => DisplayAnImageBackground);
|
|
* ```
|
|
*/
|
|
class ImageBackground extends React.Component<ImageBackgroundProps> {
|
|
setNativeProps(props: {...}) {
|
|
// Work-around flow
|
|
const viewRef = this._viewRef;
|
|
if (viewRef) {
|
|
viewRef.setNativeProps(props);
|
|
}
|
|
}
|
|
|
|
_viewRef: ?React.ElementRef<typeof View> = null;
|
|
|
|
_captureRef = (ref: null | HostInstance) => {
|
|
this._viewRef = ref;
|
|
};
|
|
|
|
render(): React.Node {
|
|
const {
|
|
children,
|
|
style,
|
|
imageStyle,
|
|
imageRef,
|
|
importantForAccessibility,
|
|
...props
|
|
} = this.props;
|
|
|
|
// $FlowFixMe[underconstrained-implicit-instantiation]
|
|
const flattenedStyle = flattenStyle(style);
|
|
return (
|
|
<View
|
|
accessibilityIgnoresInvertColors={true}
|
|
importantForAccessibility={importantForAccessibility}
|
|
style={style}
|
|
ref={this._captureRef}>
|
|
{/* $FlowFixMe[incompatible-use] */}
|
|
<Image
|
|
{...props}
|
|
importantForAccessibility={importantForAccessibility}
|
|
style={[
|
|
StyleSheet.absoluteFill,
|
|
{
|
|
// Temporary Workaround:
|
|
// Current (imperfect yet) implementation of <Image> overwrites width and height styles
|
|
// (which is not quite correct), and these styles conflict with explicitly set styles
|
|
// of <ImageBackground> and with our internal layout model here.
|
|
// So, we have to proxy/reapply these styles explicitly for actual <Image> component.
|
|
// This workaround should be removed after implementing proper support of
|
|
// intrinsic content size of the <Image>.
|
|
// $FlowFixMe[prop-missing]
|
|
width: flattenedStyle?.width,
|
|
// $FlowFixMe[prop-missing]
|
|
height: flattenedStyle?.height,
|
|
},
|
|
imageStyle,
|
|
]}
|
|
ref={imageRef}
|
|
/>
|
|
{children}
|
|
</View>
|
|
);
|
|
}
|
|
}
|
|
|
|
export default ImageBackground;
|