binding

package
v2.7.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 12, 2025 License: BSD-3-Clause Imports: 11 Imported by: 499

Documentation

Overview

Package binding provides support for binding data to widgets. All APIs in the binding package are safe to invoke directly from any goroutine.

Index

Constants

View Source 
const DataTreeRootID = ""

DataTreeRootID const is the value used as ID for the root of any tree binding.

Variables

This section is empty.

Functions

This section is empty.

Types

type Bool 

type Bool = Item[bool]

Bool supports binding a bool value.

Since: 2.0

func And added in v2.4.0 

func And(data ...Bool) Bool

And returns a Bool binding that return true when all the passed Bool binding are true and false otherwise. It does apply a logical and boolean operation on all passed Bool bindings. This binding is two way. In case of a Set, it will propagate the value identically to all the Bool bindings used for its construction.

Since 2.4

func BindPreferenceBool 

func BindPreferenceBool(key string, p fyne.Preferences) Bool

BindPreferenceBool returns a bindable bool value that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.0

func NewBool 

func NewBool() Bool

NewBool returns a bindable bool value that is managed internally.

Since: 2.0

func Not added in v2.4.0 

func Not(data Bool) Bool

Not returns a Bool binding that invert the value of the given data binding. This is providing the logical Not boolean operation as a data binding.

Since 2.4

func Or added in v2.4.0 

func Or(data ...Bool) Bool

Or returns a Bool binding that return true when at least one of the passed Bool binding is true and false otherwise. It does apply a logical or boolean operation on all passed Bool bindings. This binding is two way. In case of a Set, it will propagate the value identically to all the Bool bindings used for its construction.

Since 2.4

func StringToBool 

func StringToBool(str String) Bool

StringToBool creates a binding that connects a String data item to a Bool. Changes to the String will be parsed and pushed to the Bool if the parse was successful, and setting the Bool update the String binding.

Since: 2.0

func StringToBoolWithFormat 

func StringToBoolWithFormat(str String, format string) Bool

StringToBoolWithFormat creates a binding that connects a String data item to a Bool and is presented using the specified format. Changes to the Bool will be parsed and if the format matches and the parse is successful it will be pushed to the String. Setting the Bool will push a formatted value into the String.

Since: 2.0

type BoolList 

type BoolList = List[bool]

BoolList supports binding a list of bool values.

Since: 2.0

func BindPreferenceBoolList added in v2.6.0 

func BindPreferenceBoolList(key string, p fyne.Preferences) BoolList

BindPreferenceBoolList returns a bound list of bool values that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.6

type BoolTree added in v2.4.0 

type BoolTree = Tree[bool]

BoolTree supports binding a tree of bool values.

Since: 2.4

type Bytes added in v2.2.0 

type Bytes = Item[[]byte]

Bytes supports binding a []byte value.

Since: 2.2

func NewBytes added in v2.2.0 

func NewBytes() Bytes

NewBytes returns a bindable []byte value that is managed internally.

Since: 2.2

type BytesList added in v2.2.0 

type BytesList = List[[]byte]

BytesList supports binding a list of []byte values.

Since: 2.2

type BytesTree added in v2.4.0 

type BytesTree = Tree[[]byte]

BytesTree supports binding a tree of []byte values.

Since: 2.4

type DataItem 

type DataItem interface {
	// AddListener attaches a new change listener to this DataItem.
	// Listeners are called each time the data inside this DataItem changes.
	// Additionally, the listener will be triggered upon successful connection to get the current value.
	AddListener(DataListener)
	// RemoveListener will detach the specified change listener from the DataItem.
	// Disconnected listener will no longer be triggered when changes occur.
	RemoveListener(DataListener)
}

DataItem is the base interface for all bindable data items. All APIs on bindable data items are safe to invoke directly fron any goroutine.

Since: 2.0

type DataList 

type DataList interface {
	DataItem
	GetItem(index int) (DataItem, error)
	Length() int
}

DataList is the base interface for all bindable data lists.

