VCOO0005

OmniOutliner: Delete Descendants

This command will delete every item contained in the selected item (descendants). If no item is selected, then all of the outline items will be removed.

NOTE: This command presents a confirmation dialog to the user.

Scope and Syntax

Language: English (United States 🇺🇸 · Great Britain 🇬🇧 · Australia 🇦🇺 · Canada 🇨🇦)

Scope: OmniOutliner

Command phrase variations (words in [brackets] are optional):

• “Delete Descendants”

Requirements

• Application: OmniOutliner: 5.10 (macOS), OmniOutliner 3.9.1 (iOS/iPadOS)
• System: macOS 12, iOS 15, iPadOS 15

Downloads

• ⇩ COMMANDS-FILE (OmniOutliner 5) (macOS)
• ⇩ SHORTCUT-LINK (“Delete Descendants”) (iOS/iPadOS)

Script Code

Here is the script code:

Delete Descendants
Copy

(async () => {
	try {
		function createUtterance(textToSpeak){
			AlexID = (
				(app.platformName === "macOS") ? 
				"com.apple.speech.synthesis.voice.Alex" : 
				"com.apple.speech.voice.Alex"
			)
			voiceObj = Speech.Voice.withIdentifier(AlexID)
			voiceRate = 0.4
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = voiceRate
			return utterance
		}
		var synthesizer = new Speech.Synthesizer()
		
		try {document.name} catch(err){
			throw {name:"Missing Resource", message:"No outline document is open."}
		}
		
		var editor = document.editors[0]
		selectedItems = editor.selection.items
		if(selectedItems.length === 0){
			alertTitle = "CONFIRMATION REQUIRED"
			alertMessage = "Delete all of the items in the outline?"
			alert = new Alert(alertTitle, alertMessage)
			alert.addOption("Stop")
			alert.addOption("Delete")
			
			utterance = createUtterance(alertMessage)
			synthesizer.speakUtterance(utterance)
			
			index = await alert.show()
			if(index === 0){throw {name:"SCRIPT CANCELED", message:"Stopped"}}
			rootItem.descendants.reverse().forEach(item => {
				item.remove()
			})
		} else if(selectedItems.length === 1){
			alertTitle = "CONFIRMATION REQUIRED"
			alertMessage = "Delete all descendants of the selected item?"
			alert = new Alert(alertTitle, alertMessage)
			alert.addOption("Stop")
			alert.addOption("Delete")
			
			utterance = createUtterance(alertMessage)
			synthesizer.speakUtterance(utterance)
			
			index = await alert.show()
			if(index === 0){throw {name:"SCRIPT CANCELED", message:"Stopped"}}
			selectedItem = selectedItems[0]
			selectedItem.descendants.reverse().forEach(item => {
				item.remove()
			})
		} else {
			throw {
				name: "Selection Issue",
				message: "This command requires, that either nothing is selected, or a single row is selected."
			}
		}
		
		utterance = createUtterance("Done!")
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		if(!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			//new Alert(err.name, err.message).show()
		}	
	}
})();