What does the POS actually mean in the Trello API

4.9k views Asked by At

I'm using dillenmeisters Trello.Net API Wrapper, and on each Card it has a POS attribute. I thought that was for position in the list that it was in, but the numbers seem arbitrary, ranging from 4 to 5 digit numbers. Is there anyway to make sense of these enough to "place" a new Card between 2 others that already exist in the list?

1

There are 1 answers

13
dillenmeister On BEST ANSWER

Edit:

Available in version 0.5.9-beta1 of Trello.NET (on NuGet):

// Ways to set the position of a card
trello.Cards.ChangePos(card, 1234)
trello.Cards.ChangePos(card, Position.Top)
trello.Cards.ChangePos(card, Position.Bottom)

I haven't dug deeply into how pos works, but I think it's a sort order. If you want to move a card between two other cards, you could get the position of those two cards and add their Pos together and divide by two.

For example, if you want to insert Card C between Card A and Card B:

  1. Card A - Pos 16
  2. Card B - Pos 32
  3. Card C - Pos 64

(16 + 32) / 2 = 24. Set Card C Pos to 24.

  1. Card A - Pos 16
  2. Card C - Pos 24
  3. Card B - Pos 32

I think they do this so that they only have to update ONE Pos when a card is moved (instead of the Pos of all cards after it which would be necessary if they used a sequential Pos with no gaps).