Since: 2.0

type DataListener 

type DataListener interface {
	DataChanged()
}

DataListener is any object that can register for changes in a bindable DataItem. See NewDataListener to define a new listener using just an inline function.

Since: 2.0

func NewDataListener 

func NewDataListener(fn func()) DataListener

NewDataListener is a helper function that creates a new listener type from a simple callback function.

Since: 2.0

type DataMap 

type DataMap interface {
	DataItem
	GetItem(string) (DataItem, error)
	Keys() []string
}

DataMap is the base interface for all bindable data maps.

Since: 2.0

type DataTree added in v2.4.0 

type DataTree interface {
	DataItem
	GetItem(id string) (DataItem, error)
	ChildIDs(string) []string
}

DataTree is the base interface for all bindable data trees.

Since: 2.4

type ExternalBool 

type ExternalBool = ExternalItem[bool]

ExternalBool supports binding a bool value to an external value.

Since: 2.0

func BindBool 

func BindBool(v *bool) ExternalBool

BindBool returns a new bindable value that controls the contents of the provided bool variable. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.0

type ExternalBoolList 

type ExternalBoolList = ExternalList[bool]

ExternalBoolList supports binding a list of bool values from an external variable.

Since: 2.0

type ExternalBoolTree added in v2.4.0 

type ExternalBoolTree = ExternalTree[bool]

ExternalBoolTree supports binding a tree of bool values from an external variable.

Since: 2.4

type ExternalBytes added in v2.2.0 

type ExternalBytes = ExternalItem[[]byte]

ExternalBytes supports binding a []byte value to an external value.

Since: 2.2

func BindBytes added in v2.2.0 

func BindBytes(v *[]byte) ExternalBytes

BindBytes returns a new bindable value that controls the contents of the provided []byte variable. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.2

type ExternalBytesList added in v2.2.0 

type ExternalBytesList = ExternalList[[]byte]

ExternalBytesList supports binding a list of []byte values from an external variable.

Since: 2.2

type ExternalBytesTree added in v2.4.0 

type ExternalBytesTree = ExternalTree[[]byte]

ExternalBytesTree supports binding a tree of []byte values from an external variable.

Since: 2.4

type ExternalFloat 

type ExternalFloat = ExternalItem[float64]

ExternalFloat supports binding a float64 value to an external value.

Since: 2.0

func BindFloat 

func BindFloat(v *float64) ExternalFloat

BindFloat returns a new bindable value that controls the contents of the provided float64 variable. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.0

type ExternalFloatList 

type ExternalFloatList = ExternalList[float64]

ExternalFloatList supports binding a list of float64 values from an external variable.

Since: 2.0

type ExternalFloatTree added in v2.4.0 

type ExternalFloatTree = ExternalTree[float64]

ExternalFloatTree supports binding a tree of float64 values from an external variable.

Since: 2.4

type ExternalInt 

type ExternalInt = ExternalItem[int]

ExternalInt supports binding a int value to an external value.

Since: 2.0

func BindInt 

func BindInt(v *int) ExternalInt

BindInt returns a new bindable value that controls the contents of the provided int variable. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.0

type ExternalIntList 

type ExternalIntList = ExternalList[int]

ExternalIntList supports binding a list of int values from an external variable.

Since: 2.0

type ExternalIntTree added in v2.4.0 

type ExternalIntTree = ExternalTree[int]

ExternalIntTree supports binding a tree of int values from an external variable.

Since: 2.4

type ExternalItem added in v2.6.0 

type ExternalItem[T any] interface {
	Item[T]
	Reload() error
}

ExternalItem supports binding any external value of type T.

Since: 2.6

func BindItem added in v2.6.0 

func BindItem[T any](val *T, comparator func(T, T) bool) ExternalItem[T]

BindItem returns a new bindable value that controls the contents of the provided variable of type T. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.6

type ExternalList added in v2.7.0 

type ExternalList[T any] interface {
	List[T]

	Reload() error
}

ExternalList supports binding a list of values, with type T, from an external variable.

