Module: Positionable::PositionableMethods::InstanceMethods

Defined in:
lib/positionable.rb

Instance Method Summary collapse

Instance Method Details

#all_next ⇒ Object

All the next records, whose positions are greater than this record. Records are ordered by their respective positions, depending on the order option provided to is_positionable.



214
215
216
 
# File 'lib/positionable.rb', line 214

def all_next
  self.class.where("#{scoped_position} > ?", position)
end

#all_next_was ⇒ Object

All the next records of the old scope, whose positions are greater than this record before it was moved from its old record.



220
221
222
 
# File 'lib/positionable.rb', line 220

def all_next_was
  self.class.where("#{scoped_position_was} > ?", position_was)
end

#all_previous ⇒ Object

All the next records, whose positions are smaller than this record. Records are ordered by their respective positions, depending on the order option provided to is_positionable (ascending by default).



232
233
234
 
# File 'lib/positionable.rb', line 232

def all_previous
  self.class.where("#{scoped_position} < ?", position)
end

#down! ⇒ Object

Swaps this record position with his next sibling, unless this record is the last one.



193
194
195
 
# File 'lib/positionable.rb', line 193

def down!
  swap_with(self.next) unless last?
end

#first? ⇒ Boolean

Tells whether this record is the first one (of his scope, if any).

Returns:

  • (Boolean) 


178
179
180
 
# File 'lib/positionable.rb', line 178

def first?
  position == start
end

#last? ⇒ Boolean

Tells whether this record is the last one (of his scope, if any).

Returns:

  • (Boolean) 


183
184
185
 
# File 'lib/positionable.rb', line 183

def last?
  position == bottom
end

#move_to(new_position) ⇒ Object

Moves this record at the given position, and updates positions of the impacted sibling records accordingly. If the new position is out of range, then the record is not moved.



199
200
201
202
203
204
 
# File 'lib/positionable.rb', line 199

def move_to(new_position)
  if range.include? new_position
    reorder(position, new_position)
    update_column(:position, new_position)
  end
end

#next ⇒ Object

The next sibling record, whose position is right after this record.



207
208
209
 
# File 'lib/positionable.rb', line 207

def next
  at(position + 1)
end

#previous ⇒ Object

Gives the next sibling record, whose position is right before this record.



225
226
227
 
# File 'lib/positionable.rb', line 225

def previous
  at(position - 1)
end

#up! ⇒ Object

Swaps this record position with his previous sibling, unless this record is the first one.



188
189
190
 
# File 'lib/positionable.rb', line 188

def up!
  swap_with(previous) unless first?
end