

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# SageMaker Elementos HTML de AI Crowd
<a name="general-topiclist"></a>

A continuación, se muestra una lista de los Crowd HTML Elements que facilitan la creación de una plantilla personalizada y proporcionan una interfaz de usuario familiar para los trabajadores. Estos elementos son compatibles con Ground Truth, Augmented AI y Mechanical Turk.

# crowd-alert
<a name="sms-ui-template-crowd-alert"></a>

Mensaje que alerta al trabajador sobre una situación actual.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/YzNPdGd).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-alert>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <div id="errorBox"></div>
   
  <crowd-keypoint
    src="{{ task.input.taskObject | grant_read_access }}"
    labels="['Item A', 'Item B', 'Item C']"        
    header="Please locate the centers of each item."
    name="annotatedResult">
    <short-instructions>
      Describe your task briefly here and give examples
    </short-instructions>
    <full-instructions>
      Give additional instructions and good/bad examples here
    </full-instructions>   
  </crowd-keypoint>
</crowd-form>

<script>
  var num_obj = 1;

  document.querySelector('crowd-form').onsubmit = function(e) {
    const keypoints = document.querySelector('crowd-keypoint').value.keypoints || document.querySelector('crowd-keypoint')._submittableValue.keypoints;
    const labels = keypoints.map(function(p) {
      return p.label;
    });

    // 1. Make sure total number of keypoints is correct.
    var original_num_labels = document.getElementsByTagName("crowd-keypoint")[0].getAttribute("labels");

    original_num_labels = original_num_labels.substring(2, original_num_labels.length - 2).split("\",\"");
    var goalNumKeypoints = num_obj*original_num_labels.length;
    if (keypoints.length != goalNumKeypoints) {
      e.preventDefault();
      errorBox.innerHTML = '<crowd-alert type="error" dismissible>You must add all keypoint annotations and use each label only once.</crowd-alert>';
      errorBox.scrollIntoView();
      return;
    }

    // 2. Make sure all labels are unique.
    labelCounts = {};
    for (var i = 0; i < labels.length; i++) {
      if (!labelCounts[labels[i]]) {
        labelCounts[labels[i]] = 0;
      }
      labelCounts[labels[i]]++;
    }
    const goalNumSingleLabel = num_obj;

    const numLabels = Object.keys(labelCounts).length;

    Object.entries(labelCounts).forEach(entry => {
      if (entry[1] != goalNumSingleLabel) {
        e.preventDefault();
        errorBox.innerHTML = '<crowd-alert type="error" dismissible>You must use each label only once.</crowd-alert>';
        errorBox.scrollIntoView();
      }
    })
  };
</script>
```

## Atributos
<a name="alert-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### dismissible
<a name="alert-attributes-dismissible"></a>

Conmutador booleano que, si está presente, permite que el trabajador cierre el mensaje.

### type
<a name="alert-attributes-type"></a>

Cadena que especifica el tipo de mensaje que se va a mostrar. Los posibles valores son "info" (valor predeterminado), "success", "error" y "warning".

## Jerarquía de elementos
<a name="alert-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="alert-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-badge
<a name="sms-ui-template-crowd-badge"></a>

Icono que flota por la esquina superior derecha de otro elemento al que está asociado.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/WNRbPwZ).

A continuación se muestra un ejemplo de una plantilla que utiliza el elemento `<crowd-badge>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-image-classifier
    name="crowd-image-classifier"
    src="https://unsplash.com/photos/NLUkAA-nDdE"
    header="Choose the correct category for this image."
    categories="['Person', 'Umbrella', 'Chair', 'Dolphin']"
  >
    <full-instructions header="Classification Instructions">
      <p>Read the task carefully and inspect the image.</p>
      <p>Choose the appropriate label that best suits the image.</p>
    </full-instructions>
   
    <short-instructions id="short-instructions">
      <p>Read the task carefully and inspect the image.</p>
      <p>Choose the appropriate label that best suits the image.</p>
      <crowd-badge icon="star" for="short-instructions"/>
    </short-instructions>
  </crowd-image-classifier>
</crowd-form>
```

## Atributos
<a name="badge-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### for
<a name="badge-attributes-for"></a>

Cadena que especifica el ID del elemento al que está asociado la tarjeta de identificación.

### icono
<a name="badge-attributes-icon"></a>

Cadena que especifica el icono que se va a mostrar en la tarjeta de identificación. La cadena tiene que ser el nombre de un icono del conjunto de *[iron-icons](https://github.com/PolymerElements/iron-icons)* de código abierto que está cargado previamente o la dirección URL de un icono personalizado.

Este atributo anula el atributo *label*. 

A continuación se muestra un ejemplo de la sintaxis que puede utilizar para agregar un iron-icon a un elemento HTML `<crowd-badge>`. Reemplace `icon-name` con el nombre del icono que le gustaría utilizar de este [conjunto de iconos](https://www.webcomponents.org/element/@polymer/iron-icons/demo/demo/index.html). 

```
<crowd-badge icon="icon-name" for="short-instructions"/>
```

### etiqueta
<a name="badge-attributes-label"></a>

El texto que se muestra en la tarjeta de identificación. Se recomienda usar tres o menos caracteres porque un texto demasiado grande desbordaría el área de la tarjeta de identificación. Se puede mostrar un icono en lugar de texto estableciendo el atributo *icon*.

## Jerarquía de elementos
<a name="badge-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="badge-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-button
<a name="sms-ui-template-crowd-button"></a>

Botón con estilo aplicado que representa alguna acción.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/RwKNvgG).

A continuación se muestra un ejemplo de una plantilla que utiliza el elemento `<crowd-button>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-image-classifier
    name="crowd-image-classifier"
    src="https://unsplash.com/photos/NLUkAA-nDdE"
    header="Please select the correct category for this image"
    categories="['Person', 'Umbrella', 'Chair', 'Dolphin']"
  >
    <full-instructions header="Classification Instructions">
      <p>Read the task carefully and inspect the image.</p>
      <p>Choose the appropriate label that best suits the image.</p>
    </full-instructions>
    <short-instructions>
      <p>Read the task carefully and inspect the image.</p>
      <p>Choose the appropriate label that best suits the image.</p>
      <crowd-button>
        <iron-icon icon="question-answer"/>
      </crowd-button>
    </short-instructions>
  </crowd-image-classifier>
</crowd-form>
```

## Atributos
<a name="button-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### disabled
<a name="button-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra el botón como deshabilitado y evita que se hagan clics.

### form-action
<a name="button-attributes-form-action"></a>

Conmutador que envía su elemento [crowd-form](sms-ui-template-crowd-form.md) principal si se establece en "submit", o restablece su elemento <crowd-form> principal si se establece en "reset".

### href
<a name="button-attributes-href"></a>

Dirección URL de un recurso online. Utilice esta propiedad si necesita un enlace presentado como un botón.

### icono
<a name="button-attributes-icon"></a>

Cadena que especifica el icono que se va a mostrar al lado del texto del botón. La cadena debe ser el nombre de un icono del conjunto de *[iron-icons](https://github.com/PolymerElements/iron-icons)* de código abierto, que está precargado. Por ejemplo, para insertar el iron-icon [search](https://www.webcomponents.org/element/@polymer/iron-icons/demo/demo/index.html), utilice los siguiente:

```
<crowd-button>
    <iron-icon icon="search"/>
</crowd-button>
```

El icono se coloca a la izquierda o la derecha del texto, según lo que especifique el atributo *icon-align*.

Para usar un icono personalizado, consulte **icon-url**.

### icon-align
<a name="button-attributes-icon-align"></a>

La posición (izquierda o derecha) del icono en relación con el texto del botón. El valor predeterminado es "left".

### icon-url
<a name="button-attributes-icon-url"></a>

Dirección URL a una imagen personalizada para el icono. Se puede utilizar una imagen personalizada en lugar de un icono estándar que se especifica con el atributo *icon*.

### cargar
<a name="button-attributes-loading"></a>

Conmutador booleano que, si está presente, muestra el botón como si estuviera en estado de carga. Este atributo tiene prioridad sobre el atributo *disabled* si ambos atributos están presentes.

### destino
<a name="button-attributes-target"></a>

Cuando se utiliza el atributo `href` para que el botón actúe como hipervínculo a una dirección URL específica, el atributo `target` está dirigido de forma opcional a un fotograma o una ventana donde la dirección URL vinculada debe cargarse.

### variant
<a name="button-attributes-variantl"></a>

El estilo general del botón. Utilice "primary" para botones principales, "normal" para botones secundarios, "link" para botones terciarios o "icon" para mostrar solo el icono sin texto.

## Jerarquía de elementos
<a name="button-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="button-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-bounding-box
<a name="sms-ui-template-crowd-bounding-box"></a>

Un widget utilizado para dibujar rectángulos en una imagen y asignar una etiqueta a la parte de la imagen que está en cada rectángulo.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/XWpJGad).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-bounding-box>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. Para ver más ejemplos, consulta este [GitHub repositorio](https://github.com/aws-samples/amazon-sagemaker-ground-truth-task-uis/tree/master/images). 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-bounding-box
    name="annotatedResult"
    src="{{ task.input.taskObject | grant_read_access }}"
    header="Draw bounding boxes around all the cats and dogs in this image"
    labels="['Cat', 'Dog']"
  >
    <full-instructions header="Bounding Box Instructions" >
      <p>Use the bounding box tool to draw boxes around the requested target of interest:</p>
      <ol>
        <li>Draw a rectangle using your mouse over each instance of the target.</li>
        <li>Make sure the box does not cut into the target, leave a 2 - 3 pixel margin</li>
        <li>
          When targets are overlapping, draw a box around each object,
          include all contiguous parts of the target in the box.
          Do not include parts that are completely overlapped by another object.
        </li>
        <li>
          Do not include parts of the target that cannot be seen,
          even though you think you can interpolate the whole shape of the target.
        </li>
        <li>Avoid shadows, they're not considered as a part of the target.</li>
        <li>If the target goes off the screen, label up to the edge of the image.</li>
      </ol>
    </full-instructions>

    <short-instructions>
      Draw boxes around the requested target of interest.
    </short-instructions>
  </crowd-bounding-box>
</crowd-form>
```

## Atributos
<a name="bounding-box-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="bounding-box-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### initial-value
<a name="bounding-box-attributes-initialValue"></a>

Matriz de objetos JSON, cada uno de los cuales establece un cuadro delimitador cuando se carga el componente. Cada objeto JSON de la matriz contiene las propiedades siguientes. Los cuadros delimitadores establecidos a través de la propiedad `initial-value` se pueden ajustar y se puede comprobar si la respuesta del trabajo se ajustó o no a través de un valor booleano `initialValueModified` en la salida de la respuesta del trabajador.
+ **altura**: la altura del cuadro en píxeles.
+ **etiqueta**: el texto asignado al cuadro como parte de la tarea de etiquetado. Este texto debe coincidir con una de las etiquetas definidas en el atributo *labels* del elemento < crowd-bounding-box >.
+ **izquierda**: distancia entre la esquina superior izquierda del cuadro y el lado izquierdo de la imagen, medida en píxeles.
+ **superior**: distancia entre la esquina superior izquierda del cuadro y la parte superior de la imagen, medida en píxeles.
+ **ancho**: el ancho del cuadro en píxeles.

  Puede extraer el valor inicial del cuadro delimitador de un archivo de manifiesto de un trabajo anterior en una plantilla personalizada utilizando el lenguaje de plantillas Liquid:

  ```
  initial-value="[
    {% for box in task.input.manifestLine.label-attribute-name-from-prior-job.annotations %}
      {% capture class_id %}{{ box.class_id }}{% endcapture %}
      {% assign label = task.input.manifestLine.label-attribute-name-from-prior-job-metadata.class-map[class_id] %}
      {
        label: {{label | to_json}},
        left: {{box.left}},
        top: {{box.top}},
        width: {{box.width}},
        height: {{box.height}},
      },
    {% endfor %}
   ]"
  ```

### etiquetas
<a name="bounding-box-attributes-labels"></a>

Una matriz de cadenas con formato JSON, cada una de las cuales es una etiqueta que un trabajador puede asignar a la parte de la imagen delimitada por un rectángulo. **Límite:** 10 etiquetas.

### name
<a name="bounding-box-attributes-name"></a>

El nombre del widget. Se usa como clave para la entrada del widget en la salida del formulario.

### src
<a name="bounding-box-attributes-src"></a>

La dirección URL de la imagen en la que se dibujan los cuadros delimitadores. 

## Jerarquía de elementos
<a name="bounding-box-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [full-instructions](#bounding-box-regions-full-instructions), [short-instructions](#bounding-box-regions-short-instructions)

## Regions
<a name="bounding-box-regions"></a>

Este elemento necesita las regiones siguientes.

### full-instructions
<a name="bounding-box-regions-full-instructions"></a>

Instrucciones generales sobre cómo dibujar cuadros delimitadores.

### short-instructions
<a name="bounding-box-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Salida
<a name="bounding-box-output"></a>

La siguiente salida es compatible con este elemento.

### boundingBoxes
<a name="bounding-box-output-boundingBoxes"></a>

Matriz de objetos JSON, cada una de las cuales especifica un cuadro delimitador que el trabajador ha creado. Cada objeto JSON de la matriz contiene las propiedades siguientes.
+ **altura**: la altura del cuadro en píxeles.
+ **etiqueta**: el texto asignado al cuadro como parte de la tarea de etiquetado. Este texto debe coincidir con una de las etiquetas definidas en el atributo *labels* del elemento < crowd-bounding-box >.
+ **izquierda**: distancia entre la esquina superior izquierda del cuadro y el lado izquierdo de la imagen, medida en píxeles.
+ **superior**: distancia entre la esquina superior izquierda del cuadro y la parte superior de la imagen, medida en píxeles.
+ **ancho**: el ancho del cuadro en píxeles.

### inputImageProperties
<a name="bounding-box-output-inputImageProperties"></a>

Objeto JSON que especifica las dimensiones de la imagen que el trabajador está comentando. Este objeto contiene las siguientes propiedades.
+ **altura**: la altura de la imagen en píxeles.
+ **ancho**: el ancho de la imagen en píxeles.

**Example : salidas de ejemplo de los elementos**  
A continuación, se muestran ejemplos de salidas de escenarios de uso habituales para este elemento.  
**Etiqueta única, cuadro único/Varias etiquetas, cuadro único**  

```
[
  {
    "annotatedResult": {
      "boundingBoxes": [
        {
          "height": 401,
          "label": "Dog",
          "left": 243,
          "top": 117,
          "width": 187
        }
      ],
      "inputImageProperties": {
        "height": 533,
        "width": 800
      }
    }
  }
]
```
**Etiqueta única, varios cuadros**  

```
[
  {
    "annotatedResult": {
      "boundingBoxes": [
        {
          "height": 401,
          "label": "Dog",
          "left": 243,
          "top": 117,
          "width": 187
        },
        {
          "height": 283,
          "label": "Dog",
          "left": 684,
          "top": 120,
          "width": 116
        }
      ],
      "inputImageProperties": {
        "height": 533,
        "width": 800
      }
    }
  }
]
```
**Varias etiquetas, varios cuadros**  

```
[
  {
    "annotatedResult": {
      "boundingBoxes": [
        {
          "height": 395,
          "label": "Dog",
          "left": 241,
          "top": 125,
          "width": 158
        },
        {
          "height": 298,
          "label": "Cat",
          "left": 699,
          "top": 116,
          "width": 101
        }
      ],
      "inputImageProperties": {
        "height": 533,
        "width": 800
      }
    }
  }
]
```
Puede tener disponibles numerosas etiquetas, pero solo se muestran en la salida las que se usan.

## Véase también
<a name="bounding-box-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-card
<a name="sms-ui-template-crowd-card"></a>

Cuadro con aspecto elevados para mostrar información.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/QWdwoxe).