Since: 2.7

func BindBoolList 

func BindBoolList(v *[]bool) ExternalList[bool]

BindBoolList returns a bound list of bool values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.0

func BindBytesList added in v2.2.0 

func BindBytesList(v *[][]byte) ExternalList[[]byte]

BindBytesList returns a bound list of []byte values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.2

func BindFloatList 

func BindFloatList(v *[]float64) ExternalList[float64]

BindFloatList returns a bound list of float64 values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.0

func BindIntList 

func BindIntList(v *[]int) ExternalList[int]

BindIntList returns a bound list of int values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.0

func BindList added in v2.7.0 

func BindList[T any](v *[]T, comparator func(T, T) bool) ExternalList[T]

BindList returns a bound list of values with type T, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.7

func BindRuneList 

func BindRuneList(v *[]rune) ExternalList[rune]

BindRuneList returns a bound list of rune values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.0

func BindStringList 

func BindStringList(v *[]string) ExternalList[string]

BindStringList returns a bound list of string values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.0

func BindURIList added in v2.1.0 

func BindURIList(v *[]fyne.URI) ExternalList[fyne.URI]

BindURIList returns a bound list of fyne.URI values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.1

func BindUntypedList added in v2.1.0 

func BindUntypedList(v *[]any) ExternalList[any]

BindUntypedList returns a bound list of any values, based on the contents of the passed slice. If your code changes the content of the slice this refers to you should call Reload() to inform the bindings.

Since: 2.1

type ExternalRune 

type ExternalRune = ExternalItem[rune]

ExternalRune supports binding a rune value to an external value.

Since: 2.0

func BindRune 

func BindRune(v *rune) ExternalRune

BindRune returns a new bindable value that controls the contents of the provided rune variable. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.0

type ExternalRuneList 

type ExternalRuneList = ExternalList[rune]

ExternalRuneList supports binding a list of rune values from an external variable.

Since: 2.0

type ExternalRuneTree added in v2.4.0 

type ExternalRuneTree = ExternalTree[rune]

ExternalRuneTree supports binding a tree of rune values from an external variable.

Since: 2.4

type ExternalString 

type ExternalString = ExternalItem[string]

ExternalString supports binding a string value to an external value.

Since: 2.0

func BindString 

func BindString(v *string) ExternalString

BindString returns a new bindable value that controls the contents of the provided string variable. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.0

type ExternalStringList 

type ExternalStringList = ExternalList[string]

ExternalStringList supports binding a list of string values from an external variable.

Since: 2.0

type ExternalStringTree added in v2.4.0 

type ExternalStringTree = ExternalTree[string]

ExternalStringTree supports binding a tree of string values from an external variable.

Since: 2.4

type ExternalTree added in v2.7.0 

type ExternalTree[T any] interface {
	Tree[T]

	Reload() error
}

ExternalTree supports binding a tree of values, of type T, from an external variable.

Since: 2.7

func BindBoolTree added in v2.4.0 

func BindBoolTree(ids *map[string][]string, v *map[string]bool) ExternalTree[bool]

BindBoolTree returns a bound tree of bool values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

func BindBytesTree added in v2.4.0 

func BindBytesTree(ids *map[string][]string, v *map[string][]byte) ExternalTree[[]byte]

BindBytesTree returns a bound tree of []byte values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

func BindFloatTree added in v2.4.0 

func BindFloatTree(ids *map[string][]string, v *map[string]float64) ExternalTree[float64]

BindFloatTree returns a bound tree of float64 values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

func BindIntTree added in v2.4.0 

func BindIntTree(ids *map[string][]string, v *map[string]int) ExternalTree[int]

BindIntTree returns a bound tree of int values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

func BindRuneTree added in v2.4.0 

func BindRuneTree(ids *map[string][]string, v *map[string]rune) ExternalTree[rune]

BindRuneTree returns a bound tree of rune values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

func BindStringTree added in v2.4.0 

