[Share] Shortcut for adding tags to an annotation

[Phidet97]

Description

Hi all,

I just wanted to share my little code for adding tags to a selected annotation, i.e. a highlighted portion of text in the Zotero PDF Viewer.
I use annotation tags to categorize text snippets while doing research before extracting citations, notes and tags to Obsidian. That way, when writing my manuscript in Obsidian, I can filter exported citations there via annotation tags.

Weirdly, the option of using a shortcut to quickly open up the annotation tag window was not implemented, at least not that I could find.

Anyway, here's how it works:
Paste the code into a new Action Script and assign a hotkey. Highlight a text portion inside the Zotero PDF Viewer to create an annotation. Select that text or annotation box and hit the hotkey. A window pops up, asking to insert tags. You can enter multiple tags separated by a blank space, each word being added as a separate tag.

Hope some of you will find this useful!

Event

None

Operation

Script

Data

/**
 * Add multiple annotation tags to a selected annotation; multiple tags can be entered, separated by spaces (each word resulting in a separate tag). To be used inside the Zotero PDF Viewer
 * @author Phidet97
 * @link https://github.com/windingwind/zotero-actions-tags/discussions/458
 */

const window = require("window");

(async function () {
    if (window.batchTagRunning) return;
    window.batchTagRunning = true;

    // Get items to edit based on user selection
    async function getItemsToEdit(item, items) {
        if (items && items.length > 0) return items;
        if (item) return [item];
        return null;
    }

    // Function to add tags
    async function addTagsToItems(tags, items) {
        const promises = items.map(async item => {
            tags.forEach(tag => item.addTag(tag.trim()));
            await item.saveTx();
        });
        await Promise.all(promises);
    }

    try {
        if (!items && !item) {
            window.batchTagRunning = false;
            return;
        }

        let itemsToEdit = await getItemsToEdit(item, items);
        if (!itemsToEdit) {
            window.batchTagRunning = false;
            return;
        }

        const tagsInput = window.prompt("Enter tags (separated by spaces):");
        if (tagsInput) {
            const tags = tagsInput.split(/\s+/).filter(tag => tag.length > 0);
            if (tags.length > 0) {
                await addTagsToItems(tags, itemsToEdit);
            }
        }
    } catch (error) {
        // No error handling needed
    } finally {
        window.batchTagRunning = false;
    }
})();

Anything else

No response