A continuación se muestra un ejemplo de una plantilla diseñada para tareas de análisis de opiniones que utiliza el elemento `<crowd-card>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<style>
  h3 {
    margin-top: 0;
  }
  
  crowd-card {
    width: 100%;
  }
  
  .card {
    margin: 10px;
  }
  
  .left {
    width: 70%;
    margin-right: 10px;
    display: inline-block;
    height: 200px;
  }
  
  .right {
    width: 20%;
    height: 200px;
    display: inline-block;
  }
</style>

<crowd-form>
  <short-instructions>
    Your short instructions here.
  </short-instructions>
  
  <full-instructions>
    Your full instructions here.
  </full-instructions>
  
  <div class="left">
    <h3>What sentiment does this text convey?</h3>
    <crowd-card>
      <div class="card">
        Nothing is great.
      </div>
    </crowd-card>
  </div>
  
  <div class="right">
    <h3>Select an option</h3>
    
    <select name="sentiment1" style="font-size: large" required>
      <option value="">(Please select)</option>
      <option>Negative</option>
      <option>Neutral</option>
      <option>Positive</option>
      <option>Text is empty</option>
    </select>
  </div>
  
  <div class="left">
    <h3>What sentiment does this text convey?</h3>
    <crowd-card>
      <div class="card">
        Everything is great!
      </div>
    </crowd-card>
  </div>
  
  <div class="right">
    <h3>Select an option</h3>
    
    <select name="sentiment2" style="font-size: large" required>
      <option value="">(Please select)</option>
      <option>Negative</option>
      <option>Neutral</option>
      <option>Positive</option>
      <option>Text is empty</option>
    </select>
  </div>
</crowd-form>
```

## Atributos
<a name="card-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### heading
<a name="card-attributes-heading"></a>

El texto que se muestra en la parte superior del cuadro.

### imagen
<a name="card-attributes-image"></a>

Dirección URL de una imagen que se mostrará en el cuadro.

## Jerarquía de elementos
<a name="card-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="card-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-checkbox
<a name="sms-ui-template-crowd-checkbox"></a>

Componente de la interfaz de usuario que puede activarse o no y que permite al usuario seleccionar varias opciones de un conjunto.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/YzNPgOL).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-checkbox>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  
  <p>Find the official website for: <strong>{{ task.input.company }}</strong></p>
  <p>Do not give Yelp pages, LinkedIn pages, etc.</p>
  <p>Include the http:// prefix from the website</p>
  <crowd-input name="website" placeholder="http://example.com"></crowd-input>

  <crowd-checkbox name="website-found">Website Found</crowd-checkbox>

</crowd-form>
```

## Atributos
<a name="checkbox-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### checked
<a name="checkbox-attributes-checked"></a>

Conmutador booleano que, si está presente, muestra activada la casilla de verificación.

A continuación se muestra un ejemplo de la sintaxis utilizada para marcar una casilla de verificación de forma predeterminada.

```
  <crowd-checkbox name="checkedBox" value="checked" checked>This box is checked</crowd-checkbox>
```

### disabled
<a name="checkbox-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra deshabilitada la casilla de verificación e impide que se active.

A continuación se muestra un ejemplo de la sintaxis utilizada para deshabilitar una casilla de verificación. 

```
  <crowd-checkbox name="disabledCheckBox" value="Disabled" disabled>Cannot be selected</crowd-checkbox>
```

### name
<a name="checkbox-attributes-name"></a>

Cadena que se utiliza para identificar la respuesta enviada por el trabajador. Este valor coincidirá con una clave del objeto JSON que especifica la respuesta.

### obligatorio
<a name="checkbox-attributes-required"></a>

Conmutador booleano que, si está presente, requiere que el trabajador proporcione información.

A continuación se muestra un ejemplo de la sintaxis utilizada para requerir que se seleccione una casilla de verificación.

```
  <crowd-checkbox name="work_verified" required>Instructions were clear</crowd-checkbox>
```

### valor
<a name="checkbox-attributes-value"></a>

Cadena que se utiliza como nombre del estado de la casilla de verificación en la salida. Toma "on" como valor predeterminado si no se especifica. 

## Jerarquía de elementos
<a name="checkbox-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Output
<a name="checkbox-element-output"></a>

Proporciona un objeto JSON. La cadena `name` es el nombre del objeto y la cadena `value` es el nombre de la propiedad de un valor booleano basado en el estado de la casilla de verificación; true si está activado, false en caso contrario.

**Example : salidas de ejemplo de los elementos**  
**Uso del mismo valor `name` para varios cuadros.**  

```
<!-- INPUT -->  
<div><crowd-checkbox name="image_attributes" value="blurry"> Blurry </crowd-checkbox></div>
<div><crowd-checkbox name="image_attributes" value="dim"> Too Dim </crowd-checkbox></div>
<div><crowd-checkbox name="image_attributes" value="exposed"> Too Bright </crowd-checkbox></div>
```

```
//Output with "blurry" and "dim" checked
[
  {
    "image_attributes": {
      "blurry": true,
      "dim": true,
      "exposed": false
    }
  }
]
```
Tenga en cuenta que los valores de los tres colores son propiedades de un único objeto.  
**Uso de diferentes valores de `name` para cada caja.**  

```
<!-- INPUT -->
<div><crowd-checkbox name="Stop" value="Red"> Red </crowd-checkbox></div>
<div><crowd-checkbox name="Slow" value="Yellow"> Yellow </crowd-checkbox></div>
<div><crowd-checkbox name="Go" value="Green"> Green </crowd-checkbox></div>
```

```
//Output with "Red" checked
[
  {
    "Go": {
      "Green": false
    },
    "Slow": {
      "Yellow": false
    },
    "Stop": {
      "Red": true
    }
  }
]
```

## Véase también
<a name="checkbox-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-classifier
<a name="sms-ui-template-crowd-classifier"></a>

Widget que se utiliza para clasificar contenido sin imagen, como, por ejemplo, audio, vídeo o texto.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/KKawYBm).

A continuación se muestra un ejemplo de una plantilla de tarea de trabajador HTML creada mediante `crowd-classifier`. En este ejemplo se utiliza el [lenguaje de plantilla Liquid](https://shopify.github.io/liquid/basics/introduction/) para automatizar:
+ Categorías de etiquetas en el parámetro `categories` 
+ Los objetos que se están clasificando en el parámetro `classification-target`. 

Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
    <crowd-classifier
      name="category"
      categories="{{ task.input.labels | to_json | escape }}"
      header="What type of a document is this?"
    >
      <classification-target>
        <iframe style="width: 100%; height: 600px;" src="{{ task.input.taskObject  | grant_read_access }}" type="application/pdf"></iframe>
      </classification-target>
      
      <full-instructions header="Document Classification Instructions">
        <p>Read the task carefully and inspect the document.</p>
        <p>Choose the appropriate label that best suits the document.</p>
      </full-instructions>

      <short-instructions>
        Please choose the correct category for the document
      </short-instructions>
    </crowd-classifier>
</crowd-form>
```

## Atributos
<a name="crowd-classifier-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### categories
<a name="crowd-classifier-attributes-categories"></a>

Matriz de cadenas con formato JSON, cada una de las cuales es una categoría que un trabajador puede asignar al texto. Debe incluir "otros" como categoría, si no es así, es posible que el trabajador puede dar una respuesta.

### header
<a name="crowd-classifier-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### name
<a name="crowd-classifier-attributes-name"></a>

El nombre del widget. Se usa como clave para la entrada del widget en la salida del formulario.

## Jerarquía de elementos
<a name="crowd-classifier-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [classification-target](#crowd-classifier-regions-classification-target), [full-instructions](#crowd-classifier-regions-full-instructions) y [short-instructions](#crowd-classifier-regions-short-instructions)

## Regions
<a name="crowd-classifier-regions"></a>

Las regiones siguientes son compatibles con este elemento.

### classification-target
<a name="crowd-classifier-regions-classification-target"></a>

El contenido que el trabajador debe clasificar. Puede tratarse de texto sin formato o HTML. Por ejemplo, el HTML se puede utilizar, *sin limitarse a ello,* para integrar un vídeo o un reproductor de audio, un PDF o realizar una comparación de dos o más imágenes.

### full-instructions
<a name="crowd-classifier-regions-full-instructions"></a>

Instrucciones generales sobre cómo clasificar texto.

### short-instructions
<a name="crowd-classifier-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Output
<a name="crowd-classifier-output"></a>

El resultado de este elemento es un objeto que usa el valor `name` especificado como nombre de propiedad y una cadena de `categories` como valor de la propiedad.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado para este elemento.  

```
[
  {
    "<name>": {
      "label": "<value>"
    }
  }
]
```

## Véase también
<a name="crowd-classifier-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-classifier-multi-select
<a name="sms-ui-template-crowd-classifier-multi-select"></a>

Un widget para clasificar varios tipos de contenido, como audio, vídeo o texto, en una o más categorías. El contenido que se va a clasificar se conoce como un *objeto*. 

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/ExZaMOm).

A continuación, se muestra un ejemplo de una plantilla de tarea de trabajador HTML construida mediante este elemento. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
    <crowd-classifier-multi-select
      name="category"
      categories="['Positive', 'Negative', 'Neutral']"
      header="Select the relevant categories"
      exclusion-category="{ text: 'None of the above' }"
    >
      <classification-target>
        {{ task.input.taskObject }}
      </classification-target>
      
      <full-instructions header="Text Categorization Instructions">
        <p><strong>Positive</strong> sentiment include: joy, excitement, delight</p>
        <p><strong>Negative</strong> sentiment include: anger, sarcasm, anxiety</p>
        <p><strong>Neutral</strong>: neither positive or negative, such as stating a fact</p>
        <p><strong>N/A</strong>: when the text cannot be understood</p>
        <p>When the sentiment is mixed, such as both joy and sadness, choose both labels.</p>
      </full-instructions>

      <short-instructions>
       Choose all categories that are expressed by the text. 
      </short-instructions>
    </crowd-classifier-multi-select>
</crowd-form>
```

## Atributos
<a name="crowd-classifier-multi-attributes"></a>

Los siguientes atributos son compatibles con el elemento `crowd-classifier-multi-select`. Cada atributo acepta uno o varios valores de cadena. 

### categories
<a name="crowd-classifier-multi-attributes-categories"></a>

Obligatorio. Matriz de cadenas con formato JSON, cada una de las cuales es una categoría que un trabajador puede asignar al objeto. 

### header
<a name="crowd-classifier-multi-attributes-header"></a>

Obligatorio. El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para trabajadores.

### name
<a name="crowd-classifier-multi-attributes-name"></a>

Obligatorio. El nombre del widget. En la salida del formulario, se usa el nombre como clave para la entrada del widget.

### exclusion-category
<a name="crowd-classifier-multi-attributes-exclusion-category"></a>

Opcional. Una cadena con formato JSON con el siguiente formato: `"{ text: 'default-value' }"`. Este atributo establece un valor predeterminado que los trabajadores pueden seleccionar si no hay ninguna de las etiquetas que se pueda aplicar al objeto mostrado en la interfaz de usuario del trabajador.

## Jerarquía de elementos
<a name="crowd-classifier-multi-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios:
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [classification-target](sms-ui-template-crowd-classifier.md#crowd-classifier-regions-classification-target), [full-instructions](sms-ui-template-crowd-classifier.md#crowd-classifier-regions-full-instructions) y [short-instructions](sms-ui-template-crowd-classifier.md#crowd-classifier-regions-short-instructions)

## Regions
<a name="crowd-classifier-multi-regions"></a>

Este elemento utiliza las siguientes regiones.

### classification-target
<a name="crowd-classifier-multi-regions-classification-target"></a>

El contenido que el trabajador debe clasificar. El contenido puede ser texto sin formato o un objeto que especifique en la plantilla mediante HTML. Por ejemplo, puede utilizar elementos HTML para incluir un reproductor de vídeo o audio, incrustar un archivo PDF o incluir una comparación de dos o más imágenes.

### full-instructions
<a name="crowd-classifier-multi-regions-full-instructions"></a>

Instrucciones generales sobre cómo clasificar el texto.

### short-instructions
<a name="crowd-classifier-multi-regions-short-instructions"></a>

Instrucciones importantes específicas para tareas. Estas instrucciones se muestran de forma destacada.

## Output
<a name="crowd-classifier-multi-output"></a>

El resultado de este elemento es un objeto que usa el valor `name` especificado como nombre de propiedad y una cadena de `categories` como valor de la propiedad.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado para este elemento.  

```
[
  {
    "<name>": {
        labels: ["label_a", "label_b"]
    }
  }
]
```

## Véase también
<a name="crowd-classifier-multi-see-also"></a>

Para obtener más información, consulte los siguientes temas:
+ [Categorización de texto con clasificación de texto (etiquetas múltiples)](sms-text-classification-multilabel.md)
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-entity-annotation
<a name="sms-ui-template-crowd-entity-annotation"></a>

Un widget para etiquetar palabras, frases y cadenas de caracteres dentro de un texto más grande. Los trabajadores seleccionan una etiqueta y resaltan el texto al que se aplica la etiqueta. 

**Importante: widget autónomo**  
No utilice el elemento `<crowd-entity-annotation>` con el elemento `<crowd-form>`. Contiene su propia lógica para enviar formularios y un botón **Submit (Enviar)**.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/XWpJQrR).

A continuación se muestra un ejemplo de una plantilla que utiliza el elemento `<crowd-entity-annotation>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-entity-annotation
  name="crowd-entity-annotation"
  header="Highlight parts of the text below"
  labels="[{'label': 'person', 'shortDisplayName': 'per', 'fullDisplayName': 'Person'}, {'label': 'date', 'shortDisplayName': 'dat', 'fullDisplayName': 'Date'}, {'label': 'company', 'shortDisplayName': 'com', 'fullDisplayName': 'Company'}]"
  text="Amazon SageMaker Ground Truth helps you build highly accurate training datasets for machine learning quickly."
>
  <full-instructions header="Named entity recognition instructions">
    <ol>
      <li><strong>Read</strong> the text carefully.</li>
      <li><strong>Highlight</strong> words, phrases, or sections of the text.</li>
      <li><strong>Choose</strong> the label that best matches what you have highlighted.</li>
      <li>To <strong>change</strong> a label, choose highlighted text and select a new label.</li>
      <li>To <strong>remove</strong> a label from highlighted text, choose the X next to the abbreviated label name on the highlighted text.</li>
      <li>You can select all of a previously highlighted text, but not a portion of it.</li>
    </ol>
  </full-instructions>

  <short-instructions>
    Apply labels to words or phrases.
  </short-instructions>

    <div id="additionalQuestions" style="margin-top: 20px">
      <h3>
        What is the overall subject of this text?
      </h3>
      <crowd-radio-group>
        <crowd-radio-button name="tech" value="tech">Technology</crowd-radio-button>
        <crowd-radio-button name="politics" value="politics">Politics</crowd-radio-button>
      </crowd-radio-group>
    </div>
</crowd-entity-annotation>

<script>
  document.addEventListener('all-crowd-elements-ready', () => {
    document
      .querySelector('crowd-entity-annotation')
      .shadowRoot
      .querySelector('crowd-form')
      .form
      .appendChild(additionalQuestions);
  });