func BindStringTree(ids *map[string][]string, v *map[string]string) ExternalTree[string]

BindStringTree returns a bound tree of string values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

func BindTree added in v2.7.0 

func BindTree[T any](ids *map[string][]string, v *map[string]T, comparator func(T, T) bool) ExternalTree[T]

BindTree returns a bound tree of values with type T, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.7

func BindURITree added in v2.4.0 

func BindURITree(ids *map[string][]string, v *map[string]fyne.URI) ExternalTree[fyne.URI]

BindURITree returns a bound tree of fyne.URI values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

func BindUntypedTree added in v2.5.0 

func BindUntypedTree(ids *map[string][]string, v *map[string]any) ExternalTree[any]

BindUntypedTree returns a bound tree of any values, based on the contents of the passed values. The ids map specifies how each item relates to its parent (with id ""), with the values being in the v map. If your code changes the content of the maps this refers to you should call Reload() to inform the bindings.

Since: 2.4

type ExternalURI added in v2.1.0 

type ExternalURI = ExternalItem[fyne.URI]

ExternalURI supports binding a fyne.URI value to an external value.

Since: 2.1

func BindURI added in v2.1.0 

func BindURI(v *fyne.URI) ExternalURI

BindURI returns a new bindable value that controls the contents of the provided fyne.URI variable. If your code changes the content of the variable this refers to you should call Reload() to inform the bindings.

Since: 2.1

type ExternalURIList added in v2.1.0 

type ExternalURIList = ExternalList[fyne.URI]

ExternalURIList supports binding a list of fyne.URI values from an external variable.

Since: 2.1

type ExternalURITree added in v2.4.0 

type ExternalURITree = ExternalTree[fyne.URI]

ExternalURITree supports binding a tree of fyne.URI values from an external variable.

Since: 2.4

type ExternalUntyped added in v2.1.0 

type ExternalUntyped = ExternalItem[any]

ExternalUntyped supports binding a any value to an external value.

Since: 2.1

func BindUntyped added in v2.1.0 

func BindUntyped(v any) ExternalUntyped

BindUntyped returns a bindable any value that is bound to an external type. The parameter must be a pointer to the type you wish to bind.

Since: 2.1

type ExternalUntypedList added in v2.1.0 

type ExternalUntypedList = ExternalList[any]

ExternalUntypedList supports binding a list of any values from an external variable.

Since: 2.1

type ExternalUntypedMap 

type ExternalUntypedMap interface {
	UntypedMap
	Reload() error
}

ExternalUntypedMap is a map data binding with all values untyped (any), connected to an external data source.

Since: 2.0

func BindUntypedMap 

func BindUntypedMap(d *map[string]any) ExternalUntypedMap

BindUntypedMap creates a new map binding of string to any based on the data passed. If your code changes the content of the map this refers to you should call Reload() to inform the bindings.

Since: 2.0

type ExternalUntypedTree added in v2.5.0 

type ExternalUntypedTree = ExternalTree[any]

ExternalUntypedTree supports binding a tree of any values from an external variable.

Since: 2.5

type Float 

type Float = Item[float64]

Float supports binding a float64 value.

Since: 2.0

func BindPreferenceFloat 

func BindPreferenceFloat(key string, p fyne.Preferences) Float

BindPreferenceFloat returns a bindable float64 value that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.0

func IntToFloat added in v2.5.0 

func IntToFloat(val Int) Float

IntToFloat creates a binding that connects an Int data item to a Float.

Since: 2.5

func NewFloat 

func NewFloat() Float

NewFloat returns a bindable float64 value that is managed internally.

Since: 2.0

func StringToFloat 

func StringToFloat(str String) Float

StringToFloat creates a binding that connects a String data item to a Float. Changes to the String will be parsed and pushed to the Float if the parse was successful, and setting the Float update the String binding.

Since: 2.0

func StringToFloatWithFormat 

func StringToFloatWithFormat(str String, format string) Float

