RedAlert

Alerts and ActionSheets with ease

Did you know that UIAlertView and UIActionSheet (as well as their respective delegate protocols) are deprecated in iOS 8?

Apple requests you start using the new UIAlertController. This gem is built on UIAlertController and RMQ, along with support for antiquated UIAlertViews for the gnostalgic.

With an emphasis on ease of use, this gem allows you to quickly implement Alerts and Actionsheets in your RMQ RubyMotion applications.

Screenshot

Screen Shot

Installation

Requires RMQ 1.2.0 or later, and iOS 8 or later

Add the RedAlert gem to your Gemfile.

  gem 'RedAlert'

Usage

Note: If you're using RedPotion then rmq.app can be accessed by simply typing app, so rmq.app.alert would be simply app.alert. The following examples are verbose and assume only RMQ.


  # Simply do an alert
  rmq.app.alert("Minimal Alert")

  # Alert with callback
  rmq.app.alert("Alert with Block") {
    puts "Alert with Block worked!"
  }

  # Modify some snazzy options
  rmq.app.alert(title: "New Title", message: "Great message", animated: false)

  # Switch it to look like an ActionSheet by setting the style
  rmq.app.alert(title: "Hey there!", message: "My style is :sheet", style: :sheet) do |action_type|
    puts "You clicked #{action_type}"
  end

  # Utilize common templates
  rmq.app.alert(message: "Would you like a sandwich?", actions: :yes_no_cancel, style: :sheet) do |action_type|
    case action_type
    when :yes
      puts "Here's your Sandwich!"
    when :no
      puts "FINE!"
    end
  end

You can even use the make_button helper to create custom UIAction buttons to add:

  # Use custom UIAction buttons and add them
  taco = rmq.app.make_button("Taco") {
            puts "Taco pressed"
          }
  nacho = rmq.app.make_button(title: "Nacho", style: :destructive)  {
            puts "Nacho pressed"
          }
  button_list = [taco, nacho]
  rmq.app.alert(title: "Actions!", message: "Actions created with `make_button` helper.", actions: button_list)

Available Templates

Templates are provided HERE

:yes_no = Simple yes and no buttons.
:yes_no_cancel = Yes/no buttons with a separated cancel button.
:ok_cancel = OK button with a separated cancel button.
:delete_cancel = Delete button (red) with a separated cancel button.

More to come: be sure to submit a pull-request with your button template needs.

More info

Feel free to read up on UIAlertController to see what all is wrapped up in this gem.

Classic UIAlertView Helpers

If you'd like to still support pre-iOS8, you can easily use rmq.app.alert_view with a similar syntax, and instead of actions you'll used the predefined delegates.

UIAlertView Classic:

  # support the elderly
  rmq.app.alert_view("Hey look at this old trick")

  # Still feels like magic!
  rmq.app.alert_view({
    title: "Hey There",
    message: "Check out this complex alert!",
    cancel_button: 'Nevermind',
    other_buttons: ['Log In'],
    delegate: nil,
    view_style: UIAlertViewStyleLoginAndPasswordInput
  })

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request