</script>
```

## Atributos
<a name="entity-annotation-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="entity-annotation-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### initial-value
<a name="entity-annotation-attributes-initial-value"></a>

Una matriz de objetos con formato JSON; cada objeto define una anotación para aplicarla al texto en la inicialización. Los objetos contienen un valor `label` que coincide con uno del atributo `labels`, un valor entero `startOffset` para el desplazamiento Unicode inicial de la extensión etiquetada y un valor entero `endOffset` para el desplazamiento Unicode final.

**Example**  

```
[
  {
    label: 'person',
    startOffset: 0,
    endOffset: 16
  },
  ...
]
```

### etiquetas
<a name="entity-annotation-attributes-labels"></a>

Una matriz de objetos con formato JSON; cada objeto contiene:
+ `label` (obligatorio): el nombre que se utiliza para identificar las identidades.
+ `fullDisplayName` (opcional): elemento que se utiliza en la lista de etiquetas del widget de la tarea. Si no se especifica, el valor predeterminado es el valor de la etiqueta.
+ `shortDisplayName` (opcional): una abreviatura de 3-4 letras para mostrarla sobre las entidades seleccionadas. Si no se especifica, el valor predeterminado es el valor de la etiqueta.
**Le recomendamos `shortDisplayName`**  
Los valores que aparecen sobre las selecciones se pueden solapar y generar dificultades a la hora de administrar las entidades etiquetadas del espacio de trabajo. Le recomendamos proporcionar un `shortDisplayName` de 3-4 caracteres para cada etiqueta con el fin de evitar los solapamientos y hacer que los trabajadores puedan gestionar el espacio de trabajo con facilidad.

**Example**  

```
[
  {
    label: 'person',
    shortDisplayName: 'per', 
    fullDisplayName: 'person'
  }
]
```

### name
<a name="entity-annotation-attributes-name"></a>

Sirve como el nombre del widget en el DOM. También se utiliza como el nombre de atributo de etiqueta en la salida del formulario y el manifiesto de salida.

### text
<a name="entity-annotation-attributes-text"></a>

El texto que se va a anotar. El sistema de plantillas aplica caracteres de escape a las cadenas HTML y los presupuestos de forma predeterminada. Si el código es totalmente o parcialmente de escape, consulte [Filtros de variables](sms-custom-templates-step2-automate.md#sms-custom-templates-step2-automate-filters) y conozca más métodos para controlar el escape.

## Jerarquía de elementos
<a name="entity-annotation-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos secundarios**: [full-instructions](#entity-annotation-regions-full-instructions), [short-instructions](#entity-annotation-regions-short-instructions)

## Regions
<a name="entity-annotation-regions"></a>

Las regiones siguientes son compatibles con este elemento.

### full-instructions
<a name="entity-annotation-regions-full-instructions"></a>

Instrucciones generales acerca de cómo utilizar el widget.

### short-instructions
<a name="entity-annotation-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Salida
<a name="entity-annotation-output"></a>

La siguiente salida es compatible con este elemento.

### entities
<a name="entity-annotation-output-entities"></a>

Un objeto JSON que especifica el inicio, el final y la etiqueta de una anotación. Este objeto contiene las siguientes propiedades.
+ **etiqueta**: la etiqueta asignada.
+ **startOffset**: el desplazamiento Unicode del principio del texto seleccionado.
+ **endOffset**: el desplazamiento Unicode del primer carácter después de la selección.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado para este elemento.  

```
{
  "myAnnotatedResult": {
    "entities": [
      {
        "endOffset": 54,
        "label": "person",
        "startOffset": 47
      },
      {
        "endOffset": 97,
        "label": "event",
        "startOffset": 93
      },
      {
        "endOffset": 219,
        "label": "date",
        "startOffset": 212
      },
      {
        "endOffset": 271,
        "label": "location",
        "startOffset": 260
      }
    ]
  }
}
```

## Véase también
<a name="entity-annotation-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-fab
<a name="sms-ui-template-crowd-fab"></a>

Botón flotante con una imagen en el centro. 

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/ExZaJaw).

A continuación se muestra un ejemplo de una plantilla Liquid diseñada para la clasificación de imágenes que utiliza el elemento `<crowd-fab>`. Esta plantilla se utiliza JavaScript para permitir a los trabajadores informar de problemas con la interfaz de usuario del trabajador. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
<crowd-form>
    <crowd-image-classifier 
        src="${image_url}"
        categories="['Cat', 'Dog', 'Bird', 'None of the Above']"
        header="Choose the correct category for the image"
        name="category">


        <short-instructions>
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image.</p>
            <p>If there is an issue with the image or tools, please select
              <b>None of the Above</b>, describe the issue in the text box and click the 
              button below.</p>
            <crowd-input label="Report an Issue" name="template-issues"></crowd-input>
            <crowd-fab id="button1" icon="report-problem" title="Issue"/>
        </short-instructions>
        
        <full-instructions header="Classification Instructions">
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image. 
            Use the <b>None of the Above</b> option if none of the other labels suit the image.</p>
        </full-instructions>

    </crowd-image-classifier>
</crowd-form>

<script>
  [
    button1,
  ].forEach(function(button) {
    button.addEventListener('click', function() {
      document.querySelector('crowd-form').submit();
    });
  });
</script>
```

## Atributos
<a name="fab-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### disabled
<a name="fab-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra el botón flotante como deshabilitado y evita que se hagan clics.

### icono
<a name="fab-attributes-icon"></a>

Cadena que especifica el icono que se va a mostrar en el centro del botón. La cadena tiene que ser el nombre de un icono del conjunto de *[iron-icons](https://github.com/PolymerElements/iron-icons)* de código abierto que está cargado previamente o la dirección URL de un icono personalizado.

A continuación se muestra un ejemplo de la sintaxis que puede utilizar para agregar un iron-icon a un elemento HTML `<crowd-fab>`. Reemplace `icon-name` con el nombre del icono que le gustaría utilizar de este [conjunto de iconos](https://www.webcomponents.org/element/@polymer/iron-icons/demo/demo/index.html). 

```
<crowd-fab "id="button1" icon="icon-name" title="Issue"/>
```

### etiqueta
<a name="fab-attributes-label"></a>

Cadena consistente en un único carácter que se pueden utilizar en lugar de un icono. Si se usan emojis o varios caracteres podría pasar que el botón mostrase puntos suspensivos en su lugar.

### título
<a name="fab-attributes-title"></a>

Cadena que se mostrará como ayuda sobre herramientas cuando el ratón pase por encima del botón.

## Jerarquía de elementos
<a name="fab-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="fab-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-form
<a name="sms-ui-template-crowd-form"></a>

El contenedor de formularios de todas las tareas personalizadas. Establece e implementa acciones importante para el envío adecuado de los datos del formulario.

Si no se incluye un [crowd-button](sms-ui-template-crowd-button.md) del tipo "submit" dentro del elemento `<crowd-form>`, se asociará automáticamente dentro del elemento `<crowd-form>`. 

Vea un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML de Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/oNBgOWa).

A continuación se muestra un ejemplo de una plantilla de clasificación de imágenes que utiliza el elemento `<crowd-form>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
    <crowd-image-classifier 
        src="${image_url}"
        categories="['Cat', 'Dog', 'Bird', 'None of the Above']"
        header="Choose the correct category for the image"
        name="category">


        <short-instructions>
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image.</p>
        </short-instructions>

 
        <full-instructions header="Classification Instructions">
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image. 
            Use the <b>None of the Above</b> option if none of the other labels suit the image.</p>
        </full-instructions>

    </crowd-image-classifier>
</crowd-form>
```

## Jerarquía de elementos
<a name="form-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: ninguno
+ **Elementos secundarios**: cualquiera de los elementos de [plantilla de interfaz de usuario](sms-ui-template-reference.md)

## Eventos de elemento
<a name="form-element-events"></a>

El elemento `crowd-form` extiende el [elemento `form` HTML estándar](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form) y hereda sus eventos, como `onclick` y `onsubmit`.

## Véase también
<a name="form-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-icon-button
<a name="sms-ui-template-crowd-icon-button"></a>

Botón con una imagen ubicada en el centro. Cuando el usuario toca el botón, emana un efecto onda del centro del botón.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/ExZaJXE).

A continuación se muestra un ejemplo de una plantilla Liquid diseñada para la clasificación de imágenes que utiliza el elemento `<crowd-icon-button>`. Esta plantilla se utiliza JavaScript para permitir a los trabajadores informar de problemas con la interfaz de usuario del trabajador. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
<crowd-form>
    <crowd-image-classifier 
        src="${image_url}"
        categories="['Cat', 'Dog', 'Bird', 'None of the Above']"
        header="Choose the correct category for the image"
        name="category">


        <short-instructions>
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image.</p>
            <p>If there is an issue with the image or tools, please select
              <b>None of the Above</b>, describe the issue in the text box and click the 
              button below.</p>
            <crowd-input label="Report an Issue" name="template-issues"/></crowd-input>
            <crowd-icon-button id="button1" icon="report-problem" title="Issue"/>
        </short-instructions>
        
        <full-instructions header="Classification Instructions">
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image. 
            Use the <b>None of the Above</b> option if none of the other labels suit the image.</p>
        </full-instructions>

    </crowd-image-classifier>
</crowd-form>

<script>
  [
    button1,
  ].forEach(function(button) {
    button.addEventListener('click', function() {
      document.querySelector('crowd-form').submit();
    });
  });
</script>
```

## Atributos
<a name="icon-button-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### disabled
<a name="icon-button-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra el botón como deshabilitado y evita que se hagan clics.

### icono
<a name="icon-button-attributes-icon"></a>

Cadena que especifica el icono que se va a mostrar en el centro del botón. La cadena tiene que ser el nombre de un icono del conjunto de *[iron-icons](https://github.com/PolymerElements/iron-icons)* de código abierto que está cargado previamente o la dirección URL de un icono personalizado.

A continuación se muestra un ejemplo de la sintaxis que puede utilizar para agregar un iron-icon a un elemento HTML `<crowd-icon-button>`. Reemplace `icon-name` con el nombre del icono que le gustaría utilizar de este [conjunto de iconos](https://www.webcomponents.org/element/@polymer/iron-icons/demo/demo/index.html). 

```
<crowd-icon-button id="button1" icon="icon-name" title="Issue"/>
```

## Jerarquía de elementos
<a name="icon-button-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="icon-button-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-image-classifier
<a name="sms-ui-template-crowd-image-classifier"></a>

Un widget para clasificar una imagen. Utilice uno de los siguientes formatos de imagen compatibles: APNG, BMP, GIF, ICO, JPEG, PNG, SVG. Las imágenes no tienen un límite de tamaño. 

Vea un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML de Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/vYgEvWw).

A continuación se muestra un ejemplo de una plantilla de clasificación de imágenes que utiliza el elemento `<crowd-image-classifier>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
<crowd-form>
    <crowd-image-classifier 
        src="${image_url}"
        categories="['Cat', 'Dog', 'Bird', 'None of the Above']"
        header="Choose the correct category for the image"
        name="category">


        <short-instructions>
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image.</p>
        </short-instructions>

 
        <full-instructions header="Classification Instructions">
            <p>Read the task carefully and inspect the image.</p>
            <p>Choose the appropriate label that best suits the image. 
            Use the <b>None of the Above</b> option if none of the other labels suit the image.</p>
        </full-instructions>

    </crowd-image-classifier>
</crowd-form>
```

## Atributos
<a name="image-classifier-attributes"></a>

Este elemento requiere el uso de los siguientes atributos.

### categories
<a name="image-classifier-attributes-categories"></a>

Matriz de cadenas con formato JSON, cada una de las cuales es una categoría que un trabajador puede asignar a la imagen. Debe incluir "otros" como categoría, de forma que el trabajador puede dar una respuesta. Puede especificar hasta 10 categorías.

### header
<a name="image-classifier-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### name
<a name="image-classifier-attributes-name"></a>

El nombre del widget. Se usa como clave para la entrada del widget en la salida del formulario.

### overlay
<a name="image-classifier-attributes-overlay"></a>

Información que se superpone en la imagen de origen. Se utiliza en flujos de trabajo de verificación de tareas de segmentación semántica, segmentación de instancias y cuadros delimitadores.

Es un objeto JSON que contiene un objeto con el nombre del tipo de tarea como clave en formato camelCase. El valor de esa clave es un objeto que contiene las etiquetas y otra información necesaria de la tarea anterior.

A continuación, se muestra un ejemplo de un elemento `crowd-image-classifier` con atributos para verificar una tarea de cuadro delimitador:

```
<crowd-image-classifier
    name="boundingBoxClassification"
    header="Rate the quality of the annotations based on the background section 
       in the instructions on the left hand side."
    src="https://i.imgur.com/CIPKVJo.jpg"
    categories="['good', 'bad', 'okay']"
    overlay='{
        "boundingBox": {
            labels: ["bird", "cat"], 
            value: [
                {
                  height: 284,
                  label: "bird",
                  left: 230,
                  top: 974,
                  width: 223
                },
                {
                  height: 69,
                  label: "bird",
                  left: 79,
                  top: 889,
                  width: 247
                }
            ]
        },
    }'
> ... </crowd-image-classifier>
```

Una tarea de verificación de segmentación semántica utilizaría el valor `overlay` como sigue:

```
<crowd-image-classifier
  name='crowd-image-classifier'
  categories='["good", "bad"]'
  src='URL of image to be classified'
  header='Please classify'
  overlay='{
    "semanticSegmentation": {
      "labels": ["Cat", "Dog", "Bird", "Cow"],
      "labelMappings": {
        "Bird": {
          "color": "#ff7f0e"
        },
        "Cat": {
          "color": "#2ca02c"
        },
        "Cow": {
          "color": "#d62728"
        },
        "Dog": {
          "color": "#2acf59"
        }
      },
      "src": "URL of overlay image",
    }
  }'
> ... </crowd-image-classifier>
```

Una tarea de segmentación de instancias utilizaría el valor `overlay` como sigue:

```
<crowd-image-classifier
  name='crowd-image-classifier'
  categories='["good", "bad"]'
  src='URL of image to be classified'
  header='Please classify instances of each category'
  overlay='{
    "instanceSegmentation": {
       "labels": ["Cat", "Dog", "Bird", "Cow"],
       "instances": [
        {
         "color": "#2ca02c",
         "label": "Cat"
        },
        {
         "color": "#1f77b4",
         "label": "Cat"
        },
        {
         "color": "#d62728",
         "label": "Dog"
        }
       ],
       "src": "URL of overlay image",
    }
  }'
> ... </crowd-image-classifier>
```

### src
<a name="image-classifier-attributes-src"></a>

Dirección URL de la imagen que se va a clasificar. 

## Jerarquía de elementos
<a name="image-classifier-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [full-instructions](#image-classifier-regions-full-instructions), [short-instructions](#image-classifier-regions-short-instructions) y [worker-comment](#image-classifier-regions-worker-comment)

## Regions
<a name="image-classifier-regions"></a>

Este elemento utiliza las regiones siguientes.

### full-instructions
<a name="image-classifier-regions-full-instructions"></a>

Instrucciones generales para el trabajador acerca de cómo clasificar una imagen.

### short-instructions
<a name="image-classifier-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

### worker-comment
<a name="image-classifier-regions-worker-comment"></a>

Utilice esta región en los flujos de trabajo de verificación cuando necesite trabajadores para explicar por qué hicieron la elección que hicieron. Utilice el texto incluido entre las etiquetas de apertura y cierre para proporcionar instrucciones a los trabajadores sobre qué información debe incluirse en el comentario.

Utiliza los siguientes atributos:

#### header
<a name="image-classifier-regions-worker-comment-header"></a>

Frase con un llamada a la acción para dejar un comentario. Se utiliza como texto del título de una ventana modal en la que se agrega el comentario.

Opcional. El valor predeterminado es "Add a comment (Añada un comentario".

#### link-text
<a name="image-classifier-regions-worker-comment-link-text"></a>

Este texto aparece debajo de las categorías del widget. Cuando se hace clic en él, se abre una ventana modal en la que el trabajador puede añadir un comentario.

Opcional. El valor predeterminado es "Add a comment (Añada un comentario".

#### marcador de posición
<a name="image-classifier-regions-worker-comment-placeholder"></a>

Texto de ejemplo del área de texto del comentario que se sobrescribe cuando el trabajador comienza a escribir. Este texto no aparece en la salida si el trabajador deja el campo en blanco.

Opcional. Cambia por defecto a en blanco.

## Output
<a name="image-classifier-output"></a>

La salida de este elemento es una cadena que especifica uno de los valores definidos en el atributo *categories* del elemento < crowd-image-classifier >.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado para este elemento.  

```
[
  {
    "<name>": {
      "label": "<value>"
      "workerComment": "Comment - if no comment is provided, this field will not be present"
    }
  }
]
```

## Véase también
<a name="image-classifier-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-image-classifier-multi-seleccionar
<a name="sms-ui-template-crowd-image-classifier-multi"></a>

Un widget para clasificar una imagen en una o más categorías. Utilice uno de los siguientes formatos de imagen compatibles: APNG, BMP, GIF, ICO, JPEG, PNG, SVG. Las imágenes no tienen un límite de tamaño. 

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/WNRbWgR).

A continuación se muestra un ejemplo de una plantilla de tarea de trabajador HTML creada con este elemento crowd. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-image-classifier-multi-select
    name="animals"
    categories="['Cat', 'Dog', 'Horse', 'Pig', 'Bird']"
    src="https://images.unsplash.com/photo-1509205477838-a534e43a849f?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1998&q=80"
    header="Please identify the animals in this image"
    exclusion-category="{ text: 'None of the above' }"
  >
    <full-instructions header="Classification Instructions">
      <p>If more than one label applies to the image, select multiple labels.</p>
      <p>If no labels apply, select <b>None of the above</b></p>
    </full-instructions>

    <short-instructions>
      <p>Read the task carefully and inspect the image.</p>
      <p>Choose the appropriate label(s) that best suit the image.</p>
    </short-instructions>
  </crowd-image-classifier-multi-select>
</crowd-form>
```

## Atributos
<a name="image-classifier-multi-attributes"></a>

Los siguientes atributos son compatibles con el elemento `crowd-image-classifier-multi-select`. Cada atributo acepta uno o varios valores de cadena.

### categories
<a name="image-classifier-multi-attributes-categories"></a>