StringToFloatWithFormat creates a binding that connects a String data item to a Float and is presented using the specified format. Changes to the Float will be parsed and if the format matches and the parse is successful it will be pushed to the String. Setting the Float will push a formatted value into the String.

Since: 2.0

type FloatList 

type FloatList = List[float64]

FloatList supports binding a list of float64 values.

Since: 2.0

func BindPreferenceFloatList added in v2.6.0 

func BindPreferenceFloatList(key string, p fyne.Preferences) FloatList

BindPreferenceFloatList returns a bound list of float64 values that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.6

type FloatTree added in v2.4.0 

type FloatTree = Tree[float64]

FloatTree supports binding a tree of float64 values.

Since: 2.4

type Int 

type Int = Item[int]

Int supports binding a int value.

Since: 2.0

func BindPreferenceInt 

func BindPreferenceInt(key string, p fyne.Preferences) Int

BindPreferenceInt returns a bindable int value that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.0

func FloatToInt added in v2.5.0 

func FloatToInt(v Float) Int

FloatToInt creates a binding that connects a Float data item to an Int.

Since: 2.5

func NewInt 

func NewInt() Int

NewInt returns a bindable int value that is managed internally.

Since: 2.0

func StringToInt 

func StringToInt(str String) Int

StringToInt creates a binding that connects a String data item to a Int. Changes to the String will be parsed and pushed to the Int if the parse was successful, and setting the Int update the String binding.

Since: 2.0

func StringToIntWithFormat 

func StringToIntWithFormat(str String, format string) Int

StringToIntWithFormat creates a binding that connects a String data item to a Int and is presented using the specified format. Changes to the Int will be parsed and if the format matches and the parse is successful it will be pushed to the String. Setting the Int will push a formatted value into the String.

Since: 2.0

type IntList 

type IntList = List[int]

IntList supports binding a list of int values.

Since: 2.0

func BindPreferenceIntList added in v2.6.0 

func BindPreferenceIntList(key string, p fyne.Preferences) IntList

BindPreferenceIntList returns a bound list of int values that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.6

type IntTree added in v2.4.0 

type IntTree = Tree[int]

IntTree supports binding a tree of int values.

Since: 2.4

type Item added in v2.6.0 

type Item[T any] interface {
	DataItem
	Get() (T, error)
	Set(T) error
}

Item supports binding any type T generically.

Since: 2.6

func NewItem added in v2.6.0 

func NewItem[T any](comparator func(T, T) bool) Item[T]

NewItem returns a bindable value of type T that is managed internally.

Since: 2.6

type List added in v2.7.0 

type List[T any] interface {
	DataList

	Append(value T) error
	Get() ([]T, error)
	GetValue(index int) (T, error)
	Prepend(value T) error
	Remove(value T) error
	Set(list []T) error
	SetValue(index int, value T) error
}

List supports binding a list of values with type T.

Since: 2.7

func NewBoolList 

func NewBoolList() List[bool]

NewBoolList returns a bindable list of bool values.

Since: 2.0

func NewBytesList added in v2.2.0 

func NewBytesList() List[[]byte]

NewBytesList returns a bindable list of []byte values.

Since: 2.2

func NewFloatList 

func NewFloatList() List[float64]

NewFloatList returns a bindable list of float64 values.

Since: 2.0

func NewIntList 

func NewIntList() List[int]

NewIntList returns a bindable list of int values.

Since: 2.0

func NewList added in v2.7.0 

func NewList[T any](comparator func(T, T) bool) List[T]

NewList returns a bindable list of values with type T.

Since: 2.7

func NewRuneList 

func NewRuneList() List[rune]

NewRuneList returns a bindable list of rune values.

Since: 2.0

func NewStringList 

func NewStringList() List[string]

NewStringList returns a bindable list of string values.

Since: 2.0

func NewURIList added in v2.1.0 

func NewURIList() List[fyne.URI]

NewURIList returns a bindable list of fyne.URI values.

Since: 2.1

func NewUntypedList added in v2.1.0 

func NewUntypedList() List[any]

