binding

package
v2.5.3 Latest Latest
Warning

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

 Go to latest Published: Dec 15, 2024 License: BSD-3-Clause Imports: 11 Imported by: 409

Documentation

Overview

Package binding provides support for binding data to widgets.

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 interface {
	DataItem
	Get() (bool, error)
	Set(bool) error
}

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 interface {
	DataList

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

BoolList supports binding a list of bool values.

Since: 2.0

func NewBoolList 

func NewBoolList() BoolList

NewBoolList returns a bindable list of bool values.

Since: 2.0

type BoolTree added in v2.4.0 

type BoolTree interface {
	DataTree

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

BoolTree supports binding a tree of bool values.

Since: 2.4

func NewBoolTree added in v2.4.0 

func NewBoolTree() BoolTree

NewBoolTree returns a bindable tree of bool values.

Since: 2.4

type Bytes added in v2.2.0 

type Bytes interface {
	DataItem
	Get() ([]byte, error)
	Set([]byte) error
}

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 interface {
	DataList

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

BytesList supports binding a list of []byte values.

Since: 2.2

func NewBytesList added in v2.2.0 

func NewBytesList() BytesList

NewBytesList returns a bindable list of []byte values.

Since: 2.2

type BytesTree added in v2.4.0 

type BytesTree interface {
	DataTree

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

BytesTree supports binding a tree of []byte values.

Since: 2.4

func NewBytesTree added in v2.4.0 

func NewBytesTree() BytesTree

NewBytesTree returns a bindable 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.

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 interface {
	Bool
	Reload() error
}

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 interface {
	BoolList

	Reload() error
}

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

Since: 2.0

func BindBoolList 

func BindBoolList(v *[]bool) ExternalBoolList

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

type ExternalBoolTree added in v2.4.0 

type ExternalBoolTree interface {
	BoolTree

	Reload() error
}

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

Since: 2.4

func BindBoolTree added in v2.4.0 

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

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

type ExternalBytes added in v2.2.0 

type ExternalBytes interface {
	Bytes
	Reload() error
}

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 interface {
	BytesList

	Reload() error
}

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

Since: 2.2

func BindBytesList added in v2.2.0 

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

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

type ExternalBytesTree added in v2.4.0 

type ExternalBytesTree interface {
	BytesTree

	Reload() error
}

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

Since: 2.4

func BindBytesTree added in v2.4.0 

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

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

type ExternalFloat 

type ExternalFloat interface {
	Float
	Reload() error
}

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 interface {
	FloatList

	Reload() error
}

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

Since: 2.0

func BindFloatList 

func BindFloatList(v *[]float64) ExternalFloatList

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

type ExternalFloatTree added in v2.4.0 

type ExternalFloatTree interface {
	FloatTree

	Reload() error
}

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

Since: 2.4

func BindFloatTree added in v2.4.0 

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

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

type ExternalInt 

type ExternalInt interface {
	Int
	Reload() error
}

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 interface {
	IntList

	Reload() error
}

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

Since: 2.0

func BindIntList 

func BindIntList(v *[]int) ExternalIntList

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

type ExternalIntTree added in v2.4.0 

type ExternalIntTree interface {
	IntTree

	Reload() error
}

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

Since: 2.4

func BindIntTree added in v2.4.0 

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

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

type ExternalRune 

type ExternalRune interface {
	Rune
	Reload() error
}

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 interface {
	RuneList

	Reload() error
}

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

Since: 2.0

func BindRuneList 

func BindRuneList(v *[]rune) ExternalRuneList

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

type ExternalRuneTree added in v2.4.0 

type ExternalRuneTree interface {
	RuneTree

	Reload() error
}

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

Since: 2.4

func BindRuneTree added in v2.4.0 

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

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

type ExternalString 

type ExternalString interface {
	String
	Reload() error
}

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 interface {
	StringList

	Reload() error
}

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

Since: 2.0

func BindStringList 

func BindStringList(v *[]string) ExternalStringList

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

type ExternalStringTree added in v2.4.0 

type ExternalStringTree interface {
	StringTree

	Reload() error
}

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

Since: 2.4

func BindStringTree added in v2.4.0 

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

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

type ExternalURI added in v2.1.0 

type ExternalURI interface {
	URI
	Reload() error
}

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 interface {
	URIList

	Reload() error
}

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

Since: 2.1

func BindURIList added in v2.1.0 

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

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

type ExternalURITree added in v2.4.0 

type ExternalURITree interface {
	URITree

	Reload() error
}

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

Since: 2.4

func BindURITree added in v2.4.0 

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

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

type ExternalUntyped added in v2.1.0 

type ExternalUntyped interface {
	Untyped
	Reload() error
}

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 interface {
	UntypedList

	Reload() error
}

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

Since: 2.1

func BindUntypedList added in v2.1.0 

func BindUntypedList(v *[]any) ExternalUntypedList

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 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 interface {
	UntypedTree

	Reload() error
}

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

Since: 2.5

func BindUntypedTree added in v2.5.0 

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

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 Float 

type Float interface {
	DataItem
	Get() (float64, error)
	Set(float64) error
}

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 interface {
	DataList

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

FloatList supports binding a list of float64 values.

Since: 2.0

func NewFloatList 

func NewFloatList() FloatList

NewFloatList returns a bindable list of float64 values.

Since: 2.0

type FloatTree added in v2.4.0 

type FloatTree interface {
	DataTree

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

FloatTree supports binding a tree of float64 values.

Since: 2.4

func NewFloatTree added in v2.4.0 

func NewFloatTree() FloatTree

NewFloatTree returns a bindable tree of float64 values.

Since: 2.4

type Int 

type Int interface {
	DataItem
	Get() (int, error)
	Set(int) error
}

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 interface {
	DataList

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

IntList supports binding a list of int values.

Since: 2.0

func NewIntList 

func NewIntList() IntList

NewIntList returns a bindable list of int values.

Since: 2.0

type IntTree added in v2.4.0 

type IntTree interface {
	DataTree

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

IntTree supports binding a tree of int values.

Since: 2.4

func NewIntTree added in v2.4.0 

func NewIntTree() IntTree

NewIntTree returns a bindable tree of int values.

Since: 2.4

type Rune 

type Rune interface {
	DataItem
	Get() (rune, error)
	Set(rune) error
}

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 interface {
	DataList

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

RuneList supports binding a list of rune values.

Since: 2.0

func NewRuneList 

func NewRuneList() RuneList

NewRuneList returns a bindable list of rune values.

Since: 2.0

type RuneTree added in v2.4.0 

type RuneTree interface {
	DataTree

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

RuneTree supports binding a tree of rune values.

Since: 2.4

func NewRuneTree added in v2.4.0 

func NewRuneTree() RuneTree

NewRuneTree returns a bindable tree of rune values.

Since: 2.4

type String 

type String interface {
	DataItem
	Get() (string, error)
	Set(string) error
}

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 interface {
	DataList

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

StringList supports binding a list of string values.

Since: 2.0

func NewStringList 

func NewStringList() StringList

NewStringList returns a bindable list of string values.

Since: 2.0

type StringTree added in v2.4.0 

type StringTree interface {
	DataTree

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

StringTree supports binding a tree of string values.

Since: 2.4

func NewStringTree added in v2.4.0 

func NewStringTree() StringTree

NewStringTree returns a bindable 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 URI added in v2.1.0 

type URI interface {
	DataItem
	Get() (fyne.URI, error)
	Set(fyne.URI) error
}

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 interface {
	DataList

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

URIList supports binding a list of fyne.URI values.

Since: 2.1

func NewURIList added in v2.1.0 

func NewURIList() URIList

NewURIList returns a bindable list of fyne.URI values.

Since: 2.1

type URITree added in v2.4.0 

type URITree interface {
	DataTree

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

URITree supports binding a tree of fyne.URI values.

Since: 2.4

func NewURITree added in v2.4.0 

func NewURITree() URITree

NewURITree returns a bindable tree of fyne.URI values.

Since: 2.4

type Untyped 

type Untyped interface {
	DataItem
	Get() (any, error)
	Set(any) error
}

Untyped supports binding a 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 interface {
	DataList

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

UntypedList supports binding a list of any values.

Since: 2.1

func NewUntypedList added in v2.1.0 

func NewUntypedList() UntypedList

NewUntypedList returns a bindable 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 interface {
	DataTree

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

UntypedTree supports binding a tree of any values.

Since: 2.5

func NewUntypedTree added in v2.5.0 

func NewUntypedTree() UntypedTree

NewUntypedTree returns a bindable 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.