Guides

Annotation List (BOTA)

The BOTA (Book of Annotations) panel provides three tabs: outline, bookmarks, and annotation list. The annotation list displays summary information for all annotations in the document, supporting browsing, navigation, replies, and batch operations.

BOTA Tab Configuration

Control the tabs displayed in the BOTA panel via global.bota.tabs:

{
  "global": {
    "bota": {
      "tabs": ["outline", "bookmark", "annotations"]
    }
  }
}

Value	Description
outline	Document outline / table of contents
bookmark	Bookmarks
annotations	Annotation list

To show only the annotation list:

{
  "global": {
    "bota": {
      "tabs": ["annotations"]
    }
  }
}

Annotation List Menu Configuration

Configure annotation list menus via global.bota.menus.annotations.

Global Menu

The global menu is located at the top of the annotation list and applies to the entire list:

{
  "global": {
    "bota": {
      "menus": {
        "annotations": {
          "global": [
            { "id": "importAnnotation" },
            { "id": "exportAnnotation" },
            { "id": "removeAllAnnotation" },
            { "id": "removeAllReply" }
          ]
        }
      }
    }
  }
}

id	Description
importAnnotation	Import annotations in XFDF format
exportAnnotation	Export annotations in XFDF format
removeAllAnnotation	Remove all annotations
removeAllReply	Remove all annotation replies

Item Menu

The item menu applies to individual annotation entries, shown on long press of an annotation item:

{
  "global": {
    "bota": {
      "menus": {
        "annotations": {
          "item": [
            {
              "id": "reviewStatus",
              "subMenus": ["accepted", "rejected", "cancelled", "completed", "none"]
            },
            { "id": "markedStatus" },
            {
              "id": "more",
              "subMenus": ["addReply", "viewReply", "delete"]
            }
          ]
        }
      }
    }
  }
}

id	Description
reviewStatus	Review status, with sub-menus: accepted, rejected, cancelled, completed, none
markedStatus	Toggle marked status
more	More actions, with sub-menus: addReply (add reply), viewReply (view replies), delete (delete annotation)

Core Components

CPDFAnnotationListFragment

The main Fragment for the annotation list, located in the com.compdfkit.tools.annotation.pdfannotationlist package.

Features include:

• Display all annotations grouped by page number
• Show annotation type icon, content summary, author, and timestamp
• Click an annotation entry to navigate to its location in the document
• Support for review status and marked status settings

Annotation Replies

The annotation list supports adding and viewing replies to annotations:

Component	Description
CPDFEditReplyDialogFragment	Dialog for editing reply content
CPDFReplyDetailsDialogFragment	Dialog for viewing reply details
CPDFAnnotReplyListAdapter	Reply list adapter
CMarkedTipsWindow	Marked status tip window

BOTA Panel Components

Component	Description
CPDFBotaDialogFragment	BOTA panel dialog
CPDFBotaFragmentTabs	Tab container
CPDFBookmarkFragment	Bookmark list (viewer package)
CPDFOutlineFragment	Outline/TOC list (viewer package)