Bin
2025-12-16 9e0b2ba2c317b1a86212f24cbae3195ad1f3dbfa
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
import { observer } from "mobx-react";
import { types } from "mobx-state-tree";
 
import LabelMixin from "../../mixins/LabelMixin";
import Registry from "../../core/Registry";
import SelectedModelMixin from "../../mixins/SelectedModel";
import Types from "../../core/Types";
import { HtxLabels, LabelsModel } from "./Labels/Labels";
import { guidGenerator } from "../../core/Helpers";
import ControlBase from "./Base";
 
/**
 * The `ParagraphLabels` tag creates labeled paragraphs. Use with the `Paragraphs` tag to label a paragraph of text.
 *
 * Use with the following data types: paragraphs.
 * @example
 * <!--Basic labeling configuration to label paragraphs -->
 * <View>
 *   <ParagraphLabels name="labels" toName="prg">
 *     <Label value="Statement" />
 *     <Label value="Question" />
 *   </ParagraphLabels>
 *   <Paragraphs name="prg" value="$dialogue" layout="dialogue" />
 * </View>
 * @name ParagraphLabels
 * @meta_title Paragraph Label Tag for Paragraph Labels
 * @meta_description Customize Label Studio with paragraph labels for machine learning and data science projects.
 * @param {string} name                      - Name of the element
 * @param {string} toName                    - Name of the paragraph element to label
 * @param {single|multiple=} [choice=single] - Configure whether you can select one or multiple labels
 * @param {number} [maxUsages]               - Maximum number of times a label can be used per task
 * @param {boolean} [showInline=true]        - Show labels in the same visual line
 */
 
const ModelAttrs = types
  .model("ParagraphLabelsModel", {
    pid: types.optional(types.string, guidGenerator),
    type: "paragraphlabels",
    children: Types.unionArray(["label", "header", "view", "hypertext"]),
  })
  .views((self) => ({
    get hasStates() {
      const states = self.states();
 
      return states && states.length > 0;
    },
 
    get serializableValue() {
      const obj = {};
 
      obj.paragraphlabels = self.selectedValues();
 
      return obj;
    },
  }));
 
const Model = LabelMixin.props({ _type: "paragraphlabels" });
 
const Composition = types.compose(
  ControlBase,
  LabelsModel,
  ModelAttrs,
  Model,
  SelectedModelMixin.props({ _child: "LabelModel" }),
);
 
const ParagraphLabelsModel = types.compose("ParagraphLabelsModel", Composition);
 
const HtxParagraphLabels = observer(({ item }) => {
  return <HtxLabels item={item} />;
});
 
Registry.addTag("paragraphlabels", ParagraphLabelsModel, HtxParagraphLabels);
 
export { HtxParagraphLabels, ParagraphLabelsModel };