InputField for LÖVE enables simple handling of user text input into your program. The library is a single file with no external dependencies. MIT license.
You can download the latest release or clone the repository.
- Different field types: Single-line, multi-line (with or without wrapping), password (obscured characters).
- Text cursor and navigation (by keyboard and mouse).
- Text selection.
- Scrolling, both vertical and horizontal.
- Text alignment.
- Shortcuts for common operations, like copying selected text or deleting the next word.
- Undo and redo (history).
- Helper functions for rendering.
The library does not do any rendering itself, but provides helper functions for rendering text, cursors and selections.
local InputField = require("InputField")
local field = InputField("Initial text.")
local fieldX = 80
local fieldY = 50
love.keyboard.setKeyRepeat(true)
function love.keypressed(key, scancode, isRepeat)
field:keypressed(key, isRepeat)
end
function love.textinput(text)
field:textinput(text)
end
function love.mousepressed(mx, my, mbutton, pressCount)
field:mousepressed(mx-fieldX, my-fieldY, mbutton, pressCount)
end
function love.mousemoved(mx, my)
field:mousemoved(mx-fieldX, my-fieldY)
end
function love.mousereleased(mx, my, mbutton)
field:mousereleased(mx-fieldX, my-fieldY, mbutton)
end
function love.wheelmoved(dx, dy)
field:wheelmoved(dx, dy)
end
function love.draw()
love.graphics.setColor(0, 0, 1)
for _, x, y, w, h in field:eachSelection() do
love.graphics.rectangle("fill", fieldX+x, fieldY+y, w, h)
end
love.graphics.setColor(1, 1, 1)
for _, text, x, y in field:eachVisibleLine() do
love.graphics.print(text, fieldX+x, fieldY+y)
end
local x, y, h = field:getCursorLayout()
love.graphics.rectangle("fill", fieldX+x, fieldY+y, 1, h)
endSee the library file for documentation, or the examples folder for more elaborate example programs.