Obligatorio. Matriz de cadenas con formato JSON, cada una de las cuales es una categoría que un trabajador puede asignar a la imagen. Un trabajador debe elegir al menos una categoría y puede elegir todas las categorías. 

### header
<a name="image-classifier-multi-attributes-header"></a>

Obligatorio. El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para trabajadores.

### name
<a name="image-classifier-multi-attributes-name"></a>

Obligatorio. El nombre del widget. En la salida del formulario, se usa el nombre como clave para la entrada del widget.

### src
<a name="image-classifier-multi-attributes-src"></a>

Obligatorio. Dirección URL de la imagen que se va a clasificar. 

### exclusion-category
<a name="image-classifier-multi-attributes-exclusion-category"></a>

Opcional. Una cadena con formato JSON con el siguiente formato: `"{ text: 'default-value' }"`. Este atributo establece un valor predeterminado que los trabajadores pueden elegir si ninguna de las etiquetas se aplica a la imagen mostrada en la interfaz de usuario de trabajador.

## Jerarquía de elementos
<a name="image-classifier-multi-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios:
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [full-instructions](sms-ui-template-crowd-image-classifier.md#image-classifier-regions-full-instructions), [short-instructions](sms-ui-template-crowd-image-classifier.md#image-classifier-regions-short-instructions) y [worker-comment](sms-ui-template-crowd-image-classifier.md#image-classifier-regions-worker-comment)

## Regions
<a name="image-classifier-multi-regions"></a>

Este elemento utiliza las siguientes regiones

### full-instructions
<a name="image-classifier-multi-regions-full-instructions"></a>

Instrucciones generales para el trabajador acerca de cómo clasificar una imagen.

### short-instructions
<a name="image-classifier-multi-regions-short-instructions"></a>

Instrucciones importantes específicas para tareas. Estas instrucciones se muestran de forma destacada.

## Output
<a name="image-classifier-multi-output"></a>

La salida de este elemento es una cadena que especifica uno o más de los valores definidos en el atributo `categories` del elemento `<crowd-image-classifier-multi-select>`.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado para este elemento.  

```
[
  {
    "<name>": {
        labels: ["label_a", "label_b"]
    }
  }
]
```

## Véase también
<a name="image-classifier-multi-see-also"></a>

Para obtener más información, consulte los siguientes temas:
+ [Creación de un trabajo de etiquetado de clasificación de imágenes (varias etiquetas)](sms-image-classification-multilabel.md)
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-input
<a name="sms-ui-template-crowd-input"></a>

Cuadro que acepta datos de entrada.

**No puede autocerrarse.**  
A diferencia del elemento `input` en el estándar HTML, este elemento no puede autocerrarse poniendo una barra inclinada antes del corchete de cierre, por ejemplo `<crowd-input ... />`. Tiene que ir seguido de un `</crowd-input>` para cerrar el elemento.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/wvgBZYW).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-input>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <img style="max-width: 35vw; max-height: 50vh" src="{{ task.input.taskObject | grant_read_access }}">
  <crowd-input name="tag1" label="Word/phrase 1" required></crowd-input>
  <crowd-input name="tag2" label="Word/phrase 2" required></crowd-input>
  <crowd-input name="tag3" label="Word/phrase 3" required></crowd-input>

  <short-instructions>
    Your custom quick instructions and examples
  </short-instructions>

  <full-instructions>
    Your custom detailed instracutions and more examples
  </full-instructions>
</crowd-form>
```

## Atributos
<a name="input-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### allowed-pattern
<a name="input-attributes-allowed-pattern"></a>

Expresión regular que se utiliza con el atributo *auto-validate* para pasar por alto los tipos de caracteres no coincidentes como tipos de trabajadores.

### auto-focus
<a name="input-attributes-auto-focus"></a>

Cuando el valor se establece en true, el explorador se centra en el área de entrada después de realizar la carga. De esta forma, el trabajador puede comenzar a escribir sin tener que seleccionarla antes.

### auto-validate
<a name="input-attributes-auto-validate"></a>

Conmutador booleano que, si está presente, activa la validación de entrada. El comportamiento del validador se puede modificar mediante los atributos *error-message* y *allowed-pattern*.

### disabled
<a name="input-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra deshabilitada el área de entrada.

### error-message
<a name="input-attributes-error-message"></a>

Texto que se va a mostrar debajo del campo de entrada, en el lado izquierdo, si se produce un error de validación.

### etiqueta
<a name="input-attributes-label"></a>

Cadena que se muestra dentro de un campo de texto.

Este texto se reduce y se eleva por encima de un campo de texto cuando el trabajador comienza a escribir en el campo o cuando el atributo *value* está establecido.

### max-length
<a name="input-attributes-max-length"></a>

 Número máximo de caracteres que la entrada aceptará. La introducción de caracteres por encima de este límite no se tendrá en cuenta.

### min-length
<a name="input-attributes-min-length"></a>

Longitud mínima de la entrada del campo.

### name
<a name="input-attributes-name"></a>

 Establece el nombre de la entrada que se va a utilizar en el DOM y la salida del formulario.

### marcador de posición
<a name="input-attributes-placeholder"></a>

Valor de cadena que se utiliza como texto marcador de posición, que se muestra hasta que el trabajador comienza a introducir datos en la entrada. No se utiliza como valor predeterminado.

### obligatorio
<a name="input-attributes-required"></a>

Conmutador booleano que, si está presente, requiere que el trabajador proporcione información.

### type
<a name="input-attributes-type"></a>

Se necesita una cadena para establecer el HTML5 `input-type` comportamiento de la entrada. Entre los ejemplos se incluyen `file` y `date`.

### valor
<a name="input-attributes-value"></a>

Un elemento preestablecido que se convierte en valor predeterminado si el trabajador no proporciona entrada. El elemento preestablecido aparece en un cuadro de texto.

## Jerarquía de elementos
<a name="input-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Output
<a name="input-element-output"></a>

Proporciona una cadena `name` como nombre de la propiedad y el texto que se ha especificado en el campo como su valor.

**Example : resultado de JSON de ejemplo**  
Los valores de varios elementos salen en el mismo objeto, con su valor de atributo `name` como su nombre de propiedad. Los elementos que no tengan información de entrada no aparecen en el resultado. Por ejemplo, usemos tres entradas:  

```
<crowd-input name="tag1" label="Word/phrase 1"></crowd-input>
<crowd-input name="tag2" label="Word/phrase 2"></crowd-input>
<crowd-input name="tag3" label="Word/phrase 3"></crowd-input>
```
Este es el resultado si solo se han introducido dos:  

```
[
  {
    "tag1": "blue",
    "tag2": "red"
  }
]
```
Esto significa que cualquier código creado para analizar estos resultados debe poder manejar la presencia o ausencia de cada entrada en las respuestas.

## Véase también
<a name="input-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-instance-segmentation
<a name="sms-ui-template-crowd-instance-segmentation"></a>

Un widget para identificar instancias individuales de objetos específicos dentro de una imagen y crear una superposición de color para cada instancia etiquetada.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML de Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/PoWwvwG).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-instance-segmentation>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-instance-segmentation
    name="annotatedResult"
    src="{{ task.input.taskObject | grant_read_access }}"
    header="Please label each of the requested objects in this image"
    labels="['Cat', 'Dog', 'Bird']"
  >
    <full-instructions header="Segmentation Instructions">
      <ol>
          <li><strong>Read</strong> the task carefully and inspect the image.</li>
          <li><strong>Read</strong> the options and review the examples provided to understand more about the labels.</li>
          <li><strong>Choose</strong> the appropriate label that best suits the image.</li>
      </ol>
    </full-instructions>

    <short-instructions>
      <p>Use the tools to label all instances of the requested items in the image</p>
    </short-instructions>
  </crowd-instance-segmentation>
</crowd-form>
```

Utilice una plantilla similar a la siguiente para permitir a los trabajadores añadir sus propias categorías (etiquetas).

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
<crowd-form>
  <crowd-instance-segmentation
    id="annotator"
    name="myTexts"
    src="{{ task.input.taskObject | grant_read_access }}"
    header="Click Instructions to add new labels."
    labels="['placeholder']"
  >
    <short-instructions>
      <h3>Add a label to describe each type of object in this image.</h3>
      <h3>Cover each instance of each object with a segmentation mask.</h3>
      <br>
      <h3>
        Add new label
      </h3>
      <crowd-input name="_customLabel" id="customLabel"></crowd-input>
      <crowd-button id="addLabel">Add</crowd-button>
      
      <br><br><br>
      <h3>
      Manage labels
      </h3>
      <div id="labelsSection"></div>
    </short-instructions>
    
    <full-instructions>
      Describe your task in more detail here.
    </full-instructions>
  </crowd-instance-segmentation>
</crowd-form>

<script>
  document.addEventListener('all-crowd-elements-ready', function(event) {
    document.querySelector('crowd-instance-segmentation').labels = [];  
  });
  
  function populateLabelsSection() {
    labelsSection.innerHTML = '';
    annotator.labels.forEach(function(label) {
      const labelContainer = document.createElement('div');
      labelContainer.innerHTML = label + ' <a href="javascript:void(0)">(Delete)</a>';
      labelContainer.querySelector('a').onclick = function() {
        annotator.labels = annotator.labels.filter(function(l) {
          return l !== label;
        });
        populateLabelsSection();
      };
      labelsSection.appendChild(labelContainer);
    });
  }

  addLabel.onclick = function() {
    annotator.labels = annotator.labels.concat([customLabel.value]);
    customLabel.value = null;
    
    populateLabelsSection();
  };
</script>
```

## Atributos
<a name="instance-segmentation-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="instance-segmentation-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### etiquetas
<a name="instance-segmentation-attributes-labels"></a>

Matriz de cadenas con formato JSON, cada una de las cuales es una etiqueta que un trabajador puede asignar a una instancia de un objeto de la imagen. Los trabajadores pueden generar distintos colores para las superposiciones para cada instancia pertinente seleccionando "add instance" (agregar instancia) debajo de la etiqueta en la herramienta.

### name
<a name="instance-segmentation-attributes-name"></a>

El nombre del widget. Se utiliza como clave para los datos de etiquetado en la salida del formulario.

### src
<a name="instance-segmentation-attributes-src"></a>

La dirección URL de la imagen que se va a etiquetar.

## initial-value
<a name="instance-segmentation-attributes-initial-value"></a>

Un objeto JSON que contiene las asignaciones de color de un trabajo anterior de segmentación de instancia y un vínculo a la salida de imagen superpuesta por el trabajo anterior. Incluya esto cuando desee que un trabajador humano verifique los resultados de un trabajo de etiquetado anterior y, si es necesario, lo ajuste.

El atributo aparecerá como sigue:

```
  initial-value="{
    "instances": [
      {
        "color": "#2ca02c",
        "label": "Cat"
      },
      {
        "color": "#1f77b4",
        "label": "Cat"
      },
      {
        "color": "#d62728",
        "label": "Dog"
      }
    ],
    "src": {{ "S3 file URL for image" | grant_read_access }}
  }"
```

## Jerarquía de elementos
<a name="instance-segmentation-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [full-instructions](#instance-segmentation-regions-full-instructions), [short-instructions](#instance-segmentation-regions-short-instructions)

## Regions
<a name="instance-segmentation-regions"></a>

Las regiones siguientes son compatibles con este elemento.

### full-instructions
<a name="instance-segmentation-regions-full-instructions"></a>

Instrucciones generales sobre cómo segmentar imágenes.

### short-instructions
<a name="instance-segmentation-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Salida
<a name="instance-segmentation-output"></a>

La siguiente salida es compatible con este elemento.

### labeledImage
<a name="instance-segmentation-output-labeledImage"></a>

Objeto JSON que contiene un PNG con codificación Base64 de las etiquetas.

### instances
<a name="instance-segmentation-output-labelMappings"></a>

Una matriz JSON que contiene objetos con las etiquetas y los colores de las instancias.
+ **color**: el valor hexadecimal del color RGB de la etiqueta en el PNG `labeledImage`.
+ **etiqueta**: la etiqueta que se asigna a las superposiciones que utilizan ese color. Este valor se puede repetir, ya que las distintas instancias de la etiqueta se identifican mediante su color exclusivo.

### inputImageProperties
<a name="instance-segmentation-output-inputImageProperties"></a>

Objeto JSON que especifica las dimensiones de la imagen que el trabajador está comentando. Este objeto contiene las siguientes propiedades.
+ **altura**: la altura de la imagen en píxeles.
+ **ancho**: el ancho de la imagen en píxeles.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado de este elemento.  

```
[
  {
    "annotatedResult": {
      "inputImageProperties": {
        "height": 533,
        "width": 800
      },
      "instances": [
        {
          "color": "#1f77b4",
          "label": "<Label 1>": 
        },
        {
          "color": "#2ca02c",
          "label": "<Label 1>": 
        },
        {
          "color": "#ff7f0e",
          "label": "<Label 3>": 
        },
      ],
      "labeledImage": {
        "pngImageData": "<Base-64 Encoded Data>"
      }
    }
  }
]
```

## Véase también
<a name="instance-segmentation-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-instructions
<a name="sms-ui-template-crowd-instructions"></a>

Elemento que muestra instrucciones en tres páginas de pestañas, **Summary (Resumen)**, **Detailed Instructions (Instrucciones detalladas)** y **Examples (Ejemplos)**, cuando el trabajador hace clic en un enlace o botón.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/XWpJwbx).

A continuación se muestra un ejemplo de una plantilla Liquid que utilizó el elemento `<crowd-instructions>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  	<crowd-instructions link-text="View instructions" link-type="button">
		  <short-summary>
		    <p>Given an image, write three words or short phrases that summarize its contents.</p>
		  </short-summary>
		  <detailed-instructions>
		    <p>Imagine that you are describing an image to a friend or tagging it for a news website. Provide three specific words or short phrases that describe it.</p>
		  </detailed-instructions>
		  <positive-example>
		    <p><img src="https://s3.amazonaws.com/cv-demo-images/highway.jpg"/></p>
		    <p>
		    	<ul>
		    		<li>Highway</li>
		    		<li>Cars</li>
		    		<li>Gas station</li>
		    	</ul>
		    </p>
		  </positive-example>
		  <negative-example>
		    <p><img src="https://s3.amazonaws.com/cv-demo-images/highway.jpg"/></p>
		    <p>
		    	These are not specific enough:
		    	<ol>
		    		<li>Trees</li>
		    		<li>Outside</li>
		    		<li>Daytime</li>
		    	</ol>
		    </p>
		  </negative-example>
	</crowd-instructions>
    <p><strong>Instructions: </strong>Given an image, write three words or short phrases that summarize its contents.</p>
    <p>If someone were to see these three words or phrases, they should understand the subject and context of the image, as well as any important actions.</p>
	<p>View the instructions for detailed instructions and examples.</p>
	<p><img style="max-width: 100%; max-height: 100%" src="{{ task.input.taskObject | grant_read_access }}"></p>
  <crowd-input name="tag1" label="Word/phrase 1" required></crowd-input>
  <crowd-input name="tag2" label="Word/phrase 2" required></crowd-input>
  <crowd-input name="tag3" label="Word/phrase 3" required></crowd-input>
