Class Bookmark

This record is used to persist the information for a bookmark.

A bookmark is an object that registers a PDF action, usually triggered to go to a page.

Example

Creating a bookmark for the 3rd page of a document.

const bookmark = new NutrientViewer.Bookmark({
  name: 'test bookmark',
  action: new NutrientViewer.Actions.GoToAction({ pageIndex: 3 })
});
instance.create(bookmark);

See

Hierarchy

Record<
    {
        action: null
        | NutrientViewer.Actions.Action;
        id: null | string;
        name: null | string;
        pdfBookmarkId: null | string;
    },
    this,
> & Readonly<
    {
        action: null
        | NutrientViewer.Actions.Action;
        id: null | string;
        name: null | string;
        pdfBookmarkId: null | string;
    },
>
- Bookmark

Properties

action

action: NutrientViewer.Actions.Action

The action that will be triggered when the bookmark is either clicked or tapped.

Please refer to NutrientViewer.Actions for an in-depth look at PDF actions.

id

id: string

A unique identifier to describe the bookmark. When a bookmark is created in the UI, the viewer has to generate a unique ID.

When changes are saved to the underlying bookmark provider, we call Instance#ensureChangesSaved to make sure the annotation has been persisted from the provider.

`Readonly`name

name: null | string

optional

An optional name to associate to the bookmark.

Default

null

`Readonly`pdfBookmarkId

pdfBookmarkId: null | string

When the bookmark is extracted directly from a PDF file, the pdfBookmarkId refers to the identifier that was used in the PDF document.

This ID is optional since newly created bookmarks using the SYNCProvider annotation provider won't have a pdfBookmarkId assigned.

Default

null

`Static`toSerializableObject

toSerializableObject: (bookmark: NutrientViewer.Bookmark) => BookmarkJSON = toJSON

Bookmark serializer. Converts a bookmark to InstantJSON compliant objects.

Methods

[iterator]

"[iterator]"(): IterableIterator<
    [
        keyof {
            action: null
            | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
        null
        | string
        | number
        | NutrientViewer.Actions.Action,
    ],
>
Returns IterableIterator<
    [
        keyof {
            action: null
            | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
        null
        | string
        | number
        | NutrientViewer.Actions.Action,
    ],
>
Inherited from Immutable.Record<BookmarkProps>(defaultValues).[iterator]

asImmutable

asImmutable(): this
Returns this
See
Map#asImmutable

Inherited from Immutable.Record<BookmarkProps>(defaultValues).asImmutable

asMutable

asMutable(): this
Returns this
See
Map#asMutable

Inherited from Immutable.Record<BookmarkProps>(defaultValues).asMutable

clear

clear(): this
Returns a new instance of this Record type with all values set to their default values.

Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).clear

delete

delete<
    K extends
        keyof {
            action: null
            | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
>(
    key: K,
): this
Returns a new instance of this Record type with the value for the specific key set to its default value.
Type Parameters
- K extends keyof {
      action: null | NutrientViewer.Actions.Action;
      id: null | string;
      name: null | string;
      pdfBookmarkId: null | string;
  }
Parameters
- key: K
Returns this
Alias
remove

Inherited from Immutable.Record<BookmarkProps>(defaultValues).delete

deleteIn

deleteIn(keyPath: Iterable<any>): this
Parameters
- keyPath: Iterable<any>
Returns this
Alias
removeIn

Inherited from Immutable.Record<BookmarkProps>(defaultValues).deleteIn

equals

equals(other: any): boolean
Parameters
- other: any
Returns boolean
Inherited from Immutable.Record<BookmarkProps>(defaultValues).equals

get

get<
    K extends
        keyof {
            action: null
            | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
>(
    key: K,
    notSetValue?: any,
): {
    action: null | NutrientViewer.Actions.Action;
    id: null | string;
    name: null | string;
    pdfBookmarkId: null | string;
}[K]
Returns the value associated with the provided key, which may be the default value defined when creating the Record factory function.

If the requested key is not defined by this Record type, then notSetValue will be returned if provided. Note that this scenario would produce an error when using Flow or TypeScript.
Type Parameters
- K extends keyof {
      action: null | NutrientViewer.Actions.Action;
      id: null | string;
      name: null | string;
      pdfBookmarkId: null | string;
  }
Parameters
- key: K
- OptionalnotSetValue: any
Returns {
    action: null | NutrientViewer.Actions.Action;
    id: null | string;
    name: null | string;
    pdfBookmarkId: null | string;
}[K]
Inherited from Immutable.Record<BookmarkProps>(defaultValues).get
get<T>(key: string, notSetValue: T): T
Type Parameters
- T
Parameters
- key: string
- notSetValue: T
Returns T
Inherited from Immutable.Record<BookmarkProps>(defaultValues).get

getIn

getIn(keyPath: Iterable<any>): any
Parameters
- keyPath: Iterable<any>
Returns any
Inherited from Immutable.Record<BookmarkProps>(defaultValues).getIn

has

has(key: string): key is "id" | "name" | "action" | "pdfBookmarkId" | "sortKey"
Parameters
- key: string
Returns key is "id" | "name" | "action" | "pdfBookmarkId" | "sortKey"
Inherited from Immutable.Record<BookmarkProps>(defaultValues).has

hashCode

hashCode(): number
Returns number
Inherited from Immutable.Record<BookmarkProps>(defaultValues).hashCode

hasIn

hasIn(keyPath: Iterable<any>): boolean
Parameters
- keyPath: Iterable<any>
Returns boolean
Inherited from Immutable.Record<BookmarkProps>(defaultValues).hasIn

merge

merge(
    ...collections: (
        | Iterable<[string, any]>
        | Partial<
            {
                action: null
                | NutrientViewer.Actions.Action;
                id: null | string;
                name: null | string;
                pdfBookmarkId: null | string;
            },
        >
    )[],
): this
Parameters
- ...collections: (
      | Iterable<[string, any]>
      | Partial<
          {
              action: null
              | NutrientViewer.Actions.Action;
              id: null | string;
              name: null | string;
              pdfBookmarkId: null | string;
          },
      >
  )[]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).merge

mergeDeep

mergeDeep(
    ...collections: (
        | Iterable<[string, any]>
        | Partial<
            {
                action: null
                | NutrientViewer.Actions.Action;
                id: null | string;
                name: null | string;
                pdfBookmarkId: null | string;
            },
        >
    )[],
): this
Parameters
- ...collections: (
      | Iterable<[string, any]>
      | Partial<
          {
              action: null
              | NutrientViewer.Actions.Action;
              id: null | string;
              name: null | string;
              pdfBookmarkId: null | string;
          },
      >
  )[]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).mergeDeep

mergeDeepIn

mergeDeepIn(keyPath: Iterable<any>, ...collections: any[]): this
Parameters
- keyPath: Iterable<any>
- ...collections: any[]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).mergeDeepIn

