/** * Copyright (c) 2015-present, Facebook, Inc. * All rights reserved. * * This source code is licensed under the BSD-style license found in the * LICENSE file in the root directory of this source tree. An additional grant * of patent rights can be found in the PATENTS file in the same directory. * * @providesModule Image * @flow */ 'use strict'; var NativeMethodsMixin = require('NativeMethodsMixin'); var NativeModules = require('NativeModules'); var ImageResizeMode = require('ImageResizeMode'); var ImageStylePropTypes = require('ImageStylePropTypes'); var PropTypes = require('ReactPropTypes'); var React = require('React'); var ReactNativeViewAttributes = require('ReactNativeViewAttributes'); var StyleSheet = require('StyleSheet'); var StyleSheetPropType = require('StyleSheetPropType'); var View = require('View'); var flattenStyle = require('flattenStyle'); var invariant = require('fbjs/lib/invariant'); var merge = require('merge'); var requireNativeComponent = require('requireNativeComponent'); var resolveAssetSource = require('resolveAssetSource'); /** * - A react component for displaying different types of images, * including network images, static resources, temporary local images, and * images from local disk, such as the camera roll. Example usage: * * renderImages: function() { * return ( * * * * * ); * }, * * More example code in ImageExample.js */ var ImageViewAttributes = merge(ReactNativeViewAttributes.UIView, { src: true, loadingIndicatorSrc: true, resizeMode: true, progressiveRenderingEnabled: true, fadeDuration: true, shouldNotifyLoadEvents: true, }); var Image = React.createClass({ propTypes: { ...View.propTypes, style: StyleSheetPropType(ImageStylePropTypes), /** * `uri` is a string representing the resource identifier for the image, which * could be an http address, a local file path, or a static image * resource (which should be wrapped in the `require('./path/to/image.png')` function). */ source: PropTypes.oneOfType([ PropTypes.shape({ uri: PropTypes.string, }), // Opaque type returned by require('./image.jpg') PropTypes.number, ]), /** * similarly to `source`, this property represents the resource used to render * the loading indicator for the image, displayed until image is ready to be * displayed, typically after when it got downloaded from network. */ loadingIndicatorSource: PropTypes.oneOfType([ PropTypes.shape({ uri: PropTypes.string, }), // Opaque type returned by require('./image.jpg') PropTypes.number, ]), progressiveRenderingEnabled: PropTypes.bool, fadeDuration: PropTypes.number, /** * Invoked on load start */ onLoadStart: PropTypes.func, /** * Invoked when load completes successfully */ onLoad: PropTypes.func, /** * Invoked when load either succeeds or fails */ onLoadEnd: PropTypes.func, /** * Used to locate this view in end-to-end tests. */ testID: PropTypes.string, }, statics: { resizeMode: ImageResizeMode, }, mixins: [NativeMethodsMixin], /** * `NativeMethodsMixin` will look for this when invoking `setNativeProps`. We * make `this` look like an actual native component class. Since it can render * as 3 different native components we need to update viewConfig accordingly */ viewConfig: { uiViewClassName: 'RCTView', validAttributes: ReactNativeViewAttributes.RCTView, }, _updateViewConfig: function(props) { if (props.children) { this.viewConfig = { uiViewClassName: 'RCTView', validAttributes: ReactNativeViewAttributes.RCTView, }; } else { this.viewConfig = { uiViewClassName: 'RCTImageView', validAttributes: ImageViewAttributes, }; } }, componentWillMount: function() { this._updateViewConfig(this.props); }, componentWillReceiveProps: function(nextProps) { this._updateViewConfig(nextProps); }, contextTypes: { isInAParentText: React.PropTypes.bool }, render: function() { var source = resolveAssetSource(this.props.source); var loadingIndicatorSource = resolveAssetSource(this.props.loadingIndicatorSource); // As opposed to the ios version, here it render `null` // when no source or source.uri... so let's not break that. if (source && source.uri === '') { console.warn('source.uri should not be an empty string'); } if (this.props.src) { console.warn('The component requires a `source` property rather than `src`.'); } if (source && source.uri) { var {width, height} = source; var style = flattenStyle([{width, height}, styles.base, this.props.style]); var {onLoadStart, onLoad, onLoadEnd} = this.props; var nativeProps = merge(this.props, { style, shouldNotifyLoadEvents: !!(onLoadStart || onLoad || onLoadEnd), src: source.uri, loadingIndicatorSrc: loadingIndicatorSource ? loadingIndicatorSource.uri : null, }); if (nativeProps.children) { // TODO(6033040): Consider implementing this as a separate native component var imageProps = merge(nativeProps, { style: styles.absoluteImage, children: undefined, }); return ( {this.props.children} ); } else { if (this.context.isInAParentText) { return ; } else { return ; } } } return null; } }); var styles = StyleSheet.create({ base: { overflow: 'hidden', }, absoluteImage: { left: 0, right: 0, top: 0, bottom: 0, position: 'absolute' } }); var cfg = { nativeOnly: { src: true, loadingIndicatorSrc: true, defaultImageSrc: true, imageTag: true, progressHandlerRegistered: true, shouldNotifyLoadEvents: true, }, }; var RKImage = requireNativeComponent('RCTImageView', Image, cfg); var RCTTextInlineImage = requireNativeComponent('RCTTextInlineImage', Image, cfg); module.exports = Image;