</crowd-form>
```

## Atributos
<a name="instructions-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### link-text
<a name="instructions-attributes-link-text"></a>

Texto que se mostrará para abrir las instrucciones. El valor predeterminado es **Click for instructions (Haga clic para obtener instrucciones)**.

### link-type
<a name="instructions-attributes-link-type"></a>

Cadena que especifica el tipo de desencadenador para las instrucciones. Los valores posibles son "link" (valor predeterminado) y "button".

## Jerarquía de elementos
<a name="instructions-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Regions
<a name="instructions-regions"></a>

Las regiones siguientes son compatibles con este elemento.

### detailed-instructions
<a name="instructions-regions-detailed-instructions"></a>

Contenido que proporciona instrucciones específicas para una tarea. Aparece en la página de la pestaña "Detailed Instructions (Instrucciones detalladas)".

### negative-example
<a name="instructions-regions-negative-examples"></a>

Contenido que proporciona ejemplos de tareas finalizadas inadecuadamente. Aparece en la página de la pestaña "Examples (Ejemplos)". Se puede proporcionar más de un ejemplo para este elemento.

### positive-example
<a name="instructions-regions-positive-examples"></a>

Contenido que proporciona ejemplos de tareas finalizadas correctamente. Aparece en la página de la pestaña "Examples (Ejemplos)".

### short-summary
<a name="instructions-regions-short-summary"></a>

Breve instrucción que resume la tarea que se va a llevar a cabo. Aparece en la página de la pestaña "Summary (Resumen)". Se puede proporcionar más de un ejemplo para este elemento.

## Véase también
<a name="instructions-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-keypoint
<a name="sms-ui-template-crowd-keypoint"></a>

Genera una herramienta para seleccionar y anotar puntos clave en una imagen.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/GRrgaWN).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-keypoint>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <div id="errorBox"></div>
   
  <crowd-keypoint
    src="{{ task.input.taskObject | grant_read_access }}"
    labels="['Item A', 'Item B', 'Item C']"        
    header="Please locate the centers of each item."
    name="annotatedResult">
    <short-instructions>
      Describe your task briefly here and give examples
    </short-instructions>
    <full-instructions>
      Give additional instructions and good/bad examples here
    </full-instructions>   
  </crowd-keypoint>
</crowd-form>

<script>
  var num_obj = 1;

  document.querySelector('crowd-form').onsubmit = function(e) {
    const keypoints = document.querySelector('crowd-keypoint').value.keypoints || document.querySelector('crowd-keypoint')._submittableValue.keypoints;
    const labels = keypoints.map(function(p) {
      return p.label;
    });

    // 1. Make sure total number of keypoints is correct.
    var original_num_labels = document.getElementsByTagName("crowd-keypoint")[0].getAttribute("labels");

    original_num_labels = original_num_labels.substring(2, original_num_labels.length - 2).split("\",\"");
    var goalNumKeypoints = num_obj*original_num_labels.length;
    if (keypoints.length != goalNumKeypoints) {
      e.preventDefault();
      errorBox.innerHTML = '<crowd-alert type="error" dismissible>You must add all keypoint annotations and use each label only once.</crowd-alert>';
      errorBox.scrollIntoView();
      return;
    }

    // 2. Make sure all labels are unique.
    labelCounts = {};
    for (var i = 0; i < labels.length; i++) {
      if (!labelCounts[labels[i]]) {
        labelCounts[labels[i]] = 0;
      }
      labelCounts[labels[i]]++;
    }
    const goalNumSingleLabel = num_obj;

    const numLabels = Object.keys(labelCounts).length;

    Object.entries(labelCounts).forEach(entry => {
      if (entry[1] != goalNumSingleLabel) {
        e.preventDefault();
        errorBox.innerHTML = '<crowd-alert type="error" dismissible>You must use each label only once.</crowd-alert>';
        errorBox.scrollIntoView();
      }
    })
  };
</script>
```

## Atributos
<a name="keypoint-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="keypoint-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### initial-value
<a name="keypoint-attributes-initial"></a>

Una matriz, en formato JSON, de puntos clave que deben aplicarse a la imagen en el inicio. Por ejemplo:

```
initial-value="[
  {
    'label': 'Left Eye',
    'x': 1022,
    'y': 429
  },
  {
    'label': 'Beak',
    'x': 941,
    'y': 403
  }
]
```

**nota**  
Tenga en cuenta que los valores de etiqueta que se utilizan en este atributo debe tener un valor coincidente en el atributo `labels` o el punto no se representará.

### etiquetas
<a name="keypoint-attributes-labels"></a>

Matriz, en formato JSON, de cadenas que se van a utilizar como etiquetas de anotación de puntos clave.

### name
<a name="keypoint-attributes-name"></a>

Cadena que se utiliza para identificar la respuesta enviada por el trabajador. Este valor coincidirá con una clave del objeto JSON que especifica la respuesta.

### src
<a name="keypoint-attributes-src"></a>

El URI de origen de la imagen que se va a anotar.

## Jerarquía de elementos
<a name="keypoint-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [full-instructions](#keypoint-regions-full-instructions), [short-instructions](#keypoint-regions-short-instructions)

## Regions
<a name="keypoint-regions"></a>

Este elemento necesita las regiones siguientes.

### full-instructions
<a name="keypoint-regions-full-instructions"></a>

Instrucciones generales sobre cómo anotar la imagen.

### short-instructions
<a name="keypoint-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Salida
<a name="keypoint-output"></a>

La siguiente salida es compatible con este elemento.

### inputImageProperties
<a name="keypoint-output-inputImageProperties"></a>

Objeto JSON que especifica las dimensiones de la imagen que el trabajador está comentando. Este objeto contiene las siguientes propiedades.
+ **altura**: la altura de la imagen en píxeles.
+ **ancho**: el ancho de la imagen en píxeles.

### keypoints
<a name="keypoint-output-keypoints"></a>

Matriz de objetos JSON que contienen las coordenadas y la etiqueta de un punto clave. Cada objeto contiene las siguientes propiedades.
+ **etiqueta**: la etiqueta asignada al punto clave.
+ **x**: la coordenada X del punto clave de la imagen en píxeles.
+ **y**: la coordenada y del punto clave de la imagen en píxeles.

**nota**  
Las coordenadas X e Y consideran el punto 0,0 como la parte superior izquierda de la imagen.

**Example : salidas de ejemplo de los elementos**  
A continuación, se muestra un ejemplo de salida del uso de este elemento.  

```
[
  {
    "crowdKeypoint": {
      "inputImageProperties": {
        "height": 1314,
        "width": 962
      },
      "keypoints": [
        {
          "label": "dog",
          "x": 155,
          "y": 275
        },
        {
          "label": "cat",
          "x": 341,
          "y": 447
        },
        {
          "label": "cat",
          "x": 491,
          "y": 513
        },
        {
          "label": "dog",
          "x": 714,
          "y": 578
        },
        {
          "label": "cat",
          "x": 712,
          "y": 763
        },
        {
          "label": "cat",
          "x": 397,
          "y": 814
        }
      ]
    }
  }
]
```
Puede tener disponibles numerosas etiquetas, pero solo se muestran en la salida las que se utilizan.

## Véase también
<a name="keypoint-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-line
<a name="sms-ui-template-crowd-line"></a>

Un widget para dibujar líneas en una imagen. Cada línea está asociada a una etiqueta y los datos de salida indicarán los puntos inicial y final de cada línea. 

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/NWdPVgw).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-line>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. Para ver más ejemplos, consulta este [GitHub repositorio](https://github.com/aws-samples/amazon-sagemaker-ground-truth-task-uis/tree/master/images). 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-line
    name="crowdLine"
    src="{{ task.input.taskObject | grant_read_access }}"
    header="Add header here to describe the task"
    labels="['car','pedestrian','street car']"
  >
    <short-instructions>
        <p>Read the task carefully and inspect the image.</p>
        <p>Choose the appropriate label that best suits the image.</p>
        <p>Draw a line on each objects that the label applies to.</p>
    </short-instructions>

    <full-instructions>
        <p>Read the task carefully and inspect the image.</p>
        <p>Choose the appropriate label that best suits the image. 
        <p>Draw a line along each object that the image applies to.
            Make sure that the line does not extend beyond the boundaries
            of the object.
        </p>
        <p>Each line is defined by a starting and ending point. Carefully
        place the starting and ending points on the boundaries of the object.</p>
    </full-instructions>
    
  </crowd-line>
</crowd-form>
```

## Atributos
<a name="line-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="line-attributes-header"></a>

Opcional. El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### initial-value
<a name="line-attributes-initialValue"></a>

Opcional. Matriz de objetos JSON, cada uno de los cuales establece una línea cuando se carga el componente. Cada objeto JSON de la matriz contiene las propiedades siguientes:
+ **etiqueta**: el texto asignado a la línea como parte de la tarea de etiquetado. Este texto debe coincidir con una de las etiquetas definidas en el atributo *labels* del elemento `<crowd-line>`.
+ **vértices**: las coordenadas `x` e `y` de los píxeles del punto inicial y final de la línea, en relación con la esquina superior izquierda de la imagen.

```
initial-value="{
    lines: [
    {
        label: 'sideline', // label of this line annotation
        vertices:[         // an array of vertices which decide the position of the line
        {
            x: 84,
            y: 110
        },
        {
            x: 60,
            y: 100
        }
        ]
    },
    {
        label: 'yardline',
        vertices:[       
        {
            x: 651,
            y: 498
        },
        {
            x: 862,
            y: 869
        }
        ]
    }
   ]
}"
```

Las líneas definidas mediante la propiedad `initial-value` se pueden ajustar. Se registra si la respuesta de un trabajador se ajustó o no mediante un booleano `initialValueModified` en el resultado de la respuesta del trabajador.

### etiquetas
<a name="line-attributes-labels"></a>

Obligatorio. Matriz de cadenas con formato JSON, cada una de las cuales es una etiqueta que un trabajador puede asignar a la línea. 

**Límite:** 10 etiquetas.

### label-colors
<a name="line-attributes-label-colors"></a>

Opcional. Una matriz de cadenas. Cada cadena es un código hexadecimal (hex) de una etiqueta.

### name
<a name="line-attributes-name"></a>

Obligatorio. El nombre del widget. Se usa como clave para la entrada del widget en la salida del formulario.

### src
<a name="line-attributes-src"></a>

Obligatorio. La dirección URL de la imagen en la que se dibujan las líneas. 

## Regions
<a name="line-regions"></a>

Este elemento necesita las regiones siguientes.

### full-instructions
<a name="line-regions-full-instructions"></a>

Instrucciones generales sobre cómo dibujar líneas. 

### short-instructions
<a name="line-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Jerarquía de elementos
<a name="line-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [short-instructions](#line-regions-short-instructions), [full-instructions](#line-regions-full-instructions)

## Output
<a name="line-output"></a>

### inputImageProperties
<a name="line-output-inputImageProperties"></a>

Objeto JSON que especifica las dimensiones de la imagen que el trabajador está comentando. Este objeto contiene las siguientes propiedades.
+ **altura**: la altura de la imagen en píxeles.
+ **ancho**: el ancho de la imagen en píxeles.

### lines
<a name="line-output-labelMappings"></a>

Una matriz JSON que contiene objetos con las etiquetas y los vértices de las líneas.
+ **etiqueta**: la etiqueta que se asigna a una línea.
+ vértices: las coordenadas `x` e `y` de los píxeles del punto inicial y final de la línea, en relación con la esquina superior izquierda de la imagen.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado de este elemento.

```
{
    "crowdLine": { //This is the name you set for the crowd-line
      "inputImageProperties": {
        "height": 1254,
        "width": 2048
      },
      "lines": [
        {
          "label": "yardline",
          "vertices": [ 
            {
              "x": 58,
              "y": 295
            },
            {
              "x": 1342,
              "y": 398
            }
          ]
        },
        {
          "label": "sideline",
          "vertices": [
            {
              "x": 472,
              "y": 910
            },
            {
              "x": 1480,
              "y": 600
            }
          ]
        }
      ]
    }
  }
```

## Véase también
<a name="line-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-modal
<a name="sms-ui-template-crowd-modal"></a>

Pequeña ventana que emerge en la pantalla cuando esta se abre. 

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/RwKNmyK).

A continuación se muestra un ejemplo de la sintaxis que puede utilizar con el elemento `<crowd-modal>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-modal
link-text = "See Examples"
link-type = "button">
Example Modal Text</crowd-modal>
```

## Atributos
<a name="modal-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### link-text
<a name="modal-attributes-link-text"></a>

Texto que se mostrará para abrir el modal. El valor predeterminado es "Click to open modal (Haga clic para abrir modal)".

### link-type
<a name="modal-attributes-link-type"></a>

Cadena que especifica el tipo de desencadenador para el modal. Los valores posibles son "link" (valor predeterminado) y "button".

## Jerarquía de elementos
<a name="modal-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="modal-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-polygon
<a name="sms-ui-template-crowd-polygon"></a>

Un widget utilizado para dibujar polígonos en una imagen y asignar una etiqueta a la parte de la imagen que está en cada polígono.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/eYgmajo).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-polygon>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-polygon
    name="annotatedResult"
    src="{{ task.input.taskObject | grant_read_access }}"
    header="Draw a polygon around each of the requested target(s) of interest"
    labels="['Cat', 'Dog', 'Bird']"
  >
    <full-instructions header="Polygon instructions">
      <ul>
        <li>Make the polygon tight around the object</li>
        <li>You need to select a label before starting a polygon</li>
        <li>You will need to select a label again after completing a polygon</li>
        <li>To select a polygon, you can click on its borders</li>
        <li>You can start drawing a polygon from inside another polygon</li>
        <li>You can undo and redo while you're drawing a polygon to go back and forth between points you've placed</li>
        <li>You are prevented from drawing lines that overlap other lines from the same polygon</li>
      </ul>
    </full-instructions>

    <short-instructions>
      <p>Draw a polygon around each of the requested target(s) of interest</p>
      <p>Make the polygon tight around the object</p>
    </short-instructions>
  </crowd-polygon>
</crowd-form>
```

## Atributos
<a name="polygon-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="polygon-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### etiquetas
<a name="polygon-attributes-labels"></a>

Una matriz de cadenas con formato JSON, cada una de las cuales es una etiqueta que un trabajador puede asignar a la parte de la imagen delimitada por un polígono.

### name
<a name="polygon-attributes-name"></a>

El nombre del widget. Se usa como clave para la entrada del widget en la salida del formulario.

### src
<a name="polygon-attributes-src"></a>

La dirección URL de la imagen en la que se dibujan los polígonos. 

### initial-value
<a name="polygon-attributes-initialValue"></a>

Matriz de objetos JSON, cada uno de los cuales define un polígono que se va dibujar al cargar el componente. Cada objeto JSON de la matriz contiene las propiedades siguientes.
+ **etiqueta**: el texto asignado al polígono como parte de la tarea de etiquetado. Este texto debe coincidir con una de las etiquetas definidas en el atributo *labels* del elemento <crowd-polygon>.
+ **vértices**: una matriz de objetos JSON. Cada objeto contiene un valor de coordenada x e y para un punto en el polígono.

**Example**  
Un atributo `initial-value` podría tener este aspecto.  

```
initial-value = 
  '[
     {
     "label": "dog",
     "vertices": 
       [
         {
            "x": 570,
            "y": 239
         },
        ... 
         {
            "x": 759,
            "y": 281
         }
       ]
     }
  ]'
```
Dado que estará dentro de un elemento HTML, la matriz JSON se debe escribir entre comillas simples o dobles. El ejemplo anterior utiliza comillas simples para encapsular la matriz JSON y comillas dobles dentro de la propia matriz. Si tiene que combinar comillas simples y dobles dentro de la matriz JSON, reemplácelas por sus códigos de entidad HTML (`&quot;` para comilla doble, `&#39;` para comilla simple) para aplicarlas correctamente.

## Jerarquía de elementos
<a name="polygon-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [full-instructions](#polygon-regions-full-instructions), [short-instructions](#polygon-regions-short-instructions)

## Regions
<a name="polygon-regions"></a>

Se requieren las siguientes regiones.

### full-instructions
<a name="polygon-regions-full-instructions"></a>

Instrucciones generales sobre cómo dibujar polígonos.

### short-instructions
<a name="polygon-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Salida
<a name="polygon-output"></a>

La siguiente salida es compatible con este elemento.

### polygons
<a name="polygon-output-boundingBoxes"></a>

Matriz de objetos JSON, cada uno de los cuales describe un polígono que ha creado el trabajador. Cada objeto JSON de la matriz contiene las propiedades siguientes.
+ **etiqueta**: el texto asignado al polígono como parte de la tarea de etiquetado.
+ **vértices**: una matriz de objetos JSON. Cada objeto contiene un valor de coordenada x e y para un punto en el polígono. La esquina superior izquierda de la imagen es 0,0.

### inputImageProperties
<a name="polygon-output-inputImageProperties"></a>

Objeto JSON que especifica las dimensiones de la imagen que el trabajador está comentando. Este objeto contiene las siguientes propiedades.
+ **altura**: la altura de la imagen en píxeles.
+ **ancho**: el ancho de la imagen en píxeles.

**Example : salidas de ejemplo de los elementos**  
A continuación, se muestran ejemplos de salidas de escenarios de uso habituales para este elemento.  
**Una sola etiqueta, un solo polígono**  

```
{
    "annotatedResult": 
    {
      "inputImageProperties": {
        "height": 853,
        "width": 1280
      },
      "polygons": 
      [
        {
          "label": "dog",
          "vertices": 
          [
            {
              "x": 570,
              "y": 239
            },
            {
              "x": 603,
              "y": 513
            },
            {
              "x": 823,
              "y": 645
            },
            {
              "x": 901,
              "y": 417
            },
            {
              "x": 759,
              "y": 281
            }
          ]
        }
      ]
    }
  }
]
```
**Una sola etiqueta, varios polígonos**  

