# ** What is a Screen? **
#
# "Screen" is the most common class in MotionPrime, you can create entire application using only "Screens".
# Generally it's just a "UIViewController" wrapper with some syntax sugar. 
# For RubyOnRails developers the nearest analogy would be "Controllers".

# ** Create a screen. **
#
# Just inherit it from `Prime::Screen`.

class FooScreen < Prime::Screen
end

# ** Render the screen. **
#
# You should rewrite the `render` method of `Prime::Screen`, which will be runned after first opening screen.

class FooScreen < Prime::Screen
  def render
    @main_section = MyProfileSection.new(screen: self, model: User.first)
    @main_section.render
  end
end

# ** Set screen's title **
# 
# Title will be used in screen's navigation controller and will be shown on top of screen.
#

class FooScreen < Prime::Screen
  title 'Foo screen'
end

# You can pass block to define screen's title

class FooScreen < Prime::Screen
  title { params[:title] }
end

# ** Initialize screen. **
#
# Available options:
# * `:navigation`. When this options is true, screen will be created with navigation support: it will allow adding title and left/right buttons.
# This option is true by default.
class AppDelegate < Prime::BaseAppDelegate
  def on_load(application, launch_options)
    foo_screen = FooScreen.new(navigation: false)
  end
end

# ** Open screen: from app delegate. **

# Opening screen using app delegate is the most basic way, you would use it at least on app load.
#
# Available options:
# * `:root`. When this option is true, screen will not be in content controller and will create new root screen. 
# You can use root: true when you have already opened screen with sidebar, and you want to open new screen without sidebar.
# This option is false by default if you already have root screen and true if not.
#
# * `:sidebar`. Send `Prime::Screen` instance to this option if you want to create root screen with sidebar. 
# Value of this options will be used as sidebar controller. 
# NOTE: you should install some gem providing sidebar functionality, e.g. 'prime_reside_menu'
class AppDelegate < Prime::BaseAppDelegate
  def on_load(application, launch_options)
    foo_screen = FooScreen.new
    sidebar = MySidebar.new(navigation: false)
    app_delegate.open_screen foo_screen, sidebar: sidebar
  end
end

# ** Open screen: from parent screen. **

# Opening screen using parent screen is usefull if you want to create inherited screen. 
# Parent screen should have been initialized with navigation support.
class FooScreen < Prime::Screen
  def render
    second_screen = SecondScreen.new(navigation: true)
    foo_screen.open_screen second_screen
  end
end

# ** Open screen: using short version. **

# Opening screen using short syntax available both for opening via app delegate and via parent screen.
class AppDelegate < Prime::BaseAppDelegate
  def on_load(application, launch_options)
    open_screen :foo_bar, sidebar: true
  end
end

# ** Next **
#
# [Read more about Sections](sections.html)