mergeDeepWith

mergeDeepWith(
    merger: (oldVal: any, newVal: any, key: any) => any,
    ...collections: (
        | Iterable<[string, any]>
        | Partial<
            {
                action: null
                | NutrientViewer.Actions.Action;
                id: null | string;
                name: null | string;
                pdfBookmarkId: null | string;
            },
        >
    )[],
): this
Parameters
- merger: (oldVal: any, newVal: any, key: any) => any
- ...collections: (
      | Iterable<[string, any]>
      | Partial<
          {
              action: null
              | NutrientViewer.Actions.Action;
              id: null | string;
              name: null | string;
              pdfBookmarkId: null | string;
          },
      >
  )[]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).mergeDeepWith

mergeIn

mergeIn(keyPath: Iterable<any>, ...collections: any[]): this
Parameters
- keyPath: Iterable<any>
- ...collections: any[]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).mergeIn

mergeWith

mergeWith(
    merger: (
        oldVal: any,
        newVal: any,
        key: keyof {
            action: null | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
    ) => any,
    ...collections: (
        | Iterable<[string, any]>
        | Partial<
            {
                action: null
                | NutrientViewer.Actions.Action;
                id: null | string;
                name: null | string;
                pdfBookmarkId: null | string;
            },
        >
    )[],
): this
Parameters
- merger: (
      oldVal: any,
      newVal: any,
      key: keyof {
          action: null | NutrientViewer.Actions.Action;
          id: null | string;
          name: null | string;
          pdfBookmarkId: null | string;
      },
  ) => any
- ...collections: (
      | Iterable<[string, any]>
      | Partial<
          {
              action: null
              | NutrientViewer.Actions.Action;
              id: null | string;
              name: null | string;
              pdfBookmarkId: null | string;
          },
      >
  )[]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).mergeWith

remove

remove<
    K extends
        keyof {
            action: null
            | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
>(
    key: K,
): this
Type Parameters
- K extends keyof {
      action: null | NutrientViewer.Actions.Action;
      id: null | string;
      name: null | string;
      pdfBookmarkId: null | string;
  }
Parameters
- key: K
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).remove

removeIn

removeIn(keyPath: Iterable<any>): this
Parameters
- keyPath: Iterable<any>
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).removeIn

set