```
[
  {
    "annotatedResult": {
      "inputImageProperties": {
        "height": 853,
        "width": 1280
      },
      "polygons": [
        {
          "label": "dog",
          "vertices": [
            {
              "x": 570,
              "y": 239
            },
            {
              "x": 603,
              "y": 513
            },
            {
              "x": 823,
              "y": 645
            },
            {
              "x": 901,
              "y": 417
            },
            {
              "x": 759,
              "y": 281
            }
          ]
        },
        {
          "label": "dog",
          "vertices": [
            {
              "x": 870,
              "y": 278
            },
            {
              "x": 908,
              "y": 446
            },
            {
              "x": 1009,
              "y": 602
            },
            {
              "x": 1116,
              "y": 519
            },
            {
              "x": 1174,
              "y": 498
            },
            {
              "x": 1227,
              "y": 479
            },
            {
              "x": 1179,
              "y": 405
            },
            {
              "x": 1179,
              "y": 337
            }
          ]
        }
      ]
    }
  }
]
```
**Varias etiquetas, varios polígonos**  

```
[
  {
    "annotatedResult": {
      "inputImageProperties": {
        "height": 853,
        "width": 1280
      },
      "polygons": [
        {
          "label": "dog",
          "vertices": [
            {
              "x": 570,
              "y": 239
            },
            {
              "x": 603,
              "y": 513
            },
            {
              "x": 823,
              "y": 645
            },
            {
              "x": 901,
              "y": 417
            },
            {
              "x": 759,
              "y": 281
            }
          ]
        },
        {
          "label": "cat",
          "vertices": [
            {
              "x": 870,
              "y": 278
            },
            {
              "x": 908,
              "y": 446
            },
            {
              "x": 1009,
              "y": 602
            },
            {
              "x": 1116,
              "y": 519
            },
            {
              "x": 1174,
              "y": 498
            },
            {
              "x": 1227,
              "y": 479
            },
            {
              "x": 1179,
              "y": 405
            },
            {
              "x": 1179,
              "y": 337
            }
          ]
        }
      ]
    }
  }
]
```
Puede tener disponibles numerosas etiquetas, pero solo se muestran en la salida las que se usan.

## Véase también
<a name="polygon-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# '\$1"datos":\$1"características":[1,2,3,4]\$1\$1'
<a name="sms-ui-template-crowd-polyline"></a>

Un widget para dibujar polilínea en una imagen. Cada polilínea está asociada a una etiqueta y puede incluir dos o más vértices. Una polilínea puede intersecarse a sí misma y sus puntos inicial y final pueden situarse en cualquier parte de la imagen.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/PoWwvyJ).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-polyline>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. Para ver más ejemplos, consulta este [GitHub repositorio](https://github.com/aws-samples/amazon-sagemaker-ground-truth-task-uis/tree/master/images). 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-polyline
    name="crowdPolyline"
    src="{{ task.input.taskObject | grant_read_access }}"
    header="Add header here to describe the task"
    labels="['car','pedestrian','street car']"
  >
    <full-instructions>
        <p>Read the task carefully and inspect the image.</p>
        <p>Choose the appropriate label that best suits the image.</p>
        <p>Draw a polyline around the boundaries of all objects
        that the label applies to.</p>
        <p>Use the <b>Enter</b> key to complete a polyline.</p>
        <p>Make sure that the polyline fits tightly around the boundary
        of the object.</p>
    </full-instructions>

    <short-instructions>
        <p>Read the task carefully and inspect the image.</p>
        <p>Review the tool guide to learn how to use the polyline tool.</p>
        <p>Choose the appropriate label that best suits the image.</p>
        <p>To draw a polyline, select a label that applies to an object of interest 
            and add a single point to the photo by clicking on that point. Continue to 
            draw the polyline around the object by adding additional points
            around the object boundary.</p>
        <p>After you place the final point on the polyline, press <b>Enter</b> on your
        keyboard to complete the polyline.</p>

    </short-instructions>
  </crowd-polyline>
</crowd-form>
```

## Atributos
<a name="polyline-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="polyline-attributes-header"></a>

Opcional. El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### initial-value
<a name="polyline-attributes-initialValue"></a>

Opcional. Matriz de objetos JSON, cada uno de los cuales establece una polilínea cuando se carga el componente. Cada objeto JSON de la matriz contiene las propiedades siguientes:
+ **etiqueta**: el texto asignado a la polilínea como parte de la tarea de etiquetado. Este texto debe coincidir con una de las etiquetas definidas en el atributo *labels* del elemento `<crowd-polyline>`.
+ **vértices**: las coordenadas `x` e `y` de los píxeles de los vértices de una polilínea, en relación con la esquina superior izquierda de la imagen.

```
 initial-value= "{
    polylines: [
    {
        label: 'sideline', // label of this line annotation
        vertices:[         // an array of vertices which decide the position of the line
        {
            x: 84,
            y: 110
        },
        {
            x: 60,
            y: 100
        }
        ]
    },
    {
        label: 'yardline',
        vertices:[       
        {
            x: 651,
            y: 498
        },
        {
            x: 862,
            y: 869
        },
        {
            x: 1000,
            y: 869
        }
        ]
    }
   ]
}"
```

Las polilíneas definidas mediante la propiedad `initial-value` se pueden ajustar. Se registra si la respuesta de un trabajador se ajustó o no mediante un booleano `initialValueModified` en el resultado de la respuesta del trabajador.

### etiquetas
<a name="polyline-attributes-labels"></a>

Obligatorio. Matriz de cadenas con formato JSON, cada una de las cuales es una etiqueta que un trabajador puede asignar a la línea. 

**Límite:** 10 etiquetas.

### label-colors
<a name="polyline-attributes-label-colors"></a>

Opcional. Una matriz de cadenas. Cada cadena es un código hexadecimal (hex) de una etiqueta.

### name
<a name="polyline-attributes-name"></a>

Obligatorio. El nombre del widget. Se usa como clave para la entrada del widget en la salida del formulario.

### src
<a name="polyline-attributes-src"></a>

Obligatorio. La dirección URL de la imagen en la que se dibujan las polilíneas.

## Regions
<a name="polyline-regions"></a>

Este elemento necesita las regiones siguientes.

### full-instructions
<a name="polyline-regions-full-instructions"></a>

Instrucciones generales sobre cómo dibujar polilíneas. 

### short-instructions
<a name="polyline-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Jerarquía de elementos
<a name="polyline-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [short-instructions](#polyline-regions-short-instructions), [full-instructions](#polyline-regions-full-instructions)

## Output
<a name="polyline-output"></a>

### inputImageProperties
<a name="polyline-output-inputImageProperties"></a>

Objeto JSON que especifica las dimensiones de la imagen que el trabajador está comentando. Este objeto contiene las siguientes propiedades.
+ **altura**: la altura de la imagen en píxeles.
+ **ancho**: el ancho de la imagen en píxeles.

### polylines
<a name="polyline-output-labelMappings"></a>

Una matriz JSON que contiene objetos con las etiquetas y los vértices de las polilíneas.
+ **etiqueta**: la etiqueta que se asigna a una línea.
+ vértices: las coordenadas `x` e `y` de los píxeles de los vértices de una polilínea, en relación con la esquina superior izquierda de la imagen.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado de este elemento.

```
 {
    "crowdPolyline": { //This is the name you set for the crowd-polyline
      "inputImageProperties": {
        "height": 1254,
        "width": 2048
      },
      "polylines": [
        {
          "label": "sideline",
          "vertices": [
            {
              "x": 651,
              "y": 498
            },
            {
              "x": 862,
              "y": 869
            },
            {
              "x": 1449,
              "y": 611
            }
          ]
        },
        {
          "label": "yardline",
          "vertices": [
            {
              "x": 1148,
              "y": 322
            },
            {
              "x": 1705,
              "y": 474
            },
            ,
            {
              "x": 1755,
              "y": 474
            }
          ]
        }
      ]
    }
  }
```

## Véase también
<a name="polyline-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-radio-button
<a name="sms-ui-template-crowd-radio-button"></a>

Botón que puede estar activado o desactivado. Cuando hay botones de opción dentro de un grupo de botones de opción, puede haber exactamente un botón de opción activado en el grupo, en cualquier momento. El siguiente es un ejemplo de cómo configurar un elemento `crowd-radio-button` dentro de un elemento `crowd-radio-group`.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/yLgyWGZ).

A continuación se muestra un ejemplo de la sintaxis que puede utilizar con el elemento `<crowd-radio-button>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
<crowd-form>
<crowd-radio-group>
    <crowd-radio-button name="tech" value="tech">Technology</crowd-radio-button>
    <crowd-radio-button name="politics" value="politics">Politics</crowd-radio-button>
</crowd-radio-group>
</crowd-form>
```

El ejemplo anterior se puede ver en una plantilla de tareas de trabajo personalizada en este GitHub ejemplo: [plantilla personalizada de trabajo de etiquetado de reconocimiento de entidades](https://github.com/aws-samples/amazon-sagemaker-ground-truth-task-uis/blob/master/text/named-entity-recognition-with-additional-classification.liquid.html).

Los botones de opción de Crowd HTML Element no admiten la etiqueta HTML, `required`. Para que sea obligatorio seleccionar un botón de opción, utilice elementos `<input type="radio">` para crear botones de radio y añada la etiqueta `required`. El atributo `name` de todos los elementos `<input>` que pertenecen al mismo grupo de botones de opción debe ser el mismo. Por ejemplo, la siguiente plantilla requiere que el usuario seleccione un botón de opción del grupo `animal-type` antes de enviarla.

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
<crowd-form>
  <p>Select an animal type:</p>
<img src="https://images.unsplash.com/photo-1537151608828-ea2b11777ee8?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1539&q=80" style="height: 500; width: 400;"/>
<br><br>
<div>
  <input type="radio" id="cat" name="animal-type" value="cat" required>
  <label for="cat">Cat</label>
</div>
<div>
  <input type="radio" id="dog" name="animal-type" value="dog">
  <label for="dog">Dog</label>
</div>
<div>
  <input type="radio" id="unknown" name="animal-type" value="unknown">
  <label for="unknown">Unknown</label>
</div>
    <full-instructions header="Classification Instructions">
      <p>Read the task carefully and inspect the image.</p>
      <p>Choose the appropriate label that best suits the image.</p>
    </full-instructions>
    <short-instructions>
      <p>Read the task carefully and inspect the image.</p>
      <p>Choose the appropriate label that best suits the image.</p>
    </short-instructions>
</crowd-form>
```

## Atributos
<a name="radio-button-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### checked
<a name="radio-button-attributes-checked"></a>

Conmutador booleano que, si está presente, muestra activado el botón de opción.

### disabled
<a name="radio-button-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra deshabilitado el botón e impide que se active.

### name
<a name="radio-button-attributes-name"></a>

Cadena que se utiliza para identificar la respuesta enviada por el trabajador. Este valor coincidirá con una clave del objeto JSON que especifica la respuesta.

**nota**  
Si utiliza los botones fuera de un elemento [crowd-radio-group](sms-ui-template-crowd-radio-group.md) pero con la misma cadena `name` y diferentes cadenas `value`, el objeto `name` de la salida contendrá un valor booleano para cada cadena `value`. Para asegurarse de que solo se selecciona un botón en un grupo, conviértalos en elementos secundarios de un elemento [crowd-radio-group](sms-ui-template-crowd-radio-group.md) y utilice diferentes valores de nombre.

### valor
<a name="radio-button-attributes-value"></a>

Nombre de propiedad para el valor booleano del elemento. Si no se especifica, usa "on" como valor predeterminado; por ejemplo, `{ "<name>": { "<value>": <true or false> } }`.

## Jerarquía de elementos
<a name="radio-button-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-radio-group](sms-ui-template-crowd-radio-group.md)
+ **Elementos secundarios**: ninguno

## Output
<a name="radio-button-output"></a>

Genera un objeto con el siguiente patrón: `{ "<name>": { "<value>": <true or false> } }`. Si utiliza los botones fuera de un elemento [crowd-radio-group](sms-ui-template-crowd-radio-group.md) pero con la misma cadena `name` y diferentes cadenas `value`, el objeto de nombre contendrá un valor booleano para cada cadena `value`. Para asegurarse de que solo se selecciona uno de un grupo de botones, conviértalos en elementos secundarios de un elemento [crowd-radio-group](sms-ui-template-crowd-radio-group.md) y use diferentes valores de nombre.

**Example Resultado de ejemplo de este elemento**  

```
[
  {
    "btn1": {
      "yes": true
    },
    "btn2": {
      "no": false
    }
  }
]
```

## Véase también
<a name="radio-button-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-radio-group
<a name="sms-ui-template-crowd-radio-group"></a>

Grupo de botones de opción. Solo se puede seleccionar un botón de opción en el grupo. Si se selecciona un botón de opción, se desactivará cualquier botón de opción que se haya elegido previamente en el mismo grupo. Para obtener un ejemplo de una plantilla de interfaz de usuario personalizada que utiliza el elemento `crowd-radio-group`, consulte esta [plantilla personalizada de trabajo de etiquetado de reconocimiento de entidades](https://github.com/aws-samples/amazon-sagemaker-ground-truth-task-uis/blob/master/text/named-entity-recognition-with-additional-classification.liquid.html).

Vea un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML de Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/KKawjPJ).

A continuación se muestra un ejemplo de la sintaxis que puede utilizar con el elemento `<crowd-radio-group>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
  
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<style>
	body {
		padding-left: 20px;
		margin-bottom: 20px;
	}
	#outer-container {
	    display: flex;
	    justify-content: space-around;
	    max-width: 900px;
	    margin-left: 100px;
	}
	.left-container {
    	margin-right: auto;
    	padding-right: 50px;
	}
	.right-container {
    	margin-left: auto;
    	padding-left: 50px;
	}
	#vertical-separator {
	    border: solid 1px #d5dbdb;
	}
</style>

<crowd-form>
    <div>
        <h1>Instructions</h1>
	Lorem ipsum...
    </div>
    <div>
        <h2>Background</h2>
    	<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</p>
    </div>
    <div id="outer-container">
	<span class="left-container">
	    <h2>Option 1</h2>
	    <p>Nulla facilisi morbi tempus iaculis urna. Orci dapibus ultrices in iaculis nunc sed augue lacus.</p>
	</span>
	<span id="vertical-separator"></span>
	<span class="right-container">
	    <h2>Option 2</h2>
	    <p>Ultrices vitae auctor eu augue ut. Pellentesque massa placerat duis ultricies lacus sed turpis tincidunt id.</p>
	</span>
    </div>
    <div>
        <h2>Question</h2>
    	<p>Which do you agree with?</p>
	<crowd-radio-group>
	    <crowd-radio-button name="option1" value="Option 1">Option 1</crowd-radio-button>
	    <crowd-radio-button name="option2" value="Option 2">Option 2</crowd-radio-button>
	</crowd-radio-group>

    	<p>Why did you choose this answer?</p>
	<crowd-text-area name="explanation" placeholder="Explain how you reached your conclusion..."></crowd-text-area>
    </div>
</crowd-form>
```

## Atributos
<a name="radio-group-attributes"></a>

Este elemento no admite atributos especiales.

## Jerarquía de elementos
<a name="radio-group-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [crowd-radio-button](sms-ui-template-crowd-radio-button.md)

## Output
<a name="radio-group-output"></a>

Genera una matriz de objetos que representa los elementos [crowd-radio-button](sms-ui-template-crowd-radio-button.md) que contiene.

**Example Ejemplo de salida de elementos**  

```
[
  {
    "btn1": {
      "yes": true
    },
    "btn2": {
      "no": false
    }
  }
]
```

## Véase también
<a name="radio-group-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-semantic-segmentation
<a name="sms-ui-template-crowd-semantic-segmentation"></a>

Widget para segmentar una imagen y asignar una etiqueta a cada segmento de imagen.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/LYxEKEb).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-semantic-segmentation>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-semantic-segmentation
    name="annotatedResult"
    src="{{ task.input.taskObject | grant_read_access }}"
    header="Please label each of the requested objects in this image"
    labels="['Cat', 'Dog', 'Bird']"
  >
    <full-instructions header="Segmentation Instructions">
      <ol>
          <li><strong>Read</strong> the task carefully and inspect the image.</li>
          <li><strong>Read</strong> the options and review the examples provided to understand more about the labels.</li>
          <li><strong>Choose</strong> the appropriate label that best suits the image.</li>
      </ol>
    </full-instructions>

    <short-instructions>
      <p>Use the tools to label the requested items in the image</p>
    </short-instructions>
  </crowd-semantic-segmentation>
