Sha256: 01b5850c728f203a4c5131d734d02faeef3b8e8261a6901f908966eef5274757

Contents?: true

Size: 1.78 KB

Versions: 10

Compression:

Stored size: 1.78 KB

Contents

module Vedeu

  module DSL

    # Provides the mechanism to create menus within client applications and use
    # events to drive them.
    #
    class Menu

      include Vedeu::DSL

      # Return a new instance of DSL::Menu.
      #
      # @param model [Vedeu::Menu]
      # @param client [Object]
      # @return [Vedeu::DSL::Menu]
      def initialize(model, client = nil)
        @model  = model
        @client = client
      end

      # Add an individual item to the menu.
      #
      # @param element [Object] An object you wish to add to the collection.
      #
      #   Vedeu.menu 'my_menu' do
      #     item SomeClass.new
      #     item SomeClass.new
      #   end
      #
      # @return [Array]
      def item(element)
        model.collection << element
      end

      # Define the items for the menu. Most powerful when used with one of your
      # model classes.
      #
      # In the 'my_playlist' example below, your `Track` model may return a
      # collection of tracks to populate the menu.
      #
      #   Vedeu.menu 'my_menu' do
      #     items [:item_1, :item_2, :item_3]
      #   end
      #
      #   Vedeu.menu 'my_playlist' do
      #     items Track.all_my_favourites
      #   end
      #
      # @param collection [Array<Object>] A collection of objects which make up
      #   the menu items.
      # @return [Array]
      def items(collection = [])
        model.collection = collection
      end

      # The name of the menu. Used to reference the menu throughout your
      # application's execution lifetime.
      #
      #   Vedeu.menu do
      #     name 'my_menu'
      #     # ...
      #   end
      #
      # @param value [String]
      # @return [String]
      def name(value)
        model.name = value
      end

    end # Menu

  end # DSL

end # Vedeu

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
vedeu-0.6.1 lib/vedeu/dsl/menu.rb
vedeu-0.6.0 lib/vedeu/dsl/menu.rb
vedeu-0.5.13 lib/vedeu/dsl/menu.rb
vedeu-0.5.12 lib/vedeu/dsl/menu.rb
vedeu-0.5.11 lib/vedeu/dsl/menu.rb
vedeu-0.5.10 lib/vedeu/dsl/menu.rb
vedeu-0.5.9 lib/vedeu/dsl/menu.rb
vedeu-0.5.8 lib/vedeu/dsl/menu.rb
vedeu-0.5.7 lib/vedeu/dsl/menu.rb
vedeu-0.5.6 lib/vedeu/dsl/menu.rb