NewUntypedList returns a bindable list of any values.

Since: 2.1

type Rune 

type Rune = Item[rune]

Rune supports binding a rune value.

Since: 2.0

func NewRune 

func NewRune() Rune

NewRune returns a bindable rune value that is managed internally.

Since: 2.0

type RuneList 

type RuneList = List[rune]

RuneList supports binding a list of rune values.

Since: 2.0

type RuneTree added in v2.4.0 

type RuneTree = Tree[rune]

RuneTree supports binding a tree of rune values.

Since: 2.4

type String 

type String = Item[string]

String supports binding a string value.

Since: 2.0

func BindPreferenceString 

func BindPreferenceString(key string, p fyne.Preferences) String

BindPreferenceString returns a bindable string value that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.0

func BoolToString 

func BoolToString(v Bool) String

BoolToString creates a binding that connects a Bool data item to a String. Changes to the Bool will be pushed to the String and setting the string will parse and set the Bool if the parse was successful.

Since: 2.0

func BoolToStringWithFormat 

func BoolToStringWithFormat(v Bool, format string) String

BoolToStringWithFormat creates a binding that connects a Bool data item to a String and is presented using the specified format. Changes to the Bool will be pushed to the String and setting the string will parse and set the Bool if the string matches the format and its parse was successful.

Since: 2.0

func FloatToString 

func FloatToString(v Float) String

FloatToString creates a binding that connects a Float data item to a String. Changes to the Float will be pushed to the String and setting the string will parse and set the Float if the parse was successful.

Since: 2.0

func FloatToStringWithFormat 

func FloatToStringWithFormat(v Float, format string) String

FloatToStringWithFormat creates a binding that connects a Float data item to a String and is presented using the specified format. Changes to the Float will be pushed to the String and setting the string will parse and set the Float if the string matches the format and its parse was successful.

Since: 2.0

func IntToString 

func IntToString(v Int) String

IntToString creates a binding that connects a Int data item to a String. Changes to the Int will be pushed to the String and setting the string will parse and set the Int if the parse was successful.

Since: 2.0

func IntToStringWithFormat 

func IntToStringWithFormat(v Int, format string) String

IntToStringWithFormat creates a binding that connects a Int data item to a String and is presented using the specified format. Changes to the Int will be pushed to the String and setting the string will parse and set the Int if the string matches the format and its parse was successful.

Since: 2.0

func NewSprintf added in v2.2.0 

func NewSprintf(format string, b ...DataItem) String

NewSprintf returns a String binding that format its content using the format string and the provide additional parameter that must be other data bindings. This data binding use fmt.Sprintf and fmt.Scanf internally and will have all the same limitation as those function.

Since: 2.2

func NewString 

func NewString() String

NewString returns a bindable string value that is managed internally.

Since: 2.0

func StringToStringWithFormat added in v2.2.0 

func StringToStringWithFormat(str String, format string) String

StringToStringWithFormat creates a binding that converts a string to another string using the specified format. Changes to the returned String will be pushed to the passed in String and setting a new string value will parse and set the underlying String if it matches the format and the parse was successful.

Since: 2.2

func URIToString added in v2.1.0 

func URIToString(v URI) String

URIToString creates a binding that connects a URI data item to a String. Changes to the URI will be pushed to the String and setting the string will parse and set the URI if the parse was successful.

Since: 2.1

type StringList 

type StringList = List[string]

StringList supports binding a list of string values.

Since: 2.0

func BindPreferenceStringList added in v2.6.0 

func BindPreferenceStringList(key string, p fyne.Preferences) StringList

BindPreferenceStringList returns a bound list of string values that is managed by the application preferences. Changes to this value will be saved to application storage and when the app starts the previous values will be read.

Since: 2.6

type StringTree added in v2.4.0 

type StringTree = Tree[string]

StringTree supports binding a tree of string values.

Since: 2.4

type Struct 

type Struct interface {
	DataMap
	GetValue(string) (any, error)
	SetValue(string, any) error
	Reload() error
}