</crowd-form>
```

## Atributos
<a name="semantic-segmentation-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="semantic-segmentation-attributes-header"></a>

El texto que se muestra por encima de la imagen. Por lo general, es una pregunta o instrucciones sencillas para el trabajador.

### initial-value
<a name="semantic-segmentation-attributes-initial-value"></a>

Objeto JSON que contiene las asignaciones de color de un trabajo anterior de segmentación semántica y un vínculo a la salida de imagen superpuesta por el trabajo anterior. Incluya esto cuando desee que un trabajador humano verifique los resultados de un trabajo de etiquetado anterior y, si es necesario, lo ajuste.

El atributo se parecería al código siguiente:

```
  initial-value='{
    "labelMappings": {
        "Bird": {
          "color": "#ff7f0e"
        },
        "Cat": {
          "color": "#2ca02c"
        },
        "Cow": {
          "color": "#d62728"
        },
        "Dog": {
          "color": "#1f77b4"
        }
      },
    "src": {{ "S3 file URL for image" | grant_read_access }}
  }'
```

Cuando se utilizan los [tipos de tareas integrados](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-task-types.html) de Ground Truth con [consolidación de anotaciones](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-annotation-consolidation.html) (en los que más de un trabajador etiqueta una sola imagen), las asignaciones de etiquetas se incluyen en los registros de salida de cada trabajador; sin embargo, el resultado general se representa como `internal-color-map` en los resultados consolidados.

Puede convertir `internal-color-map` en `label-mappings` en una plantilla personalizada utilizando el lenguaje de plantillas Liquid:

```
initial-value="{
  'src' : '{{ task.input.manifestLine.label-attribute-name-from-prior-job| grant_read_access }}',
  'labelMappings': {
     {% for box in task.input.manifestLine.label-attribute-name-from-prior-job-metadata.internal-color-map %}
       {% if box[1]['class-name'] != 'BACKGROUND' %}
         {{ box[1]['class-name'] | to_json }}: {
           'color': {{ box[1]['hex-color'] | to_json }}
         },
       {% endif %} 
     {% endfor %}
   } 
}"
```

### etiquetas
<a name="semantic-segmentation-attributes-labels"></a>

Matriz de cadenas con formato JSON, cada una de las cuales es una etiqueta que un trabajador puede asignar a un segmento de la imagen.

### name
<a name="semantic-segmentation-attributes-name"></a>

El nombre del widget. Se usa como clave para la entrada del widget en la salida del formulario.

### src
<a name="semantic-segmentation-attributes-src"></a>

La dirección URL de la imagen que se va a segmentar.

## Jerarquía de elementos
<a name="semantic-segmentation-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: [full-instructions](#semantic-segmentation-regions-full-instructions), [short-instructions](#semantic-segmentation-regions-short-instructions)

## Regions
<a name="semantic-segmentation-regions"></a>

Las regiones siguientes son compatibles con este elemento.

### full-instructions
<a name="semantic-segmentation-regions-full-instructions"></a>

Instrucciones generales sobre cómo segmentar imágenes.

### short-instructions
<a name="semantic-segmentation-regions-short-instructions"></a>

Instrucciones importantes específicas de la tarea que se muestran en un lugar destacado.

## Salida
<a name="semantic-segmentation-output"></a>

La siguiente salida es compatible con este elemento.

### labeledImage
<a name="semantic-segmentation-output-labeledImage"></a>

Objeto JSON que contiene un PNG con codificación Base64 de las etiquetas.

### labelMappings
<a name="semantic-segmentation-output-labelMappings"></a>

Objeto JSON que contiene objetos denominados con etiquetas de segmentación.
+ **color**: el valor hexadecimal del color RGB de la etiqueta en el PNG `labeledImage`.

### initialValueModified
<a name="semantic-segmentation-output-initialValueModified"></a>

Valor booleano que indica si se han modificado los valores iniciales. Solo se incluye cuando la salida proviene de una tarea de ajuste.

### inputImageProperties
<a name="semantic-segmentation-output-inputImageProperties"></a>

Objeto JSON que especifica las dimensiones de la imagen que el trabajador está comentando. Este objeto contiene las siguientes propiedades.
+ **altura**: la altura de la imagen en píxeles.
+ **ancho**: el ancho de la imagen en píxeles.

**Example : salidas de ejemplo de los elementos**  
A continuación se muestra un ejemplo de resultado para este elemento.  

```
[
  {
    "annotatedResult": {
      "inputImageProperties": {
        "height": 533,
        "width": 800
      },
      "labelMappings": {
        "<Label 2>": {
          "color": "#ff7f0e"
        },
        "<label 3>": {
          "color": "#2ca02c"
        },
        "<label 1>": {
          "color": "#1f77b4"
        }
      },
      "labeledImage": {
        "pngImageData": "<Base-64 Encoded Data>"
      }
    }
  }
]
```

## Véase también
<a name="semantic-segmentation-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-slider
<a name="sms-ui-template-crowd-slider"></a>

Barra con un botón deslizante que permite a un trabajador seleccionar un valor de un intervalo de valores moviendo el botón. El control deslizante es excelente para configuraciones que reflejen niveles de intensidad, como, por ejemplo, volumen, brillo o saturación de color.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/RwKNzWL).

A continuación se muestra un ejemplo de una plantilla de topografía que utiliza el elemento `<crowd-slider>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
<crowd-instructions link-text="View instructions" link-type="button">
  <short-summary>
    <p>Provide a brief instruction here</p>
  </short-summary>

  <detailed-instructions>
    <h3>Provide more detailed instructions here</h3>
    <p>Include additional information</p>
  </detailed-instructions>

  <positive-example>
    <p>Provide an example of a good answer here</p>
    <p>Explain why it's a good answer</p>
  </positive-example>

  <negative-example>
    <p>Provide an example of a bad answer here</p>
    <p>Explain why it's a bad answer</p>
  </negative-example>
</crowd-instructions>

<div>
  <p>What is your favorite color for a bird?</p>
  <crowd-input name="favoriteColor" placeholder="example: pink" required></crowd-input>
</div>

<div>
  <p>Check this box if you like birds</p>
  <crowd-checkbox name="likeBirds" checked="true" required></crowd-checkbox>
</div>

<div>
  <p>On a scale of 1-10, how much do you like birds?</p>
  <crowd-slider name="howMuch" min="1" max="10" step="1" pin="true" required></crowd-slider>
</div>

<div>
  <p>Write a short essay describing your favorite bird</p>
  <crowd-text-area name="essay" rows="4" placeholder="Lorem ipsum..." required></crowd-text-area>
</div>
</crowd-form>
```

## Atributos
<a name="slider-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### disabled
<a name="slider-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra deshabilitado el control deslizante.

### editable
<a name="slider-attributes-editable"></a>

Un modificador booleano que, si está presente, muestra un up/down botón que se puede elegir para seleccionar el valor.

Seleccionar el valor mediante el up/down botón es una alternativa a seleccionar el valor moviendo la perilla del control deslizante. El botón del control deslizante se moverá en sincronización con las opciones de botón hacia arriba o hacia abajo.

### max
<a name="slider-attributes-max"></a>

Número que especifica el valor máximo del control deslizante.

### min
<a name="slider-attributes-min"></a>

Número que especifica el valor mínimo del control deslizante.

### name
<a name="slider-attributes-name"></a>

Cadena que se utiliza para identificar la respuesta enviada por el trabajador. Este valor coincidirá con una clave del objeto JSON que especifica la respuesta.

### pin
<a name="slider-attributes-pin"></a>

Conmutador booleano que, si está presente, muestra el valor actual por encima del botón cuando este se mueve.

### obligatorio
<a name="slider-attributes-required"></a>

Conmutador booleano que, si está presente, requiere que el trabajador proporcione información.

### secondary-progress
<a name="slider-attributes-secondary-progress"></a>

Cuando se utiliza con un atributo CSS `crowd-slider-secondary-color`, la barra de progresión estará coloreada hasta el punto representado por el `secondary-progress`. Por ejemplo, si este representara la progresión en un vídeo en streaming, `value` representaría en qué punto de la escala de tiempo del vídeo se encuentra el espectador. El valor `secondary-progress` representaría el punto de la escala de tiempo en el que el vídeo se había almacenado en búfer.

### paso
<a name="slider-attributes-step"></a>

Número que especifica la diferencia entre los valores seleccionables del control deslizante.

### valor
<a name="slider-attributes-value"></a>

Un elemento preestablecido que se convierte en valor predeterminado si el trabajador no proporciona entrada.

## Jerarquía de elementos
<a name="slider-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="slider-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-tab
<a name="sms-ui-template-crowd-tab"></a>

Componente diseñado para verse como una pestaña con información debajo.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML de Crowd en. [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/dyNPBGW)

A continuación se muestra un ejemplo de una plantilla que utiliza el elemento `<crowd-tab>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-tabs>
    <crowd-tab header="Tab 1">
      <h2>Image</h2>

      <img
        src="https://images.unsplash.com/photo-1478382188900-5bb598fe27d3?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1351&q=80"
        style="max-width: 40%"
      >

      <h2>Text</h2>
      <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
      </p>
      <p>
      Sed risus ultricies tristique nulla aliquet enim tortor at auctor. Tempus egestas sed sed risus.
      </p>
    </crowd-tab>

    <crowd-tab header="Tab 2">
      <h2>Description</h2>
      <p>
      Sed risus ultricies tristique nulla aliquet enim tortor at auctor. Tempus egestas sed sed risus.
      </p>
    </crowd-tab>

    <crowd-tab header="Tab 3">
      <div style="width: 40%; display: inline-block">
        <img
          src="https://images.unsplash.com/photo-1472747459646-91fd6f13995f?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1350&q=80"
          style="max-width: 80%"
        >
        <crowd-input label="Input inside tab" name="inputInsideTab"></crowd-input>
        <input type="checkbox" name="checkbox" value="foo">Foo
        <input type="checkbox" name="checkbox" value="bar">Bar
        <crowd-button>Some button</crowd-button>
      </div>

      <div style="width: 40%; display: inline-block; vertical-align: top">
        Lorem ipsum dolor sit amet, lorem a wisi nibh, in pulvinar, consequat praesent vestibulum tellus ante felis auctor, vitae lobortis dictumst mauris. 
        Pellentesque nulla ipsum ante quisque quam augue. 
        Class lacus id euismod, blandit tempor mauris quisque tortor mauris, urna gravida nullam pede libero, ut suscipit orci faucibus lacus varius ornare, pellentesque ipsum. 
        At etiam suspendisse est elementum luctus netus, vel sem nulla sodales, potenti magna enim ipsum diam tortor rutrum, 
        quam donec massa elit ac, nam adipiscing sed at leo ipsum consectetuer. Ac turpis amet wisi, porttitor sint lacus ante, turpis accusantium, ac maecenas deleniti, 
        nisl leo sem integer ac dignissim. Lobortis etiam luctus lectus odio auctor. Justo vitae, felis integer id, bibendum accumsan turpis eu est mus eros, ante id eros. 
      </div>
    </crowd-tab>

  </crowd-tabs>

  <crowd-input label="Input outside tabs" name="inputOutsideTab"></crowd-input>

  <short-instructions>
    <p>Sed risus ultricies tristique nulla aliquet enim tortor at auctor. Tempus egestas sed sed risus.</p>
</short-instructions>

<full-instructions header="Classification Instructions">
    <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
    <p> Tempus egestas sed sed risus.</p>
</full-instructions>

</crowd-form>
```

## Atributos
<a name="tab-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### header
<a name="tab-attributes-header"></a>

Texto que aparece en la pestaña. Normalmente se trata de algún tipo de nombre descriptivo breve indicativo de la información contenida debajo de la pestaña.

## Jerarquía de elementos
<a name="tab-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-tabs](sms-ui-template-crowd-tabs.md)
+ **Elementos secundarios**: ninguno 

## Véase también
<a name="tab-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-tabs
<a name="sms-ui-template-crowd-tabs"></a>

Contenedor para información en pestañas.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/ZELYdWz).

A continuación se muestra un ejemplo de una plantilla que utiliza el elemento `<crowd-tabs>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <crowd-tabs>
    <crowd-tab header="Tab 1">
      <h2>Image</h2>

      <img
        src="https://images.unsplash.com/photo-1478382188900-5bb598fe27d3?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1351&q=80"
        style="max-width: 40%"
      >

      <h2>Text</h2>
      <p>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
      </p>
      <p>
      Sed risus ultricies tristique nulla aliquet enim tortor at auctor. Tempus egestas sed sed risus.
      </p>
    </crowd-tab>

    <crowd-tab header="Tab 2">
      <h2>Description</h2>
      <p>
      Sed risus ultricies tristique nulla aliquet enim tortor at auctor. Tempus egestas sed sed risus.
      </p>
    </crowd-tab>

    <crowd-tab header="Tab 3">
      <div style="width: 40%; display: inline-block">
        <img
          src="https://images.unsplash.com/photo-1472747459646-91fd6f13995f?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1350&q=80"
          style="max-width: 80%"
        >
        <crowd-input label="Input inside tab" name="inputInsideTab"></crowd-input>
        <input type="checkbox" name="checkbox" value="foo">Foo
        <input type="checkbox" name="checkbox" value="bar">Bar
        <crowd-button>Some button</crowd-button>
      </div>

      <div style="width: 40%; display: inline-block; vertical-align: top">
        Lorem ipsum dolor sit amet, lorem a wisi nibh, in pulvinar, consequat praesent vestibulum tellus ante felis auctor, vitae lobortis dictumst mauris. 
        Pellentesque nulla ipsum ante quisque quam augue. 
        Class lacus id euismod, blandit tempor mauris quisque tortor mauris, urna gravida nullam pede libero, ut suscipit orci faucibus lacus varius ornare, pellentesque ipsum. 
        At etiam suspendisse est elementum luctus netus, vel sem nulla sodales, potenti magna enim ipsum diam tortor rutrum, 
        quam donec massa elit ac, nam adipiscing sed at leo ipsum consectetuer. Ac turpis amet wisi, porttitor sint lacus ante, turpis accusantium, ac maecenas deleniti, 
        nisl leo sem integer ac dignissim. Lobortis etiam luctus lectus odio auctor. Justo vitae, felis integer id, bibendum accumsan turpis eu est mus eros, ante id eros. 
      </div>
    </crowd-tab>

  </crowd-tabs>

  <crowd-input label="Input outside tabs" name="inputOutsideTab"></crowd-input>

  <short-instructions>
    <p>Sed risus ultricies tristique nulla aliquet enim tortor at auctor. Tempus egestas sed sed risus.</p>
</short-instructions>

<full-instructions header="Classification Instructions">
    <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
    <p> Tempus egestas sed sed risus.</p>
</full-instructions>

</crowd-form>
```

## Atributos
<a name="tabs-attributes"></a>

Este elemento no tiene atributos.

## Jerarquía de elementos
<a name="tabs-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md) 
+ **Elementos secundarios**: [crowd-tab](sms-ui-template-crowd-tab.md)

## Véase también
<a name="tabs-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-text-area
<a name="sms-ui-template-crowd-text-area"></a>

Campo para entrada de texto.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/ZELYdOz).

A continuación se muestra un ejemplo de una plantilla Liquid diseñada para transcribir clips de audio que utiliza el elemento `<crowd-text-area>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <audio controls>
      <source src="{{ task.input.taskObject | grant_read_access }}" type="audio/mpeg">
      Your browser does not support the audio element.
  </audio>
  <h3>Instructions</h3>
  <p>Transcribe the audio</p>
  <p>Ignore "umms", "hmms", "uhs" and other non-textual phrases</p>
  <crowd-text-area name="transcription" rows="4"></crowd-text-area>
