rui_orig/detailsView.go

package rui

import "strings"

// Constants for [DetailsView] specific properties and events
const (
	// Summary is the constant for "summary" property tag.
	//
	// Used by `DetailsView`.
	// The content of this property is used as the label for the disclosure widget.
	//
	// Supported types: `string`, `View`.
	//
	// `string` - Summary as a text.
	// `View` - Summary as a view, in this case it can be quite complex if needed.
	Summary = "summary"

	// Expanded is the constant for "expanded" property tag.
	//
	// Used by `DetailsView`.
	// Controls the content expanded state of the details view. Default value is `false`.
	//
	// Supported types: `bool`, `int`, `string`.
	//
	// Values:
	// `true` or `1` or "true", "yes", "on", "1" - Content is visible.
	// `false` or `0` or "false", "no", "off", "0" - Content is collapsed(hidden).
	Expanded = "expanded"
)

// DetailsView represent a DetailsView view, which is a collapsible container of views
type DetailsView interface {
	ViewsContainer
}

type detailsViewData struct {
	viewsContainerData
}

// NewDetailsView create new DetailsView object and return it
func NewDetailsView(session Session, params Params) DetailsView {
	view := new(detailsViewData)
	view.init(session)
	setInitParams(view, params)
	return view
}

func newDetailsView(session Session) View {
	return NewDetailsView(session, nil)
}

// Init initialize fields of DetailsView by default values
func (detailsView *detailsViewData) init(session Session) {
	detailsView.viewsContainerData.init(session)
	detailsView.tag = "DetailsView"
	//detailsView.systemClass = "ruiDetailsView"
}

func (detailsView *detailsViewData) Views() []View {
	views := detailsView.viewsContainerData.Views()
	if summary := detailsView.get(Summary); summary != nil {
		switch summary := summary.(type) {
		case View:
			return append([]View{summary}, views...)
		}
	}
	return views
}

func (detailsView *detailsViewData) Remove(tag string) {
	detailsView.remove(strings.ToLower(tag))
}

func (detailsView *detailsViewData) remove(tag string) {
	detailsView.viewsContainerData.remove(tag)
	if detailsView.created {
		switch tag {
		case Summary:
			updateInnerHTML(detailsView.htmlID(), detailsView.Session())

		case Expanded:
			detailsView.session.removeProperty(detailsView.htmlID(), "open")
		}
	}
}

func (detailsView *detailsViewData) Set(tag string, value any) bool {
	return detailsView.set(strings.ToLower(tag), value)
}

func (detailsView *detailsViewData) set(tag string, value any) bool {
	if value == nil {
		detailsView.remove(tag)
		return true
	}

	switch tag {
	case Summary:
		switch value := value.(type) {
		case string:
			detailsView.properties[Summary] = value

		case View:
			detailsView.properties[Summary] = value
			value.setParentID(detailsView.htmlID())

		case DataObject:
			if view := CreateViewFromObject(detailsView.Session(), value); view != nil {
				detailsView.properties[Summary] = view
				view.setParentID(detailsView.htmlID())
			} else {
				return false
			}

		default:
			notCompatibleType(tag, value)
			return false
		}
		if detailsView.created {
			updateInnerHTML(detailsView.htmlID(), detailsView.Session())
		}

	case Expanded:
		if !detailsView.setBoolProperty(tag, value) {
			notCompatibleType(tag, value)
			return false
		}
		if detailsView.created {
			if IsDetailsExpanded(detailsView) {
				detailsView.session.updateProperty(detailsView.htmlID(), "open", "")
			} else {
				detailsView.session.removeProperty(detailsView.htmlID(), "open")
			}
		}

	case NotTranslate:
		if !detailsView.viewData.set(tag, value) {
			return false
		}
		if detailsView.created {
			updateInnerHTML(detailsView.htmlID(), detailsView.Session())
		}

	default:
		return detailsView.viewsContainerData.Set(tag, value)
	}

	detailsView.propertyChangedEvent(tag)
	return true
}

func (detailsView *detailsViewData) Get(tag string) any {
	return detailsView.get(strings.ToLower(tag))
}

func (detailsView *detailsViewData) get(tag string) any {
	return detailsView.viewsContainerData.get(tag)
}

func (detailsView *detailsViewData) htmlTag() string {
	return "details"
}

func (detailsView *detailsViewData) htmlProperties(self View, buffer *strings.Builder) {
	detailsView.viewsContainerData.htmlProperties(self, buffer)
	buffer.WriteString(` ontoggle="detailsEvent(this)"`)
	if IsDetailsExpanded(detailsView) {
		buffer.WriteString(` open`)
	}
}

func (detailsView *detailsViewData) htmlSubviews(self View, buffer *strings.Builder) {
	if value, ok := detailsView.properties[Summary]; ok {
		switch value := value.(type) {
		case string:
			if !GetNotTranslate(detailsView) {
				value, _ = detailsView.session.GetString(value)
			}
			buffer.WriteString("<summary>")
			buffer.WriteString(value)
			buffer.WriteString("</summary>")

		case View:
			buffer.WriteString("<summary>")
			viewHTML(value, buffer)
			buffer.WriteString("</summary>")
		}
	}

	detailsView.viewsContainerData.htmlSubviews(self, buffer)
}

func (detailsView *detailsViewData) handleCommand(self View, command string, data DataObject) bool {
	if command == "details-open" {
		if n, ok := dataIntProperty(data, "open"); ok {
			detailsView.properties[Expanded] = (n != 0)
			detailsView.propertyChangedEvent(Expanded)
		}
		return true
	}
	return detailsView.viewsContainerData.handleCommand(self, command, data)
}

// GetDetailsSummary returns a value of the Summary property of DetailsView.
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
func GetDetailsSummary(view View, subviewID ...string) View {
	if len(subviewID) > 0 && subviewID[0] != "" {
		view = ViewByID(view, subviewID[0])
	}
	if view != nil {
		if value := view.Get(Summary); value != nil {
			switch value := value.(type) {
			case string:
				return NewTextView(view.Session(), Params{Text: value})

			case View:
				return value
			}
		}
	}
	return nil
}

// IsDetailsExpanded returns a value of the Expanded property of DetailsView.
// If the second argument (subviewID) is not specified or it is "" then a value from the first argument (view) is returned.
func IsDetailsExpanded(view View, subviewID ...string) bool {
	return boolStyledProperty(view, subviewID, Expanded, false)
}