set<
    K extends
        keyof {
            action: null
            | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
>(
    key: K,
    value: {
        action: null | NutrientViewer.Actions.Action;
        id: null | string;
        name: null | string;
        pdfBookmarkId: null | string;
    }[K],
): this
Type Parameters
- K extends keyof {
      action: null | NutrientViewer.Actions.Action;
      id: null | string;
      name: null | string;
      pdfBookmarkId: null | string;
  }
Parameters
- key: K
- value: {
      action: null | NutrientViewer.Actions.Action;
      id: null | string;
      name: null | string;
      pdfBookmarkId: null | string;
  }[K]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).set

setIn

setIn(keyPath: Iterable<any>, value: any): this
Parameters
- keyPath: Iterable<any>
- value: any
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).setIn

toJS

toJS(): { action: any; id: any; name: any; pdfBookmarkId: any }
Deeply converts this Record to equivalent native JavaScript Object.

Note: This method may not be overridden. Objects with custom serialization to plain JS may override toJSON() instead.

Returns { action: any; id: any; name: any; pdfBookmarkId: any }
- action: any
  The action that will be triggered when the bookmark is either clicked or tapped.
  
  Please refer to NutrientViewer.Actions for an in-depth look at PDF actions.
- id: any
  A unique identifier to describe the bookmark. When a bookmark is created in the UI, the viewer has to generate a unique ID.
  
  When changes are saved to the underlying bookmark provider, we call Instance#ensureChangesSaved to make sure the annotation has been persisted from the provider.
- name: any
  optional
  
  An optional name to associate to the bookmark.
  Default
  null
- pdfBookmarkId: any
  When the bookmark is extracted directly from a PDF file, the pdfBookmarkId refers to the identifier that was used in the PDF document.
  
  This ID is optional since newly created bookmarks using the SYNCProvider annotation provider won't have a pdfBookmarkId assigned.
  Default
  null
Inherited from Immutable.Record<BookmarkProps>(defaultValues).toJS

toJSON

toJSON(): {
    action: null
    | NutrientViewer.Actions.Action;
    id: null | string;
    name: null | string;
    pdfBookmarkId: null | string;
}
Shallowly converts this Record to equivalent native JavaScript Object.

Returns {
    action: null | NutrientViewer.Actions.Action;
    id: null | string;
    name: null | string;
    pdfBookmarkId: null | string;
}
- action: null | NutrientViewer.Actions.Action
  The action that will be triggered when the bookmark is either clicked or tapped.
  
  Please refer to NutrientViewer.Actions for an in-depth look at PDF actions.
- id: null | string
  A unique identifier to describe the bookmark. When a bookmark is created in the UI, the viewer has to generate a unique ID.
  
  When changes are saved to the underlying bookmark provider, we call Instance#ensureChangesSaved to make sure the annotation has been persisted from the provider.
- name: null | string
  optional
  
  An optional name to associate to the bookmark.
  Default
  null
- pdfBookmarkId: null | string
  When the bookmark is extracted directly from a PDF file, the pdfBookmarkId refers to the identifier that was used in the PDF document.
  
  This ID is optional since newly created bookmarks using the SYNCProvider annotation provider won't have a pdfBookmarkId assigned.
  Default
  null
Inherited from Immutable.Record<BookmarkProps>(defaultValues).toJSON

toObject

toObject(): {
    action: null
    | NutrientViewer.Actions.Action;
    id: null | string;
    name: null | string;
    pdfBookmarkId: null | string;
}
Shallowly converts this Record to equivalent JavaScript Object.

Returns {
    action: null | NutrientViewer.Actions.Action;
    id: null | string;
    name: null | string;
    pdfBookmarkId: null | string;
}
- action: null | NutrientViewer.Actions.Action
  The action that will be triggered when the bookmark is either clicked or tapped.
  
  Please refer to NutrientViewer.Actions for an in-depth look at PDF actions.
- id: null | string
  A unique identifier to describe the bookmark. When a bookmark is created in the UI, the viewer has to generate a unique ID.
  
  When changes are saved to the underlying bookmark provider, we call Instance#ensureChangesSaved to make sure the annotation has been persisted from the provider.
- name: null | string
  optional
  
  An optional name to associate to the bookmark.
  Default
  null
- pdfBookmarkId: null | string
  When the bookmark is extracted directly from a PDF file, the pdfBookmarkId refers to the identifier that was used in the PDF document.
  
  This ID is optional since newly created bookmarks using the SYNCProvider annotation provider won't have a pdfBookmarkId assigned.
  Default
  null
Inherited from Immutable.Record<BookmarkProps>(defaultValues).toObject

toSeq

toSeq(): Keyed<
    keyof {
        action: null
        | NutrientViewer.Actions.Action;
        id: null | string;
        name: null | string;
        pdfBookmarkId: null | string;
    },
    null
    | string
    | number
    | NutrientViewer.Actions.Action,
>
Returns Keyed<
    keyof {
        action: null
        | NutrientViewer.Actions.Action;
        id: null | string;
        name: null | string;
        pdfBookmarkId: null | string;
    },
    null
    | string
    | number
    | NutrientViewer.Actions.Action,
