95a7298d21
Summary: adding documentation for more of our UI components. Deleted some unused components, which were not working anyways. Reviewed By: jknoxville Differential Revision: D12896109 fbshipit-source-id: 959c7864240883869ad67283f80a3c189b94bf00
93 lines
2.3 KiB
JavaScript
93 lines
2.3 KiB
JavaScript
/**
|
|
* Copyright 2018-present Facebook.
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
* @format
|
|
*/
|
|
|
|
import {Component} from 'react';
|
|
|
|
const React = require('react');
|
|
const fs = require('fs');
|
|
|
|
type FileProps = {|
|
|
/** Path to the file in the file system */
|
|
src: string,
|
|
/** Initial content that should be shown while the file is loading */
|
|
buffer?: ?string,
|
|
/** Encoding to parse the contents of the file. Defaults to UTF-8. */
|
|
encoding: string,
|
|
/** Content that should be rendered, when the file loading failed. */
|
|
onError?: (err: Error) => React.Element<any>,
|
|
/** Content that should be rendered, while the file is loaded. */
|
|
onLoading?: () => React.Element<any>,
|
|
/** Callback when the data is successfully loaded. */
|
|
onData?: (content: string) => void,
|
|
/** Content that should be rendered, when the file is successfully loaded. This ususally should render the file's contents. */
|
|
onLoad: (content: string) => React.Element<any>,
|
|
|};
|
|
|
|
type FileState = {|
|
|
error: ?Error,
|
|
loaded: boolean,
|
|
content: string,
|
|
|};
|
|
|
|
/**
|
|
* Wrapper for loading file content from the file system.
|
|
*/
|
|
export default class File extends Component<FileProps, FileState> {
|
|
constructor(props: FileProps, context: Object) {
|
|
super(props, context);
|
|
this.state = {
|
|
content: props.buffer || '',
|
|
error: null,
|
|
loaded: props.buffer != null,
|
|
};
|
|
}
|
|
|
|
static defaultProps = {
|
|
encoding: 'utf8',
|
|
};
|
|
|
|
componentWillReceiveProps(nextProps: FileProps) {
|
|
if (nextProps.buffer != null) {
|
|
this.setState({content: nextProps.buffer, loaded: true});
|
|
}
|
|
}
|
|
|
|
componentDidMount() {
|
|
if (this.state.loaded) {
|
|
return;
|
|
}
|
|
|
|
fs.readFile(this.props.src, this.props.encoding, (err, content) => {
|
|
if (err) {
|
|
this.setState({error: err});
|
|
return;
|
|
}
|
|
|
|
this.setState({content, loaded: true});
|
|
|
|
if (this.props.onData) {
|
|
this.props.onData(content);
|
|
}
|
|
});
|
|
}
|
|
|
|
render() {
|
|
const {onError, onLoad, onLoading} = this.props;
|
|
const {content, error, loaded} = this.state;
|
|
|
|
if (error && onError) {
|
|
return onError(error);
|
|
} else if (loaded) {
|
|
return onLoad(content);
|
|
} else if (onLoading) {
|
|
return onLoading();
|
|
} else {
|
|
return null;
|
|
}
|
|
}
|
|
}
|