Kolumna selektora kolorów pozwala zespołom projektowym przypisywać elementom konkretne kolory. Po wybraniu koloru w kolumnie wyświetla się odpowiedni kod w wybranym formacie (HEX lub RGB).

Za pomocą API kolumna selektora kolorów obsługuje odczyt, filtrowanie, aktualizowanie i czyszczenie wartości.

Typ kolumny	Typ implementacji	Obsługiwane operacje
color_picker	ColorPickerValue	Odczyt: Tak Filtrowanie: Tak Tworzenie: Tak Aktualizowanie: Tak Czyszczenie: Tak

---

Zapytania

Kolumny selektora kolorów można odpytywać za pomocą pola column_values w zapytaniach items, używając wbudowanego fragmentu dla ColorPickerValue.

query {
  items(ids: [1234567890, 9876543210]) {
    name
    column_values {
      ... on ColorPickerValue {
        id
        color
        text
        value
        updated_at
      }
    }
  }
}

const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      name
      column_values {
        ... on ColorPickerValue {
          id
          color
          text
          value
          updated_at
        }
      }
    }
  }
`;

const variables = { itemIds: [1234567890, 9876543210] };

const response = await mondayApiClient.request(query, variables);

Pola

Za pomocą poniższych pól możesz określić, jakie informacje zwróci implementacja ColorPickerValue.

Pole	Opis
color String	Wartość koloru kolumny w formacie HEX (np. "#FF5733"). Zwraca null, jeśli wartość została zapisana w formacie RGB lub kolumna jest pusta.
column Column!	Kolumna, do której należy wartość.
id ID!	Unikalny identyfikator kolumny.
text String	Wartość kolumny w postaci tekstu. Zwraca kod koloru HEX albo null, jeśli wartość została zapisana w formacie RGB lub kolumna jest pusta.
type ColumnType!	Typ kolumny.
updated_at Date	Data ostatniej aktualizacji kolumny.
value JSON	Wartość kolumny w formacie JSON. Zawiera obiekt koloru i znacznik czasu changed_at.

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "name": "Design Task",
        "column_values": [
          {
            "id": "color_picker",
            "color": "#FF5733",
            "text": "#FF5733",
            "value": "{\"color\":{\"hex\":\"#FF5733\"},\"changed_at\":\"2026-03-21T12:00:00.000Z\"}",
            "updated_at": "2026-03-21T12:00:00+00:00"
          }
        ]
      }
    ]
  }
}

---

Filtrowanie

Możesz filtrować elementy według wartości w kolumnie selektora kolorów za pomocą obiektu items_page.

Operator	Wartość porównania	Opis
any_of	Tablica ciągów znaków z kolorami HEX (np. ["#FF5733"])	Zwraca elementy, których wartość w kolumnie selektora kolorów pasuje do dowolnego z podanych kodów HEX.
not_any_of	Tablica ciągów znaków z kolorami HEX (np. ["#FF5733"])	Pomija elementy, których wartość w kolumnie selektora kolorów pasuje do któregokolwiek z podanych kodów HEX.
is_empty	[]	Zwraca elementy z pustą (nieustawioną) wartością w kolumnie selektora kolorów.
is_not_empty	[]	Zwraca elementy, dla których ustawiono wartość w kolumnie selektora kolorów.

Przykłady

Filtrowanie według koloru HEX

Ten przykład zwraca wszystkie elementy z określoną wartością koloru.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "color_picker"
            compare_value: ["#FF5733"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Filtrowanie według pustego koloru

Ten przykład zwraca wszystkie elementy z określonej tablicy, których wartość w kolumnie selektora kolorów jest pusta.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "color_picker"
            compare_value: []
            operator: is_empty
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

---

Mutacje

Tworzenie

Wymagany zakres uprawnień: boards:write

Możesz utworzyć kolumnę selektora kolorów za pomocą ogólnej mutacji create_column.

mutation {
  create_column(
    board_id: 1234567890
    column_type: color_picker
    title: "Brand Color"
    description: "The item's assigned brand color."
  ) {
    id
    title
    description
  }
}

Opcjonalnie możesz przekazać ustawienia kolumny jako ciąg JSON w argumencie defaults, aby skonfigurować domyślny kolor i metodę wyświetlania.

mutation {
  create_column(
    board_id: 1234567890
    column_type: color_picker
    title: "Brand Color"
    defaults: "{\"color\":\"#FF0000\",\"colorMethod\":\"hex\"}"
  ) {
    id
    title
    settings
  }
}

Aktualizowanie wartości

Możesz zaktualizować wartość w kolumnie selektora kolorów za pomocą change_multiple_column_values. Wartości w kolumnie selektora kolorów można przesyłać w formacie HEX lub RGB.

Aktualizowanie wartości w formacie HEX

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"color_picker\": {\"color\": {\"hex\": \"#FF5733\"}}}"
  ) {
    id
    name
  }
}

Aktualizowanie wartości w formacie RGB

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"color_picker\": {\"color\": {\"r\": 0, \"g\": 128, \"b\": 255}}}"
  ) {
    id
    name
  }
}

Ustawianie koloru podczas tworzenia elementu

Możesz ustawić wartość w kolumnie selektora kolorów podczas tworzenia elementu, przekazując ją w argumencie column_values.

mutation {
  create_item(
    board_id: 1234567890
    item_name: "New design task"
    column_values: "{\"color_picker\": {\"color\": {\"hex\": \"#9D50DD\"}}}"
  ) {
    id
    name
  }
}

Czyszczenie wartości

Możesz wyczyścić wartość w kolumnie selektora kolorów za pomocą change_multiple_column_values, przekazując null lub pusty obiekt.

Czyszczenie za pomocą null

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"color_picker\": null}"
  ) {
    id
    name
  }
}

Czyszczenie za pomocą pustego obiektu

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"color_picker\": {}}"
  ) {
    id
    name
  }
}

---

Odczytywanie konfiguracji kolumny

Możesz pobrać ustawienia kolumny selektora kolorów za pomocą pola settings kolumny.

query {
  boards(ids: 1234567890) {
    columns(ids: ["color_picker"]) {
      id
      title
      settings
    }
  }
}

Struktura odpowiedzi settings

Pole settings zwraca typowany obiekt JSON z następującymi kluczami:

Klucz	Typ	Opis
color	string	Domyślna wartość koloru (ciąg znaków w formacie HEX lub RGB).
colorMethod	string	Metoda zapisu koloru. Przyjmuje wartość "hex" lub "rgb".

Jeśli kolumna selektora kolorów nie ma własnych ustawień, zwracany jest pusty obiekt {}.

Przykładowa odpowiedź settings

{
  "color": "#FF0000",
  "colorMethod": "hex"
}

---

Pobieranie schematu typu kolumny

Możesz programowo pobrać schemat JSON ustawień kolumny selektora kolorów za pomocą zapytania get_column_type_schema. Zwraca ono strukturę, reguły walidacji i dostępne właściwości konfiguracji kolumny.

query {
  get_column_type_schema(
    type: color_picker
  )
}

{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {
              "color": {
                "type": "string",
                "description": "Color value (hex or rgb string)"
              },
              "colorMethod": {
                "type": "string",
                "description": "Color representation method",
                "enum": [
                  "rgb",
                  "hex"
                ]
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Odpowiedź zawiera nazwy właściwości, ich typy, ograniczenia (takie jak maksymalna długość i dozwolone wartości) oraz opisy poszczególnych ustawień. Możesz użyć tych informacji do walidacji ustawień kolumny, dynamicznego generowania interfejsów użytkownika lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.