Class: Tuile::Component::List::Cursor

Inherits:
Object
  • Object
show all
Defined in:
lib/tuile/component/list.rb,
sig/tuile.rbs

Overview

Tracks cursor position within the list.

Defined Under Namespace

Classes: Limited, None

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(position: 0) ⇒ Cursor

@param position — the initial cursor position.

Parameters:

  • position: (Integer) (defaults to: 0) 


467
468
469
470
471
 
# File 'lib/tuile/component/list.rb', line 467

def initialize(position: 0)
  raise "invalid position #{position}" unless position.is_a? Integer

  @position = position
end

Instance Attribute Details

#position ⇒ Integer (readonly)

@return — 0-based item index of the current cursor position.

Returns:

  • (Integer) 


514
515
516
 
# File 'lib/tuile/component/list.rb', line 514

def position
  @position
end

Instance Method Details

#candidate_positions(item_count) ⇒ ::Array[Integer]

@param item_count — number of items in the list.

@return — positions the cursor can land on, in ascending order.

Parameters:

  • item_count (Integer)

Returns:

  • (::Array[Integer]) 


519
520
521
 
# File 'lib/tuile/component/list.rb', line 519

def candidate_positions(item_count)
  (0...item_count).to_a
end

#go(new_position) ⇒ Boolean

Moves the cursor to the new position. Public only because of testing.

@param new_position — new 0-based cursor position.

@return — true if the position changed.

Parameters:

  • new_position (Integer)

Returns:

  • (Boolean) 


561
562
563
564
565
566
567
 
# File 'lib/tuile/component/list.rb', line 561

def go(new_position)
  new_position = new_position.clamp(0, nil)
  return false if @position == new_position

  @position = new_position
  true
end

#go_down_by(count, item_count) ⇒ Boolean

@param count

@param item_count

Parameters:

  • count (Integer)
  • item_count (Integer)

Returns:

  • (Boolean) 


583
584
585
 
# File 'lib/tuile/component/list.rb', line 583

def go_down_by(count, item_count)
  go((@position + count).clamp(nil, item_count - 1))
end

#go_to_first ⇒ Boolean

Returns:

  • (Boolean) 


594
595
596
 
# File 'lib/tuile/component/list.rb', line 594

def go_to_first
  go(0)
end

#go_to_last(item_count) ⇒ Boolean

Moves the cursor to the last reachable position. For base Tuile::Component::List::Cursor, the last item; Limited clamps to the last allowed position; None is a no-op.

@param item_count — number of items in the list.

@return — true if the position changed.

Parameters:

  • item_count (Integer)

Returns:

  • (Boolean) 


574
575
576
 
# File 'lib/tuile/component/list.rb', line 574

def go_to_last(item_count)
  go(item_count - 1)
end

#go_up_by(count) ⇒ Boolean

@param count

Parameters:

  • count (Integer)

Returns:

  • (Boolean) 


589
590
591
 
# File 'lib/tuile/component/list.rb', line 589

def go_up_by(count)
  go(@position - count)
end

#handle_key?(key, item_count, viewport_rows) ⇒ Boolean

@param key — pressed keyboard key.

@param item_count — number of items in the list.

@param viewport_rows — number of visible rows.

@return — true if the cursor moved.

Parameters:

  • key (String)
  • item_count (Integer)
  • viewport_rows (Integer)

Returns:

  • (Boolean) 


527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
 
# File 'lib/tuile/component/list.rb', line 527

def handle_key?(key, item_count, viewport_rows)
  case key
  when *Keys::DOWN_ARROWS
    go_down_by(1, item_count)
  when *Keys::UP_ARROWS
    go_up_by(1)
  when *Keys::HOMES
    go_to_first
  when *Keys::ENDS_
    go_to_last(item_count)
  when Keys::CTRL_U
    go_up_by(viewport_rows / 2)
  when Keys::CTRL_D
    go_down_by(viewport_rows / 2, item_count)
  else
    false
  end
end

#handle_mouse_down?(item_index, event, item_count) ⇒ Boolean

@param item_index — the item pressed on.

@param event — the event.

@param item_count — number of items in the list.

@return — true if the cursor moved.

Parameters:

Returns:

  • (Boolean) 


550
551
552
553
554
555
556
 
# File 'lib/tuile/component/list.rb', line 550

def handle_mouse_down?(item_index, event, item_count)
  if event.button == :left
    go(item_index.clamp(nil, item_count - 1))
  else
    false
  end
end