blunumericentry

README

BluNumericEntry

Um componente customizado para Fyne (Go) que fornece um campo de entrada numérica com validação, limites (min/max), incremento/decremento e botões de spin com auto-repeat (pressionar e segurar).

Ideal para formulários, configurações e interfaces desktop que precisam de controle numérico preciso.

---

✨ Recursos

• 🔢 Entrada somente numérica
• ➕➖ Incremento e decremento com passo configurável
• ⏫⏬ Botões de spin (▲ / ▼) com auto-repeat
• 🔒 Respeita valores mínimos e máximos
• 🔄 Callback OnChanged ao alterar valor
• 🖱️ Suporte a mouse, teclado e foco

---

📦 Instalação

go get github.com/bluiceoficial/blunumericentry

---

🚀 Uso básico

Numeric Entry simples

entry := blunumericentry.NewBluNumericEntry(0, 100, 10)

entry.OnChanged = func(v int) {
	fmt.Println("Valor alterado:", v)
}

---

Numeric Entry com botões de incremento/decremento

box, entry := blunumericentry.NewBluNumericEntryWithButtons(0, 100, 5)

entry.OnChanged = func(v int) {
	fmt.Println("Novo valor:", v)
}

w.SetContent(box)

---

⚙️ Propriedades principais

BluNumericEntry

Campo	Tipo	Descrição
Min	int	Valor mínimo permitido
Max	int	Valor máximo permitido
Value	int	Valor atual
OnChanged	func(int)	Callback ao alterar o valor

---

🧠 Métodos úteis

entry.GetValue()
entry.SetValue(42)

---

👤 Autor

Murilo Gomes Julio

🔗 https://www.bluice.com.br

📺 https://youtube.com/@bluiceoficial

---

License

Copyright (c) 2026 Murilo Gomes Julio

Licensed under the MIT license.

All contributions to the BluNumericEntry are subject to this license.

Documentation

Index

• type BluNumericEntry
  • func NewBluNumericEntry(min, max, initial int) *BluNumericEntry
  • func NewBluNumericEntryWithButtons(min, max, initial int) (fyne.CanvasObject, *BluNumericEntry)
  • func (e *BluNumericEntry) GetValue() int
  • func (e *BluNumericEntry) SetValue(v int)
  • func (e *BluNumericEntry) TypedKey(k *fyne.KeyEvent)
  • func (e *BluNumericEntry) TypedRune(r rune)
• type BluSmallButton
  • func (b *BluSmallButton) CreateRenderer() fyne.WidgetRenderer
  • func (b *BluSmallButton) MinSize() fyne.Size
  • func (b *BluSmallButton) MouseDown(ev *desktop.MouseEvent)
  • func (b *BluSmallButton) MouseIn(*desktop.MouseEvent)
  • func (b *BluSmallButton) MouseOut()
  • func (b *BluSmallButton) MouseUp(ev *desktop.MouseEvent)
  • func (b *BluSmallButton) Tapped(*fyne.PointEvent)
• type BluSmallButtonRenderer
  • func (r *BluSmallButtonRenderer) Destroy()
  • func (r *BluSmallButtonRenderer) Layout(size fyne.Size)
  • func (r *BluSmallButtonRenderer) MinSize() fyne.Size
  • func (r *BluSmallButtonRenderer) Objects() []fyne.CanvasObject
  • func (r *BluSmallButtonRenderer) Refresh()

Types

type BluNumericEntry

type BluNumericEntry struct {
	widget.Entry

	OnChanged func(int)
	// contains filtered or unexported fields
}

func NewBluNumericEntry

func NewBluNumericEntry(min, max, initial int) *BluNumericEntry

func NewBluNumericEntryWithButtons

func NewBluNumericEntryWithButtons(min, max, initial int) (fyne.CanvasObject, *BluNumericEntry)

func (*BluNumericEntry) GetValue

func (e *BluNumericEntry) GetValue() int

func (*BluNumericEntry) SetValue

func (e *BluNumericEntry) SetValue(v int)

func (*BluNumericEntry) TypedKey

func (e *BluNumericEntry) TypedKey(k *fyne.KeyEvent)

func (*BluNumericEntry) TypedRune

func (e *BluNumericEntry) TypedRune(r rune)

Permite apenas digitação de dígitos e sinal '-' (se min < 0)

type BluSmallButton

type BluSmallButton struct {
	widget.BaseWidget
	Label    string
	OnTapped func()
	// contains filtered or unexported fields
}

func (*BluSmallButton) CreateRenderer

func (b *BluSmallButton) CreateRenderer() fyne.WidgetRenderer

func (*BluSmallButton) MinSize

func (b *BluSmallButton) MinSize() fyne.Size

func (*BluSmallButton) MouseDown

func (b *BluSmallButton) MouseDown(ev *desktop.MouseEvent)

func (*BluSmallButton) MouseIn

func (b *BluSmallButton) MouseIn(*desktop.MouseEvent)

func (*BluSmallButton) MouseOut

func (b *BluSmallButton) MouseOut()

func (*BluSmallButton) MouseUp

func (b *BluSmallButton) MouseUp(ev *desktop.MouseEvent)

func (*BluSmallButton) Tapped

func (b *BluSmallButton) Tapped(*fyne.PointEvent)

type BluSmallButtonRenderer

type BluSmallButtonRenderer struct {
	// contains filtered or unexported fields
}

func (*BluSmallButtonRenderer) Destroy

func (r *BluSmallButtonRenderer) Destroy()

func (*BluSmallButtonRenderer) Layout

func (r *BluSmallButtonRenderer) Layout(size fyne.Size)

func (*BluSmallButtonRenderer) MinSize

func (r *BluSmallButtonRenderer) MinSize() fyne.Size

func (*BluSmallButtonRenderer) Objects

func (r *BluSmallButtonRenderer) Objects() []fyne.CanvasObject

func (*BluSmallButtonRenderer) Refresh

func (r *BluSmallButtonRenderer) Refresh()