Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

3.9 KB
Raw Blame
// SiYuan - https://github.com/siyuan-note/siyuan
// Copyright (c) 2020-present, b3log.org
// SPDX-License-Identifier: AGPL-3.0-or-later

package treenode

import (
	"fmt"
	"strings"

	"github.com/88250/lute/ast"
	"github.com/siyuan-note/siyuan/kernel/util"
)

const (
	TabsActiveIDAttr = "tabs-active-id"
	TabsPositionAttr = "tabs-position"
)

// TabsActiveItem 返回选中的直属页签项,属性缺失或失效时回退到第一页。
func TabsActiveItem(tabs *ast.Node) (ret *ast.Node) {
	if nil == tabs || ast.NodeTabs != tabs.Type {
		return
	}
	activeID := tabs.IALAttr(TabsActiveIDAttr)
	for item := tabs.FirstChild; nil != item; item = item.Next {
		if ast.NodeTabItem != item.Type {
			continue
		}
		if nil == ret {
			ret = item
		}
		if item.ID == activeID {
			return item
		}
	}
	return
}

// ValidateTabsAttrs 在修改属性前校验页签属性,避免部分属性已写入后才发现错误。
func ValidateTabsAttrs(node *ast.Node, attrs map[string]string) error {
	for name, value := range attrs {
		name = strings.ToLower(name)
		if TabsActiveIDAttr != name && TabsPositionAttr != name {
			continue
		}
		if nil == node || ast.NodeTabs != node.Type {
			return fmt.Errorf("attribute [%s] is only supported on tab containers", name)
		}
		value = strings.TrimSpace(util.RemoveInvalidRetainCtrl(value))
		if "" == value {
			continue
		}
		if TabsPositionAttr == name {
			if "top" != value && "left" != value {
				return fmt.Errorf("invalid tabs position [%s]", value)
			}
			continue
		}
		found := false
		for item := node.FirstChild; nil != item; item = item.Next {
			if ast.NodeTabItem == item.Type && item.ID == value {
				found = true
				break
			}
		}
		if !found {
			return fmt.Errorf("active tab [%s] is not a direct child of [%s]", value, node.ID)
		}
	}
	return nil
}

// NormalizeTabs 修复空页和无效选中项,保留所有已有内容及块标识。
func NormalizeTabs(root *ast.Node) (changed bool) {
	if nil == root {
		return
	}
	ast.Walk(root, func(node *ast.Node, entering bool) ast.WalkStatus {
		if entering {
			return ast.WalkContinue
		}
		if ast.NodeTabItem == node.Type {
			if !hasContentChild(node) {
				node.AppendChild(NewParagraph(""))
				changed = true
			}
			return ast.WalkContinue
		}
		if ast.NodeTabs != node.Type {
			return ast.WalkContinue
		}
		if nil == TabsActiveItem(node) {
			item := &ast.Node{Type: ast.NodeTabItem, ID: ast.NewNodeID()}
			item.SetIALAttr("id", item.ID)
			item.SetIALAttr("updated", util.TimeFromID(item.ID))
			item.AppendChild(NewParagraph(""))
			node.AppendChild(item)
			changed = true
		}
		if active := TabsActiveItem(node); nil != active && node.IALAttr(TabsActiveIDAttr) != active.ID {
			node.SetIALAttr(TabsActiveIDAttr, active.ID)
			changed = true
		}
		if position := node.IALAttr(TabsPositionAttr); "" != position && "top" != position && "left" != position {
			node.SetIALAttr(TabsPositionAttr, "top")
			changed = true
		}
		return ast.WalkContinue
	})
	return
}

func hasContentChild(node *ast.Node) bool {
	for child := node.FirstChild; nil != child; child = child.Next {
		if isContentBlock(child) && !child.IsTabTitleBlock() {
			return true
		}
	}
	return false
}

// RemapTabsActiveIDs 将复制、模板和导入生成的新块标识应用到选中状态。
func RemapTabsActiveIDs(root *ast.Node, ids map[string]string) {
	ast.Walk(root, func(node *ast.Node, entering bool) ast.WalkStatus {
		if entering && ast.NodeTabs == node.Type {
			if activeID := ids[node.IALAttr(TabsActiveIDAttr)]; "" != activeID {
				node.SetIALAttr(TabsActiveIDAttr, activeID)
			}
		}
		return ast.WalkContinue
	})
}

// TabTitleParagraph 将标题解析为临时行级内容,引用和资源仍归属于原页签项。
func TabTitleParagraph(item *ast.Node) *ast.Node {
	if nil == item || ast.NodeTabItem != item.Type || nil != item.TabTitleBlock() || "" == item.TabItemTitle {
		return nil
	}
	return inlineTitleParagraph(item, item.TabItemTitle)
}