如何在Boomla中实现类似DOM的nextSibling的文件同级节点查找？

Nice to see you bringing DOM traversal intuition to Boomla file handling! Let's break down how to replicate that behavior for finding sibling file nodes, covering both your specific use cases.

1. Next Sibling Within the Same Placeholder #

Just like DOM's nextElementSibling targets the next sibling element in the same parent, Boomla has a direct method for getting the next file in the same placeholder:

Use the File::next() method. It returns the immediate next sibling file in the current parent placeholder, or null if the current file is the last one in that placeholder.

// Get the current file context
$currentFile = boomla()->file();

// Fetch next sibling in the same placeholder
$nextSibling = $currentFile->next();

// $nextSibling will be null if current is the last file here

This is the closest direct match to what nextElementSibling does in the DOM—focused entirely on the same parent container.

2. Next Sibling Across All Placeholders (Global Traversal) #

If you need to keep traversing past the end of the current placeholder (moving to the first file of the next placeholder, and so on until there are no more files), you'll need a small custom helper function. Boomla doesn't have a built-in one-liner for this, but it's easy to build using core node methods:

/**
 * Get the next file node across all sibling placeholders
 * Returns null if there are no more files left
 */
function getNextGlobalFileSibling(\Boomla\File $currentFile) {
    // First check for a sibling in the same placeholder
    $nextLocal = $currentFile->next();
    if ($nextLocal !== null) {
        return $nextLocal;
    }

    // If none, traverse to the next placeholder and check its first child
    $parentPlaceholder = $currentFile->parent();
    while ($parentPlaceholder !== null) {
        $nextPlaceholder = $parentPlaceholder->next();
        if ($nextPlaceholder !== null) {
            $firstFileInNextPlaceholder = $nextPlaceholder->firstChild();
            if ($firstFileInNextPlaceholder !== null) {
                return $firstFileInNextPlaceholder;
            }
            // If the placeholder is empty, keep checking the next one
            $parentPlaceholder = $nextPlaceholder;
        } else {
            // No more placeholders to check
            return null;
        }
    }

    return null;
}

// Usage example
$currentFile = boomla()->file();
$nextGlobalSibling = getNextGlobalFileSibling($currentFile);

Here's how this works step-by-step:

• First, it checks if there's a next sibling in the current placeholder (using the same next() method as before).
• If not, it moves to the parent placeholder's next sibling.
• For each subsequent placeholder, it grabs the first child file—if one exists, that's our next node.
• If a placeholder is empty, it keeps moving to the next placeholder until it finds a file or runs out of placeholders entirely.

Key Boomla Methods Used #

• $file->next(): Gets the immediate next sibling node
• $file->parent(): Gets the parent placeholder node
• $placeholder->firstChild(): Gets the first file inside a placeholder

内容的提问来源于stack exchange，提问作者Bernát