Methods
- []
- []=
- alert
- alert=
- clear
- delete
- discard
- each
- empty?
- initialize_copy
- keep
- key?
- keys
- notice
- notice=
- now
- now_is_loaded?
- stringify_array
- to_hash
Included Modules
Instance Public methods
[](k)
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 161
def [](k)
@flashes[k.to_s]
end
🔎 See on GitHub
[]=(k, v)
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 155
def []=(k, v)
k = k.to_s
@discard.delete k
@flashes[k] = v
end
🔎 See on GitHub
alert()
Convenience accessor for flash[:alert]
.
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 262
def alert
self[:alert]
end
🔎 See on GitHub
alert=(message)
Convenience accessor for flash[:alert]=
.
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 267
def alert=(message)
self[:alert] = message
end
🔎 See on GitHub
clear()
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 194
def clear
@discard.clear
@flashes.clear
end
🔎 See on GitHub
delete(key)
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 179
def delete(key)
key = key.to_s
@discard.delete key
@flashes.delete key
self
end
🔎 See on GitHub
discard(k = nil)
Marks the entire flash or a single flash entry to be discarded by the end of the current action:
flash.discard # discard the entire flash at the end of the current action
flash.discard(:warning) # discard only the "warning" entry at the end of the current action
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 247
def discard(k = nil)
k = k.to_s if k
@discard.merge Array(k || keys)
k ? self[k] : self
end
🔎 See on GitHub
each(&block)
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 199
def each(&block)
@flashes.each(&block)
end
🔎 See on GitHub
empty?()
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 190
def empty?
@flashes.empty?
end
🔎 See on GitHub
initialize_copy(other)
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 147
def initialize_copy(other)
if other.now_is_loaded?
@now = other.now.dup
@now.flash = self
end
super
end
🔎 See on GitHub
keep(k = nil)
Keeps either the entire current flash or a specific flash entry available for the next action:
flash.keep # keeps the entire flash
flash.keep(:notice) # keeps only the "notice" entry, the rest of the flash is discarded
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 237
def keep(k = nil)
k = k.to_s if k
@discard.subtract Array(k || keys)
k ? self[k] : self
end
🔎 See on GitHub
key?(name)
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 175
def key?(name)
@flashes.key? name.to_s
end
🔎 See on GitHub
keys()
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 171
def keys
@flashes.keys
end
🔎 See on GitHub
notice()
Convenience accessor for flash[:notice]
.
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 272
def notice
self[:notice]
end
🔎 See on GitHub
notice=(message)
Convenience accessor for flash[:notice]=
.
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 277
def notice=(message)
self[:notice] = message
end
🔎 See on GitHub
now()
Sets a flash that will not be available to the next action, only to the current.
flash.now[:message] = "Hello current action"
This method enables you to use the flash as a central messaging system in your app. When you need to pass an object to the next action, you use the standard flash assign ([]=
). When you need to pass an object to the current action, you use now
, and your object will vanish when the current action is done.
Entries set via now
are accessed the same way as standard entries: flash['my-key']
.
Also, brings two convenience accessors:
flash.now.alert = "Beware now!"
# Equivalent to flash.now[:alert] = "Beware now!"
flash.now.notice = "Good luck now!"
# Equivalent to flash.now[:notice] = "Good luck now!"
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 229
def now
@now ||= FlashNow.new(self)
end
🔎 See on GitHub
to_hash()
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 186
def to_hash
@flashes.dup
end
🔎 See on GitHub
Instance Protected methods
now_is_loaded?()
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 282
def now_is_loaded?
@now
end
🔎 See on GitHub
Instance Private methods
stringify_array(array)
📝 Source code
# File actionpack/lib/action_dispatch/middleware/flash.rb, line 287
def stringify_array(array) # :doc:
array.map do |item|
item.kind_of?(Symbol) ? item.to_s : item
end
end
🔎 See on GitHub