ItemName

Represents a JSKOS item (concept or concept scheme) with its notation and label.

Uses dragAndDrop and is draggable by default.

Props

• item object, required
  JSKOS item
• showNotation boolean, default true
  whether to show the item's notation
• showLabel boolean, default true
  whether to show the item's label (prefLabel)
• fallbackLabel string, default "???"
  • string that will be shown if both notation and label are empty
• language string, default undefined
  • preferred language for the label
  • default: uses jskos-tools' languagePreference
• clickable boolean, default false
  adjusts mouse pointer and text decoration on hover if true
• draggable boolean, default true
  whether the item is draggable

Plugins for notations and labels

You can adjust how notations/labels are processed in ItemName by providing plugins. A plugin is a simple function that receives the current label/notation and the component's props as parameters and returns the processed label/notation. Plugins can be added on the imported component directly using the provided addLabelPlugin and addNotationPlugin methods.

For example, you can use the following snippet to add trailing zeros to DDC notations in the first two levels:

import { ItemName } from "jskos-vue"
ItemName.addNotationPlugin((notation, { item }) => {
  let fill = ""
  // For DDC and SDNB only: fill number notation with trailing zeros
  if (jskos.compare({
    uri : "http://dewey.info/scheme/edition/e23/",
    identifier : [
      "http://bartoc.org/en/node/241",
      "http://bartoc.org/en/node/18497",
      "http://www.wikidata.org/entity/Q67011877",
      "http://id.loc.gov/vocabulary/classSchemes/sdnb",
      "http://uri.gbv.de/terminology/sdnb",
    ],
  }, item.inScheme && item.inScheme[0]) && !isNaN(parseInt(notation))) {
    while (notation.length + fill.length < 3) {
      fill += "0"
    }
  }
  if (fill.length) {
    // Using the shared `jskos-vue-text-lightGrey` CSS class
    notation += `<span class='jskos-vue-text-lightGrey'>${fill}</span>`
  }
  return notation
})

Another use case is showing item identifiers in CURIE syntax.

Examples

PreviewSource Code

Change language: - - -

• EX
• EX Example
• ???