>
Inherited from Immutable.Record<BookmarkProps>(defaultValues).toSeq

update

update<
    K extends
        keyof {
            action: null
            | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        },
>(
    key: K,
    updater: (
        value: {
            action: null | NutrientViewer.Actions.Action;
            id: null | string;
            name: null | string;
            pdfBookmarkId: null | string;
        }[K],
    ) => {
        action: null
        | NutrientViewer.Actions.Action;
        id: null | string;
        name: null | string;
        pdfBookmarkId: null | string;
    }[K],
): this
Type Parameters
- K extends keyof {
      action: null | NutrientViewer.Actions.Action;
      id: null | string;
      name: null | string;
      pdfBookmarkId: null | string;
  }
Parameters
- key: K
- updater: (
      value: {
          action: null | NutrientViewer.Actions.Action;
          id: null | string;
          name: null | string;
          pdfBookmarkId: null | string;
      }[K],
  ) => {
      action: null
      | NutrientViewer.Actions.Action;
      id: null | string;
      name: null | string;
      pdfBookmarkId: null | string;
  }[K]
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).update

updateIn

updateIn(keyPath: Iterable<any>, updater: (value: any) => any): this
Parameters
- keyPath: Iterable<any>
- updater: (value: any) => any
Returns this
Inherited from Immutable.Record<BookmarkProps>(defaultValues).updateIn

wasAltered

wasAltered(): boolean
Returns boolean
See
Map#wasAltered

Inherited from Immutable.Record<BookmarkProps>(defaultValues).wasAltered

withMutations

withMutations(mutator: (mutable: this) => any): this
Note: Not all methods can be used on a mutable collection or within withMutations! Only set may be used mutatively.
Parameters
- mutator: (mutable: this) => any
Returns this
See
Map#withMutations

Inherited from Immutable.Record<BookmarkProps>(defaultValues).withMutations

`Static`fromSerializableObject

fromSerializableObject(bookmark: BookmarkJSON): NutrientViewer.Bookmark
Bookmark deserializer. Converts a bookmark object to a NutrientViewer.Bookmark.
Parameters
- bookmark: BookmarkJSON
Returns NutrientViewer.Bookmark

Class Bookmark

Example

See

Hierarchy

Index

Properties

Methods

Properties

action

id

Readonlyname

Default

ReadonlypdfBookmarkId

Default

StatictoSerializableObject

Methods

[iterator]

Returns IterableIterator< [ keyof { action: null | NutrientViewer.Actions.Action; id: null | string; name: null | string; pdfBookmarkId: null | string; }, null | string | number | NutrientViewer.Actions.Action, ],>

asImmutable

Returns this

See

asMutable

Returns this

See

clear

Returns this

delete

Type Parameters

Parameters

Returns this

Alias

deleteIn

Parameters

Returns this

Alias

equals

Parameters

Returns boolean

get

Type Parameters

Parameters

Returns { action: null | NutrientViewer.Actions.Action; id: null | string; name: null | string; pdfBookmarkId: null | string;}[K]

Type Parameters

Parameters

Returns T

getIn

Parameters

Returns any

has

Parameters

Returns key is "id" | "name" | "action" | "pdfBookmarkId" | "sortKey"

hashCode

Returns number

hasIn

Parameters

Returns boolean

merge

Parameters

Returns this

mergeDeep

Parameters

Returns this

mergeDeepIn

Parameters

Returns this

mergeDeepWith

Parameters

Returns this

mergeIn

Parameters

Returns this

mergeWith

Parameters

Returns this

remove

Type Parameters

Parameters

Returns this

removeIn

Parameters

`Readonly`name

`Readonly`pdfBookmarkId

`Static`toSerializableObject

Returns IterableIterator<
[
keyof {
action: null
| NutrientViewer.Actions.Action;
id: null | string;
name: null | string;
pdfBookmarkId: null | string;
},
null
| string
| number
| NutrientViewer.Actions.Action,
],
>

Returns {
action: null | NutrientViewer.Actions.Action;
id: null | string;
name: null | string;
pdfBookmarkId: null | string;
}[K]

Returns {
action: null | NutrientViewer.Actions.Action;
id: null | string;
name: null | string;
pdfBookmarkId: null | string;
}

Returns {
action: null | NutrientViewer.Actions.Action;
id: null | string;
name: null | string;
pdfBookmarkId: null | string;
}

Returns Keyed<
keyof {
action: null
| NutrientViewer.Actions.Action;
id: null | string;
name: null | string;
pdfBookmarkId: null | string;
},
null
| string
| number
| NutrientViewer.Actions.Action,
>

`Static`fromSerializableObject