Documentation / jpl-vite / api / SettingItem

Interface: SettingItem

Defined in: joplin-plugin-api/dist/types.d.ts:309

Properties

advanced?

optional advanced: boolean

Defined in: joplin-plugin-api/dist/types.d.ts:354

An advanced setting will be moved under the "Advanced" button in the config screen.

---

appTypes?

optional appTypes: AppType[]

Defined in: joplin-plugin-api/dist/types.d.ts:344

Reserved property. Not used at the moment.

---

description?

optional description: string

Defined in: joplin-plugin-api/dist/types.d.ts:318

---

isEnum?

optional isEnum: boolean

Defined in: joplin-plugin-api/dist/types.d.ts:335

To create a setting with multiple options, set this property to true. That setting will render as a dropdown list in the configuration screen.

---

label

label: string

Defined in: joplin-plugin-api/dist/types.d.ts:317

---

maximum?

optional maximum: number

Defined in: joplin-plugin-api/dist/types.d.ts:360

---

minimum?

optional minimum: number

Defined in: joplin-plugin-api/dist/types.d.ts:359

Set the min, max and step values if you want to restrict an int setting to a particular range.

---

options?

optional options: Record<any, any>

Defined in: joplin-plugin-api/dist/types.d.ts:340

This property is required when isEnum is true. In which case, it should contain a map of value => label.

---

public

public: boolean

Defined in: joplin-plugin-api/dist/types.d.ts:325

A public setting will appear in the Configuration screen and will be modifiable by the user. A private setting however will not appear there, and can only be changed programmatically. You may use this to store some values that you do not want to directly expose.

---

section?

optional section: string

Defined in: joplin-plugin-api/dist/types.d.ts:330

You would usually set this to a section you would have created specifically for the plugin.

---

secure?

optional secure: boolean

Defined in: joplin-plugin-api/dist/types.d.ts:349

Set this to true to store secure data, such as passwords. Any such setting will be stored in the system keychain if one is available.

---

step?

optional step: number

Defined in: joplin-plugin-api/dist/types.d.ts:361

---

storage?

optional storage: SettingStorage

Defined in: joplin-plugin-api/dist/types.d.ts:365

Either store the setting in the database or in settings.json. Defaults to database.

---

subType?

optional subType: SettingItemSubType

Defined in: joplin-plugin-api/dist/types.d.ts:316

Currently only used to display a file or directory selector. Always set type to SettingItemType.String when using this property.

---

type

type: SettingItemType

Defined in: joplin-plugin-api/dist/types.d.ts:311

---

value

value: any

Defined in: joplin-plugin-api/dist/types.d.ts:310