Struct is the base interface for a bound struct type.

Since: 2.0

func BindStruct 

func BindStruct(i any) Struct

BindStruct creates a new map binding of string to any using the struct passed as data. The key for each item is a string representation of each exported field with the value set as an any. Only exported fields are included.

Since: 2.0

type Tree added in v2.7.0 

type Tree[T any] interface {
	DataTree

	Append(parent, id string, value T) error
	Get() (map[string][]string, map[string]T, error)
	GetValue(id string) (T, error)
	Prepend(parent, id string, value T) error
	Remove(id string) error
	Set(ids map[string][]string, values map[string]T) error
	SetValue(id string, value T) error
}

Tree supports binding a tree of values with type T.

Since: 2.7

func NewBoolTree added in v2.4.0 

func NewBoolTree() Tree[bool]

NewBoolTree returns a bindable tree of bool values.

Since: 2.4

func NewBytesTree added in v2.4.0 

func NewBytesTree() Tree[[]byte]

NewBytesTree returns a bindable tree of []byte values.

Since: 2.4

func NewFloatTree added in v2.4.0 

func NewFloatTree() Tree[float64]

NewFloatTree returns a bindable tree of float64 values.

Since: 2.4

func NewIntTree added in v2.4.0 

func NewIntTree() Tree[int]

NewIntTree returns a bindable tree of int values.

Since: 2.4

func NewRuneTree added in v2.4.0 

func NewRuneTree() Tree[rune]

NewRuneTree returns a bindable tree of rune values.

Since: 2.4

func NewStringTree added in v2.4.0 

func NewStringTree() Tree[string]

NewStringTree returns a bindable tree of string values.

Since: 2.4

func NewTree added in v2.7.0 

func NewTree[T any](comparator func(T, T) bool) Tree[T]

NewTree returns a bindable tree of values with type T.

Since: 2.7

func NewURITree added in v2.4.0 

func NewURITree() Tree[fyne.URI]

NewURITree returns a bindable tree of fyne.URI values.

Since: 2.4

func NewUntypedTree added in v2.5.0 

func NewUntypedTree() Tree[any]

NewUntypedTree returns a bindable tree of any values.

Since: 2.5

type URI added in v2.1.0 

type URI = Item[fyne.URI]

URI supports binding a fyne.URI value.

Since: 2.1

func NewURI added in v2.1.0 

func NewURI() URI

NewURI returns a bindable fyne.URI value that is managed internally.

Since: 2.1

func StringToURI added in v2.1.0 

func StringToURI(str String) URI

StringToURI creates a binding that connects a String data item to a URI. Changes to the String will be parsed and pushed to the URI if the parse was successful, and setting the URI update the String binding.

Since: 2.1

type URIList added in v2.1.0 

type URIList = List[fyne.URI]

URIList supports binding a list of fyne.URI values.

Since: 2.1

type URITree added in v2.4.0 

type URITree = Tree[fyne.URI]

URITree supports binding a tree of fyne.URI values.

Since: 2.4

type Untyped 

type Untyped = Item[any]

Untyped supports binding an any value.

Since: 2.1

func NewUntyped added in v2.1.0 

func NewUntyped() Untyped

NewUntyped returns a bindable any value that is managed internally.

Since: 2.1

type UntypedList added in v2.1.0 

type UntypedList = List[any]

UntypedList supports binding a list of any values.

Since: 2.1

type UntypedMap 

type UntypedMap interface {
	DataMap
	Delete(string)
	Get() (map[string]any, error)
	GetValue(string) (any, error)
	Set(map[string]any) error
	SetValue(string, any) error
}

UntypedMap is a map data binding with all values Untyped (any).

Since: 2.0

func NewUntypedMap 

func NewUntypedMap() UntypedMap

NewUntypedMap creates a new, empty map binding of string to any.

Since: 2.0

type UntypedTree added in v2.5.0 

type UntypedTree = Tree[any]

UntypedTree supports binding a tree of any values.

Since: 2.5

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.