[Navigator] Navigator vs. NavigatorIOS please fix docs

[soheil-zz]

Someone should update this doc; how is one supposed to know the difference between Navigator and NavigatorIOS?
http://facebook.github.io/react-native/docs/navigator.html#content

It should be noted Navigator uses JS animations and that you cannot pass props in the same way as NavigatorIOS. I modified my entire app only to find out that Navigator is not what I want because the animations suck and don't feel native!

Also explain exactly why they are two different components, this should be in bold on top of both their doc pages. I'm yet to know the logic behind having two different ones.

[jtremback]

👍

[brentvatne]

I modified my entire app only to find out that Navigator is not what I want because the animations suck and don't feel native!

@soheil - aw man, sorry to hear that. Which animations are you having trouble with? When you say they don't feel native, is it because they feel janky or just don't seem like they are the correct animations?

Someone should update this doc; how is one supposed to know the difference between Navigator and NavigatorIOS?

Also explain exactly why they are two different components, this should be in bold on top of both their doc pages. I'm yet to know the logic behind having two different ones.

I believe that by reading the docs for each it is not too difficult to determine the differences, but agree that it might be useful to have a sentence at the top explaining how they relate to each other.

Notice how with NavigatorIOS there is no way to add your own custom navigation bar? It uses the native implementation for it. Navigator allows you to write your own component to use as a navigation bar. Additionally, NavigatorIOS adds support for swipe-back, but Navigator has many more transitions available (eg: you can swipe a view down to dismiss it with floatFromTop), and they can be customized as well!

Would a description like the above help to have in the documentation? Or would there need to be more information?

As for passProps, this is all done with renderScene I believe - you get the data from the route object that you pushed and then pass it in as a prop to the component that you render here.

[jtremback]

I feel like there was some way to add custom stuff to a basic nav bar when I was doing a little true native dev- would this be at all worth adding or is the functionality too hobbled?

[brentvatne]

@jtremback - NavigatorIOS uses UINavigationController, check it out to see what options are exposed

[jtremback]

I can set leftBarButtonItem from JS?

[brentvatne]

@jtremback - you can set the leftButtonIcon and leftButtonTitle, see #1230 for issue to improve parsing of the docs for this

[bakso]

Doc no good

[nigeman]

+1 the documentation needs to be clearer. PS good work guys so far..

[yelled3]

I was about to open a similar PR and found this, so 👍 @soheil

@brentvatne

Would a description like the above help to have in the documentation? Or would there need to be more information?

I would even go further and suggest adding a new page in the docs that compares between Navigator and NavigatorIOS.
It would also be helpful to include examples to use cases where it's best to use one and not the other.

[sharathprabhal]

I would even go further and suggest adding a new page in the docs that compares between Navigator and NavigatorIOS.

^ +1

[brentvatne]

Thanks for the 👍's folks, helps me to prioritize this

[richardscarrott]

+1

[faithfe]

＋1

[mitchozer]

+1, thanks!