jskos-vue

ItemSelect ​

Pick one item at a time (JSKOS concepts, schemes, languages, …) via:

ItemSelect does not keep a selection list. It only emits the picked item. If you want to show/edit a list, combine it with ItemSelected in your app.

Props ​

  • options array, default [] — local options (small static lists like languages).

  • search function — remote search function in OpenSearch Suggest format (see ItemSuggest). Default is based on options (if set) or on registry.suggest (if both registry and scheme are set).

  • resolve function — optional async resolver to turn a selected URI into a full JSKOS item object when it is not available in the internal suggestion cache. Default is based on options (if set) or on registry.getConcepts (if available).

  • minChars number, default 1 — minimum query length before searching (applies to options and search).

  • registry object, default null — Registry to load concepts from

  • scheme object, default null — Concept Scheme to load concepts from. Must have field uri or identifier at least.

  • treeConcepts array — top concepts for the ConceptTree browser below the input.
    Default is loaded via registry.getTop if both registry and scheme are set.

  • placeholder string, default "Search…" —

ConceptTree integration ​

  • treeConcepts array, default [] — top concepts for the ConceptTree browser below the input.
    default: [] (no tree is shown for empty array)

  • treeLoadNarrower function — called when a tree node is opened; should load narrower.

Optional resolving ​

  • resolve function optional async resolver to turn a selected URI into a full item object
    when it is not available in the internal suggestion cache.
    Signature: async (uri) => item

UI ​

  • placeholder string, default "Search…" — input placeholder.

See concept loading of ConceptTree for background information on registry and scheme.

Slots ​

The default slot is shown between input field and hierarchy.

Events ​

  • select — emitted when an item is picked (via typeahead or tree). Payload is usually a normalized item. If resolving is not possible, it may fall back to { uri }.

Behavior notes ​

Before emitting select, items are normalized:

  • __label is kept or selected from prefLabel with jskos-tools.
  • prefLabel.und is added for display. Existing labels are kept.
  • notation is kept. If missing, jskos-tools tries to derive it from the item URI and scheme.

ItemSuggest emits only { uri }. ItemSelect caches the current suggestion result set so it can emit a full object when available. If the URI is not cached, resolve(uri) can provide the item.

The hierarchy browser starts collapsed. Selecting via typeahead opens it and tries to show the selected concept. If the tree is closed and opened again, the selected concept is synced again.

Methods ​

Via component ref (ref="itemSelect"):

  • focus — focuses the internal ItemSuggest input.

Layout ​

  • .jskos-vue-itemSelect
  • .jskos-vue-itemSelect-tree

See ItemSuggest for styling of dropdown and ConceptTree for styling of tree.

Examples ​

Languages (local options)

DDC (remote, with tree)