</crowd-form>
```

## Atributos
<a name="text-area-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### allowed-pattern
<a name="text-area-attributes-allowed-pattern"></a>

Expresión regular que se utiliza con el atributo *auto-validate* para pasar por alto los tipos de caracteres no coincidentes como tipos de trabajadores.

### auto-focus
<a name="text-area-attributes-auto-focus"></a>

Conmutador booleano que, si está presente, pone el cursor en este elemento en carga para que los usuarios puedan comenzar a escribir inmediatamente sin tener que hacer clic en el elemento.

### auto-validate
<a name="text-area-attributes-auto-validate"></a>

Conmutador booleano que, si está presente, activa la validación de entrada. El comportamiento del validador se puede modificar mediante los atributos *error-message* y *allowed-pattern*.

### char-counter
<a name="text-area-attributes-char-counter"></a>

Conmutador booleano que, si está presente, pone un pequeño campo de texto bajo la esquina inferior derecha del elemento, en la que se muestra la cantidad de caracteres que hay dentro del elemento.

### disabled
<a name="text-area-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra deshabilitada el área de entrada.

### error-message
<a name="text-area-attributes-error-message"></a>

Texto que se va a mostrar debajo del campo de entrada, en el lado izquierdo, si se produce un error de validación.

### etiqueta
<a name="text-area-attributes-label"></a>

Cadena que se muestra dentro de un campo de texto.

Este texto se reduce y se eleva por encima de un campo de texto cuando el trabajador comienza a escribir en el campo o cuando el atributo *value* está establecido.

### max-length
<a name="text-area-attributes-max-length"></a>

Número entero que especifica el número máximo de caracteres permitido por el elemento. No se tendrán en cuenta los caracteres escritos o pegados que superen dicho número máximo.

### max-rows
<a name="text-area-attributes-max-rows"></a>

Un entero que especifica el número máximo de filas de texto que se permiten dentro de a crowd-text-area. Normalmente el elemento se expande para abarcar nuevas filas. Si max-rows se establece y el número de filas lo supera, el contenido se desplaza hacia arriba, fuera de la vista, y aparece un control de la barra de desplazamiento.

### name
<a name="text-area-attributes-name"></a>

Cadena que se utiliza para representar los datos del elemento en la salida.

### marcador de posición
<a name="text-area-attributes-placeholder"></a>

Cadena que se presenta al usuario como marcador de posición. Desaparece después de que el usuario pone algo en el área de entrada.

### rows
<a name="text-area-attributes-rows"></a>

Número entero que especifica la altura del elemento en filas de texto.

### valor
<a name="text-area-attributes-value"></a>

Un elemento preestablecido que se convierte en valor predeterminado si el trabajador no proporciona entrada. El elemento preestablecido aparece en un cuadro de texto.

## Jerarquía de elementos
<a name="text-area-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Output
<a name="text-area-output"></a>

Este elemento devuelve el `name` como un nombre de propiedad y el contenido de texto del elemento como el valor. Los retornos de carro del texto se representan como `\n`.

**Example Resultado de ejemplo de este elemento**  

```
[
  {
    "textInput1": "This is the text; the text that\nmakes the crowd go wild."
  }
]
```

## Véase también
<a name="text-area-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-toast
<a name="sms-ui-template-crowd-toast"></a>

Notificación sutil que aparece temporalmente en la pantalla. Solo se ve un crowd-toast.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/ExZaBgK).

A continuación se muestra un ejemplo de una plantilla Liquid que utiliza el elemento `<crowd-toast>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <p>Find the official website for: <strong>{{ task.input.company }}</strong></p>
  <p>Do not give Yelp pages, LinkedIn pages, etc.</p>
  <p>Include the http:// prefix from the website</p>
  <crowd-input name="website" placeholder="http://example.com"></crowd-input>

  <crowd-toast duration="10000" opened>
    This is a message that you want users to see when opening the template. This message will disappear in 10 seconds. 
   </crowd-toast>

</crowd-form>
```

## Atributos
<a name="toast-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### duración
<a name="toast-attributes-duration"></a>

Número que especifica el tiempo, en milisegundos, que la notificación se ve en la pantalla.

### text
<a name="toast-attributes-text"></a>

El texto que se muestra en la notificación.

## Jerarquía de elementos
<a name="toast-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Véase también
<a name="toast-see-also"></a>

Para obtener más información, consulte lo siguiente.
+  [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md) 
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

# crowd-toggle-button
<a name="sms-ui-template-crowd-toggle-button"></a>

Un botón que actúa como un ON/OFF conmutador y cambia de estado. 

Vea un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML de Crowd. [CodePen](https://codepen.io/sagemaker_crowd_html_elements/pen/XWpJLNm)

En el ejemplo siguiente se muestran diferentes formas de utilizar para utilizar el elemento HTML `<crowd-toggle-button>`. Copie el siguiente código y guárdelo en un archivo con la extensión `.html`. Abra el archivo en cualquier navegador para obtener una vista previa e interactuar con esta plantilla. 

```
<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>

<crowd-form>
  <!--Toggle button without value-->
  <crowd-toggle-button name="toggleButtonWithoutValue"></crowd-toggle-button>

  <!--Toggle button with value-->
  <crowd-toggle-button name="toggleButtonWithValue" value="someValue"></crowd-toggle-button>

  <!--Toggle button disabled-->
  <crowd-toggle-button name="toggleButtonDisabled" disabled></crowd-toggle-button>

  <!--Toggle button marked invalid-->
  <crowd-toggle-button name="toggleButtonInvalid" invalid></crowd-toggle-button>

  <!--Toggle button marked required-->
  <crowd-toggle-button name="toggleButtonRequired" required></crowd-toggle-button>
</crowd-form>
```

## Atributos
<a name="toggle-button-attributes"></a>

Los siguientes atributos son compatibles con este elemento.

### checked
<a name="toggle-button-attributes-checked"></a>

Conmutador booleano que, si está presente, muestra el botón en la posición de encendido.

### disabled
<a name="toggle-button-attributes-disabled"></a>

Conmutador booleano que, si está presente, muestra el botón como deshabilitado y evita que se hagan conmutaciones.

### invalid
<a name="toggle-button-attributes-invalid"></a>

Cuando está en la posición de desactivado, un botón que use este atributo se visualizará con un color de alerta. El estándar es rojo, pero se puede cambiar en CSS. Cuando esté en la posición de activado, el botón se mostrará en el mismo color que otros botones que estén en la posición de activado.

### name
<a name="toggle-button-attributes-name"></a>

Cadena que se utiliza para identificar la respuesta enviada por el trabajador. Este valor coincide con una clave del objeto JSON que especifica la respuesta.

### obligatorio
<a name="toggle-button-attributes-required"></a>

Conmutador booleano que, si está presente, requiere que el trabajador proporcione información.

### valor
<a name="toggle-button-attributes-value"></a>

Valor que se utiliza en la salida como nombre de propiedad para el estado booleano del elemento. Toma "on" como valor predeterminado si no se proporciona.

## Jerarquía de elementos
<a name="toggle-button-element-hierarchy"></a>

Este elemento tiene los siguientes elementos principales y secundarios.
+ **Elementos principales**: [crowd-form](sms-ui-template-crowd-form.md)
+ **Elementos secundarios**: ninguno

## Output
<a name="toggle-button-output"></a>

Este elemento devuelve `name` como nombre de un objeto, que contiene el elemento `value` como nombre de propiedad y el estado del elemento como valor booleano para la propiedad. Si no se especifica ningún valor para el elemento, el nombre de la propiedad toma de forma predeterminada el valor "on".

**Example Resultado de ejemplo de este elemento**  

```
[
  {
    "theToggler": {
      "on": true
    }
  }
]
```

## Véase también
<a name="toggle-button-see-also"></a>

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

## Crowd HTML Elements V2
<a name="elements-v2"></a>

Crowd HTML V2 Elements presenta capacidades de etiquetado mejoradas diseñadas para apoyar a los trabajadores, con nuevas características adaptadas a los casos de uso de entrenamiento de modelos de GenAI. Estos elementos V2 son compatibles con los Crowd HTML Elements crowd-form, short-instructions, crowd-button, crowd-tabs y crowd-tab. Si utiliza otros elementos con elementos V2, la aplicación de anotaciones no funcionará correctamente.

### crowd-text-ranking
<a name="sms-ui-template-crowd-text-ranking"></a>

Widget para que los trabajadores deslicen y clasifiquen diversas entradas de texto en función de las dimensiones que especifique.

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements_2/pen/ZYGqBPQ).

```
<script src="https://assets.crowd.aws/crowd-html-elements-v2.js"></script>

<crowd-form>
  <crowd-text-ranking
    name="textRanking"
    ordinal-ranking-dimensions='[{"name":"Clarity","allowTie":true},{"name":"Inclusivity","allowTie":false}]'
    text="Explain why you can see yourself in a mirror at a level that a 16 year old can understand."
    responses='["When light is emitted from light source like a light bulb, some of it travels toward your body, where it may be reflected toward the mirror with some probability or it may be absorbed. If it were reflected off your body, then some of it could travel toward the mirror, where it could be reflected again. If it is the case where light strikes the mirror, the light is then again redirected as a reflection. If that light is pointed in the direction of your eyes, then the light will enter your eyes. Then, your brain processes the electrical signal made by your eyes and sees it as an image.","You can see yourself because of a series of light reflections. Light travels from the light source, hits and reflects off of your body and travels toward the mirror. Then, it reflects off of the mirror and travels to your eyes, where your brain registers it as a picture of yourself.","Light travels in various directions from a light source like a light bulb. Some of the light reflects off of your body with some probability, after which some of it travels to the mirror. Upon striking the mirror, the some of the light again reflects off the mirror and travels toward your eyes, wherein your eyes detect the light after absorbing it. After this process, your brain processes the signal as an image of yourself.","The phenomenon of self-visual perception via a mirror at an ontological plane derives from the intricate interplay of photons within the electromagnetic spectrum, quantum mechanical principles, and the neurocognitive processes underpinning self-recognition. In essence, the mirror serves as an interface wherein incident photons, emitted from an external object, interact with the reflective surface at a specific angle of incidence governed by the laws of geometric optics. This interaction culminates in the process of specular reflection, leading to the formation of a virtual image."]'
  >
    <short-instructions>
      <h1>Hello these are my instructions 1</h1>
      <p>Hello these are my instructions 2</p>
      <p>Hello these are my instructions 3</p>
    </short-instructions>
  </crowd-text-ranking>
</crowd-form>
```

#### Atributos
<a name="crowd-text-ranking-attributes"></a>

Este elemento admite los siguientes atributos.

##### text
<a name="crowd-text-ranking-attributes-text"></a>

El texto o la referencia de S3 al texto al que se hace referencia al clasificar las respuestas.

##### ordinal-ranking-dimensions
<a name="crowd-text-ranking-attributes-ordinal-ranking"></a>

Matriz obligatoria del objeto `ordinal-ranking-dimensions`, que especifica la dimensión en la que se van a clasificar las respuestas. Esta dimensión contiene un **nombre** y una propiedad denominada **allowTie**, que determina si un trabajador puede dar a las respuestas la misma clasificación.

##### responses
<a name="crowd-text-ranking-attributes-responses"></a>

Matriz obligatoria del objeto `ordinal-ranking-dimensions`, que especifica la dimensión en la que se van a clasificar las respuestas. Esta dimensión contiene un **nombre** y una propiedad denominada **allowTie**, que determina si un trabajador puede dar a las respuestas la misma clasificación.

##### name
<a name="crowd-text-ranking-attributes-name"></a>

Campo de cadena obligatorio que identifica la respuesta que el trabajador envía. Coincide con una clave del contrato de datos de salida del envío del trabajador.

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)

### crowd-question-answer-generation
<a name="sms-ui-template-crowd-question-answer-generation"></a>

Widget para que los trabajadores resalten secciones de texto y asignen pares de pregunta y respuesta según sus instrucciones

Consulte un ejemplo interactivo de una plantilla HTML que utiliza este elemento HTML Crowd en [CodePen](https://codepen.io/sagemaker_crowd_html_elements_2/pen/zxGmobo).

```
<script src="https://assets.crowd.aws/crowd-html-elements-v2.js"></script>

<crowd-form>
  <crowd-question-answer-generation
    name="questionAnswerGeneration"
    text='The Amazon rainforest (Portuguese: Floresta Amazônica or Amazônia; Spanish: Selva Amazónica, Amazonía or usually Amazonia; French: Forêt amazonienne; Dutch: Amazoneregenwoud), also known in English as Amazonia or the Amazon Jungle, is a moist broadleaf forest that covers most of the Amazon basin of South America. This basin encompasses 7,000,000 square kilometres (2,700,000 sq mi), of which 5,500,000 square kilometres (2,100,000 sq mi) are covered by the rainforest. This region includes territory belonging to nine nations. The majority of the forest is contained within Brazil, with 60% of the rainforest, followed by Peru with 13%, Colombia with 10%, and with minor amounts in Venezuela, Ecuador, Bolivia, Guyana, Suriname and French Guiana. States or departments in four nations contain "Amazonas" in their names. The Amazon represents over half of the planet's remaining rainforests, and comprises the largest and most biodiverse tract of tropical rainforest 
    in the world, with an estimated 390 billion individual trees divided into 16,000 species. For a long time, it was thought that the 
    Amazon rainforest was only ever sparsely populated, as it was impossible to sustain a large population through agriculture given the poor soil. 
    Archeologist Betty Meggers was a prominent proponent of this idea, as described in her book Amazonia: Man and Culture in a Counterfeit Paradise. 
    She claimed that a population density of 0.2 inhabitants per square kilometre (0.52/sq mi) is the maximum that can be sustained in the rainforest 
    through hunting, with agriculture needed to host a larger population. However, recent anthropological findings have suggested that the region was 
    actually densely populated. Some 5 million people may have lived in the Amazon region in AD 1500, divided between dense coastal settlements, such as that at
    Marajó, and inland dwellers. By 1900 the population had fallen to 1 million and by the early 1980s it was less than 200,000.'
    min-questions="1"
    max-questions="10"
    question-min-words="1"
    question-max-words="100"
    answer-min-words="1"
    answer-max-words="100"
    question-tags='[
      "tag1",
      "tag2",
      "tag3"
    ]'
    allow-custom-question-tags="true"
  >
    <short-instructions>
      <p>User instructions will be displayed here.</p>
    </short-instructions>
  </crowd-question-answer-generation>
</crowd-form>
```

#### Atributos
<a name="crowd-question-answer-generation-attributes"></a>

Este elemento admite los siguientes atributos.

##### text
<a name="crowd-question-answer-generation-attributes-text"></a>

El texto o la referencia de S3 al texto al que se hace referencia al clasificar las respuestas.

##### min-questions
<a name="crowd-question-answer-generation-attributes-min-questions"></a>

Entero opcional que especifica la cantidad mínima de preguntas que un trabajador tendría que crear durante la tarea. Si no se proporciona, se le pedirá que escriba al menos un par de pregunta y respuesta.

##### max-questions
<a name="crowd-question-answer-generation-attributes-max-questions"></a>

Entero opcional que especifica la cantidad máxima de preguntas que un trabajador puede crear durante la tarea.

##### question-min-words
<a name="crowd-question-answer-generation-attributes-question-min-words"></a>

Entero opcional que especifica la cantidad mínima de palabras permitidas en una pregunta. Si no se proporciona, se le pedirá que introduzca al menos una palabra en la pregunta.

##### question-max-words
<a name="crowd-question-answer-generation-attributes-question-max-words"></a>

Entero opcional que especifica la cantidad máxima de palabras permitidas en una pregunta.

##### answer-min-words
<a name="crowd-question-answer-generation-attributes-answer-min-words"></a>

Entero opcional que especifica la cantidad mínima de palabras permitidas en una respuesta. Si no se proporciona, se le pedirá que introduzca al menos una palabra en la respuesta.

##### answer-max-words
<a name="crowd-question-answer-generation-attributes-answer-max-words"></a>

Entero opcional que especifica la cantidad máxima de palabras permitidas en una respuesta.

##### question-tags
<a name="crowd-question-answer-generation-attributes-question-tags"></a>

Matriz obligatoria de cadenas que especifica las posibles etiquetas que un trabajador puede asignar a un par de pregunta y respuesta. Si esta matriz está vacía, no se muestra el campo de etiquetas de preguntas.

##### allow-custom-question-tags
<a name="crowd-question-answer-generation-attributes-allow-custom-question-tags"></a>

Campo booleano obligatorio que indica si un trabajador puede especificar una etiqueta de pregunta personalizada.

##### name
<a name="crowd-question-answer-generation-attributes-name"></a>

Campo de cadena obligatorio que identifica la respuesta que el trabajador envía. Coincide con una clave del contrato de datos de salida del envío del trabajador.

Para obtener más información, consulte lo siguiente.
+ [Entrena el etiquetado de datos con humanos con Amazon SageMaker Ground Truth](sms.md)
+ [Referencia de Crowd HTML Elements](sms-ui-template-reference.md)