mirror of
https://github.com/gosticks/DefinitelyTyped.git
synced 2025-10-16 12:05:41 +00:00
456 lines
13 KiB
TypeScript
456 lines
13 KiB
TypeScript
/// <reference path="react-global.d.ts" />
|
|
|
|
interface Props {
|
|
hello: string;
|
|
world?: string;
|
|
foo: number;
|
|
bar: boolean;
|
|
}
|
|
|
|
interface State {
|
|
inputValue?: string;
|
|
seconds?: number;
|
|
}
|
|
|
|
interface Context {
|
|
someValue?: string;
|
|
}
|
|
|
|
interface ChildContext {
|
|
someOtherValue: string;
|
|
}
|
|
|
|
interface MyComponent extends React.Component<Props, State> {
|
|
reset(): void;
|
|
}
|
|
|
|
var props: Props & React.ClassAttributes<{}> = {
|
|
key: 42,
|
|
ref: "myComponent42",
|
|
hello: "world",
|
|
foo: 42,
|
|
bar: true
|
|
};
|
|
|
|
var container: Element;
|
|
|
|
//
|
|
// Top-Level API
|
|
// --------------------------------------------------------------------------
|
|
|
|
var ClassicComponent: React.ClassicComponentClass<Props> =
|
|
React.createClass<Props, State>({
|
|
getDefaultProps() {
|
|
return <Props>{
|
|
hello: undefined,
|
|
world: "peace",
|
|
foo: undefined,
|
|
bar: undefined,
|
|
};
|
|
},
|
|
getInitialState() {
|
|
return {
|
|
inputValue: this.context.someValue,
|
|
seconds: this.props.foo
|
|
};
|
|
},
|
|
reset() {
|
|
this.replaceState(this.getInitialState());
|
|
},
|
|
render() {
|
|
return React.DOM.div(null,
|
|
React.DOM.input({
|
|
ref: input => this._input = input,
|
|
value: this.state.inputValue
|
|
}));
|
|
}
|
|
});
|
|
|
|
class ModernComponent extends React.Component<Props, State>
|
|
implements React.ChildContextProvider<ChildContext> {
|
|
|
|
static propTypes: React.ValidationMap<Props> = {
|
|
foo: React.PropTypes.number
|
|
};
|
|
|
|
static contextTypes: React.ValidationMap<Context> = {
|
|
someValue: React.PropTypes.string
|
|
};
|
|
|
|
static childContextTypes: React.ValidationMap<ChildContext> = {
|
|
someOtherValue: React.PropTypes.string
|
|
};
|
|
|
|
static defaultProps: Props;
|
|
|
|
context: Context;
|
|
|
|
getChildContext() {
|
|
return {
|
|
someOtherValue: "foo"
|
|
};
|
|
}
|
|
|
|
state = {
|
|
inputValue: this.context.someValue,
|
|
seconds: this.props.foo
|
|
};
|
|
|
|
reset() {
|
|
this.setState({
|
|
inputValue: this.context.someValue,
|
|
seconds: this.props.foo
|
|
});
|
|
}
|
|
|
|
private _input: HTMLInputElement;
|
|
|
|
render() {
|
|
return React.DOM.div(null,
|
|
React.DOM.input({
|
|
ref: input => this._input = <HTMLInputElement>input,
|
|
value: this.state.inputValue
|
|
}));
|
|
}
|
|
}
|
|
|
|
// React.createFactory
|
|
var factory: React.CFactory<Props, ModernComponent> =
|
|
React.createFactory(ModernComponent);
|
|
var factoryElement: React.CElement<Props, ModernComponent> =
|
|
factory(props);
|
|
|
|
var classicFactory: React.ClassicFactory<Props> =
|
|
React.createFactory(ClassicComponent);
|
|
var classicFactoryElement: React.ClassicElement<Props> =
|
|
classicFactory(props);
|
|
|
|
var domFactory: React.DOMFactory<React.DOMAttributes, Element> =
|
|
React.createFactory("foo");
|
|
var domFactoryElement: React.DOMElement<React.DOMAttributes, Element> =
|
|
domFactory();
|
|
|
|
// React.createElement
|
|
var element: React.CElement<Props, ModernComponent> =
|
|
React.createElement(ModernComponent, props);
|
|
var classicElement: React.ClassicElement<Props> =
|
|
React.createElement(ClassicComponent, props);
|
|
var domElement: React.ReactHTMLElement<HTMLDivElement> =
|
|
React.createElement("div");
|
|
|
|
// React.cloneElement
|
|
var clonedElement: React.CElement<Props, ModernComponent> =
|
|
React.cloneElement(element, props);
|
|
var clonedClassicElement: React.ClassicElement<Props> =
|
|
React.cloneElement(classicElement, props);
|
|
var clonedDOMElement: React.ReactHTMLElement<HTMLDivElement> =
|
|
React.cloneElement(domElement);
|
|
|
|
// React.render
|
|
var component: React.Component<Props, any> =
|
|
ReactDOM.render(element, container);
|
|
var classicComponent: React.ClassicComponent<Props, any> =
|
|
ReactDOM.render(classicElement, container);
|
|
var domComponent: Element =
|
|
ReactDOM.render(domElement, container);
|
|
|
|
// Other Top-Level API
|
|
var unmounted: boolean = ReactDOM.unmountComponentAtNode(container);
|
|
|
|
// ReactDOMServer is not supported in global version
|
|
// var str: string = ReactDOMServer.renderToString(element);
|
|
// var markup: string = ReactDOMServer.renderToStaticMarkup(element);
|
|
var notValid: boolean = React.isValidElement(props); // false
|
|
var isValid = React.isValidElement(element); // true
|
|
var domNode: Element = ReactDOM.findDOMNode(component);
|
|
domNode = ReactDOM.findDOMNode(domNode);
|
|
|
|
//
|
|
// React Elements
|
|
// --------------------------------------------------------------------------
|
|
|
|
var type = element.type;
|
|
var elementProps: Props = element.props;
|
|
var key = element.key;
|
|
|
|
//
|
|
// React Components
|
|
// --------------------------------------------------------------------------
|
|
|
|
var displayName: string = ClassicComponent.displayName;
|
|
var defaultProps: Props = ClassicComponent.getDefaultProps();
|
|
var propTypes: React.ValidationMap<Props> = ClassicComponent.propTypes;
|
|
|
|
//
|
|
// Component API
|
|
// --------------------------------------------------------------------------
|
|
|
|
// modern
|
|
var componentState: State = component.state;
|
|
component.setState({ inputValue: "!!!" });
|
|
component.forceUpdate();
|
|
|
|
// classic
|
|
var isMounted: boolean = classicComponent.isMounted();
|
|
classicComponent.replaceState({ inputValue: "???", seconds: 60 });
|
|
|
|
var myComponent = <MyComponent>component;
|
|
myComponent.reset();
|
|
|
|
//
|
|
// Attributes
|
|
// --------------------------------------------------------------------------
|
|
|
|
var children: any[] = ["Hello world", [null], React.DOM.span(null)];
|
|
var divStyle: React.CSSProperties = { // CSSProperties
|
|
flex: "1 1 main-size",
|
|
backgroundImage: "url('hello.png')"
|
|
};
|
|
var htmlAttr: React.HTMLProps<any> = {
|
|
key: 36,
|
|
ref: "htmlComponent",
|
|
children: children,
|
|
className: "test-attr",
|
|
style: divStyle,
|
|
onClick: (event: React.MouseEvent) => {
|
|
event.preventDefault();
|
|
event.stopPropagation();
|
|
},
|
|
dangerouslySetInnerHTML: {
|
|
__html: "<strong>STRONG</strong>"
|
|
}
|
|
};
|
|
React.DOM.div(htmlAttr);
|
|
React.DOM.span(htmlAttr);
|
|
React.DOM.input(htmlAttr);
|
|
|
|
React.DOM.svg({ viewBox: "0 0 48 48" },
|
|
React.DOM.rect({
|
|
x: 22,
|
|
y: 10,
|
|
width: 4,
|
|
height: 28
|
|
}),
|
|
React.DOM.rect({
|
|
x: 10,
|
|
y: 22,
|
|
width: 28,
|
|
height: 4
|
|
}));
|
|
|
|
|
|
//
|
|
// React.PropTypes
|
|
// --------------------------------------------------------------------------
|
|
|
|
var PropTypesSpecification: React.ComponentSpec<any, any> = {
|
|
propTypes: {
|
|
optionalArray: React.PropTypes.array,
|
|
optionalBool: React.PropTypes.bool,
|
|
optionalFunc: React.PropTypes.func,
|
|
optionalNumber: React.PropTypes.number,
|
|
optionalObject: React.PropTypes.object,
|
|
optionalString: React.PropTypes.string,
|
|
optionalNode: React.PropTypes.node,
|
|
optionalElement: React.PropTypes.element,
|
|
optionalMessage: React.PropTypes.instanceOf(Date),
|
|
optionalEnum: React.PropTypes.oneOf(["News", "Photos"]),
|
|
optionalUnion: React.PropTypes.oneOfType([
|
|
React.PropTypes.string,
|
|
React.PropTypes.number,
|
|
React.PropTypes.instanceOf(Date)
|
|
]),
|
|
optionalArrayOf: React.PropTypes.arrayOf(React.PropTypes.number),
|
|
optionalObjectOf: React.PropTypes.objectOf(React.PropTypes.number),
|
|
optionalObjectWithShape: React.PropTypes.shape({
|
|
color: React.PropTypes.string,
|
|
fontSize: React.PropTypes.number
|
|
}),
|
|
requiredFunc: React.PropTypes.func.isRequired,
|
|
requiredAny: React.PropTypes.any.isRequired,
|
|
customProp: function(props: any, propName: string, componentName: string) {
|
|
if (!/matchme/.test(props[propName])) {
|
|
return new Error("Validation failed!");
|
|
}
|
|
return null;
|
|
}
|
|
},
|
|
render: (): React.ReactElement<any> => {
|
|
return null;
|
|
}
|
|
};
|
|
|
|
//
|
|
// ContextTypes
|
|
// --------------------------------------------------------------------------
|
|
|
|
var ContextTypesSpecification: React.ComponentSpec<any, any> = {
|
|
contextTypes: {
|
|
optionalArray: React.PropTypes.array,
|
|
optionalBool: React.PropTypes.bool,
|
|
optionalFunc: React.PropTypes.func,
|
|
optionalNumber: React.PropTypes.number,
|
|
optionalObject: React.PropTypes.object,
|
|
optionalString: React.PropTypes.string,
|
|
optionalNode: React.PropTypes.node,
|
|
optionalElement: React.PropTypes.element,
|
|
optionalMessage: React.PropTypes.instanceOf(Date),
|
|
optionalEnum: React.PropTypes.oneOf(["News", "Photos"]),
|
|
optionalUnion: React.PropTypes.oneOfType([
|
|
React.PropTypes.string,
|
|
React.PropTypes.number,
|
|
React.PropTypes.instanceOf(Date)
|
|
]),
|
|
optionalArrayOf: React.PropTypes.arrayOf(React.PropTypes.number),
|
|
optionalObjectOf: React.PropTypes.objectOf(React.PropTypes.number),
|
|
optionalObjectWithShape: React.PropTypes.shape({
|
|
color: React.PropTypes.string,
|
|
fontSize: React.PropTypes.number
|
|
}),
|
|
requiredFunc: React.PropTypes.func.isRequired,
|
|
requiredAny: React.PropTypes.any.isRequired,
|
|
customProp: function(props: any, propName: string, componentName: string) {
|
|
if (!/matchme/.test(props[propName])) {
|
|
return new Error("Validation failed!");
|
|
}
|
|
return null;
|
|
}
|
|
},
|
|
render: (): React.ReactElement<any> => {
|
|
return null;
|
|
}
|
|
};
|
|
|
|
//
|
|
// React.Children
|
|
// --------------------------------------------------------------------------
|
|
|
|
var mappedChildrenArray: number[] =
|
|
React.Children.map<number>(children, (child) => { return 42; });
|
|
React.Children.forEach(children, (child) => {});
|
|
var nChildren: number = React.Children.count(children);
|
|
var onlyChild = React.Children.only([null, [[["Hallo"], true]], false]);
|
|
var childrenToArray: React.ReactChild[] = React.Children.toArray(children);
|
|
|
|
//
|
|
// Example from http://facebook.github.io/react/
|
|
// --------------------------------------------------------------------------
|
|
|
|
interface TimerState {
|
|
secondsElapsed: number;
|
|
}
|
|
class Timer extends React.Component<{}, TimerState> {
|
|
state = {
|
|
secondsElapsed: 0
|
|
};
|
|
private _interval: number;
|
|
tick() {
|
|
this.setState((prevState, props) => ({
|
|
secondsElapsed: prevState.secondsElapsed + 1
|
|
}));
|
|
}
|
|
componentDidMount() {
|
|
this._interval = setInterval(() => this.tick(), 1000);
|
|
}
|
|
componentWillUnmount() {
|
|
clearInterval(this._interval);
|
|
}
|
|
render() {
|
|
return React.DOM.div(
|
|
null,
|
|
"Seconds Elapsed: ",
|
|
this.state.secondsElapsed
|
|
);
|
|
}
|
|
}
|
|
ReactDOM.render(React.createElement(Timer), container);
|
|
|
|
//
|
|
// createFragment addon
|
|
// --------------------------------------------------------------------------
|
|
React.addons.createFragment({
|
|
a: React.DOM.div(),
|
|
b: ["a", false, React.createElement("span")]
|
|
});
|
|
|
|
//
|
|
// CSSTransitionGroup addon
|
|
// --------------------------------------------------------------------------
|
|
React.createFactory(React.addons.CSSTransitionGroup)({
|
|
component: React.createClass({
|
|
render: (): React.ReactElement<any> => null
|
|
}),
|
|
childFactory: (c) => c,
|
|
transitionName: "transition",
|
|
transitionAppear: false,
|
|
transitionEnter: true,
|
|
transitionLeave: true
|
|
});
|
|
|
|
//
|
|
// LinkedStateMixin addon
|
|
// --------------------------------------------------------------------------
|
|
React.createClass({
|
|
mixins: [React.addons.LinkedStateMixin],
|
|
render: function() { return React.DOM.div(null); }
|
|
});
|
|
|
|
//
|
|
// Perf addon
|
|
// --------------------------------------------------------------------------
|
|
React.addons.Perf.start();
|
|
React.addons.Perf.stop();
|
|
var measurements = React.addons.Perf.getLastMeasurements();
|
|
React.addons.Perf.printInclusive(measurements);
|
|
React.addons.Perf.printExclusive(measurements);
|
|
React.addons.Perf.printWasted(measurements);
|
|
React.addons.Perf.printDOM(measurements);
|
|
|
|
//
|
|
// PureRenderMixin addon
|
|
// --------------------------------------------------------------------------
|
|
React.createClass({
|
|
mixins: [React.addons.PureRenderMixin],
|
|
render: function() { return React.DOM.div(null); }
|
|
});
|
|
|
|
//
|
|
// TestUtils addon
|
|
// --------------------------------------------------------------------------
|
|
var node: Element;
|
|
React.addons.TestUtils.Simulate.click(node);
|
|
React.addons.TestUtils.Simulate.change(node);
|
|
React.addons.TestUtils.Simulate.keyDown(node, { key: "Enter" });
|
|
|
|
var renderer: React.ShallowRenderer =
|
|
React.addons.TestUtils.createRenderer();
|
|
renderer.render(React.createElement(Timer));
|
|
var output: React.ReactElement<React.Props<Timer>> =
|
|
renderer.getRenderOutput();
|
|
|
|
//
|
|
// TransitionGroup addon
|
|
// --------------------------------------------------------------------------
|
|
React.createFactory(React.addons.TransitionGroup)({ component: "div" });
|
|
|
|
//
|
|
// update addon
|
|
// --------------------------------------------------------------------------
|
|
{
|
|
// These are copied from https://facebook.github.io/react/docs/update.html
|
|
let initialArray = [1, 2, 3];
|
|
let newArray = React.addons.update(initialArray, {$push: [4]}); // => [1, 2, 3, 4]
|
|
|
|
let collection = [1, 2, {a: [12, 17, 15]}];
|
|
let newCollection = React.addons.update(collection, {2: {a: {$splice: [[1, 1, 13, 14]]}}});
|
|
// => [1, 2, {a: [12, 13, 14, 15]}]
|
|
|
|
let obj = {a: 5, b: 3};
|
|
let newObj = React.addons.update(obj, {b: {$apply: function(x) {return x * 2;}}});
|
|
// => {a: 5, b: 6}
|
|
let newObj2 = React.addons.update(obj, {b: {$set: obj.b * 2}});
|
|
|
|
let objShallow = {a: 5, b: 3};
|
|
let newObjShallow = React.addons.update(obj, {$merge: {b: 6, c: 7}}); // => {a: 5, b: 6, c: 7}
|
|
}
|