Merge pull request #12 from eugene-manuilov/feature/with-refs

Feature/with refs

Author: eugene-manuilov

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 **Implemented enhancements:**
 
-- 
+- Implemented ability to get wrapped component.
 
 ## v0.3.3 (2017-08-12)
 

README.md

@@ -104,12 +104,14 @@ See an [example](https://github.com/eugene-manuilov/react-gettext/tree/master/ex
 
 ## Documentation
 
-### withGettext(translations, pluralForms)
+### withGettext(translations, pluralForms, options)
 
 Higher-order function which is exported by default from `react-gettext` package. It accepts two arguments and returns function to create higher-order component.
 
 - **translations**: a hash object or a function which returns hash object where keys are original messages and values are translated messages.
 - **pluralForms**: a string to calculate plural form (used by [Gettext PO](http://docs.translatehouse.org/projects/localization-guide/en/latest/l10n/pluralforms.html?id=l10n/pluralforms)) or a function which accepts a number and calculates a plural form number. Pay attentions that plural forms are zero-based what means to get 1st plural form it should return 0, to get 2nd - 1, and so on.
+- **options**: a hash object with options. Currently supports following options:
+  - **withRef**: an optional boolean flag that determines whether or not to set `ref` property to a wrapped component what will allow you to get wrapped component instance by calling `getWrappedComponent()` function of the HOC. By default: `FALSE`.
 
 Example:
 

src/index.js

@@ -2,25 +2,35 @@ import React from 'react';
 import hoistNonReactStatic from 'hoist-non-react-statics';
 import Textdomain from './Textdomain';
 
-export { Textdomain };
+const withGettext = (translations = {}, pluralForm = 'n != 1', options = {}) => (WrappedComponent) => {
+	const args = Object.assign({ withRef: false }, options);
+
+	class WithGettext extends Textdomain {
 
-export default function withGettext(translations = {}, pluralForm = 'n != 1') {
-	return (WrappedComponent) => {
-		class WithGettext extends Textdomain {
+		getWrappedComponent() {
+			return this.refs.wrappedComponent;
+		}
 
-			render() {
-				return React.createElement(WrappedComponent, this.props);
+		render() {
+			const newprops = Object.assign({}, this.props);
+			if (args.withRef) {
+				newprops.ref = 'wrappedComponent';
 			}
 
+			return React.createElement(WrappedComponent, newprops);
 		}
 
-		WithGettext.defaultProps = {
-			translations,
-			plural: pluralForm,
-		};
-
-		WithGettext.displayName = `withGettext(${WrappedComponent.displayName || WrappedComponent.name || 'Component'})`;
+	}
 
-		return hoistNonReactStatic(WithGettext, WrappedComponent);
+	WithGettext.defaultProps = {
+		translations,
+		plural: pluralForm,
 	};
-}
+
+	WithGettext.displayName = `withGettext(${WrappedComponent.displayName || WrappedComponent.name || 'Component'})`;
+
+	return hoistNonReactStatic(WithGettext, WrappedComponent);
+};
+
+export { Textdomain };
+export default withGettext;